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Chapter 1 


Preface 


1.1 Jy0010: Preface to OOP with Java’ 


1.1.1 Table of Contents 


e Welcome (p. 1) 
e Getting started with Java programming (p. 3) 


The JDK and the JRE (p. 3) 
The Java API documentation (p. 3) 
A suitable text editor (p. 4) 


e Miscellaneous (p. 4) 


1.1.2 Welcome 


Welcome to my collection titled Object-Oriented Programming (OOP) with Java . 

During the past eighteen years, I have published hundreds of Java and OOP programming tutorials on 
a variety of different topics and websites. I have also developed the teaching materials for several different 
college-level programming courses in Java/OOP. 

A work in progress 

This is a work in progress. I am currently combining selected content from those earlier endeavors 
with new material that I am developing to create a freely downloadable E-book that covers Java/OOP 
programming from programming fundamentals to very advanced OOP concepts. 

Among other things, the collection contains the material that I use to teach the following courses at 
Austin Community College in Austin Texas: 


ITSE 2321 - Object-Oriented Programming (Java) ? 

ITSE2317 - Java Programming (Intermediate) 3 

INEW2338 - Advanced Java Programming + 

GAME 2302 Mathematical Applications for Game Development * 


The collection also includes: 


1This content is available online at <http://cnx.org/content /m45136/1.17/>. 
*http://cnx.org/content /m45222 

3http://cnx.org/content /m45258 
“http://cnx.org/contents/6e817713-906c-4bc0-9874-3d189e81362a 
>http://cnx.org/contents/486c946e-2ad 2-4edb-92f7-d21a87063463 
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e An OOP self-assessment test ê 
e Course materials for a complete course in Programming Fundamentals 7 


Because it is a work in progress, the collection is growing on a daily basis. If you don’t find what you need 
today, come back and take another look in a week or two and you may find what you need then. 

Download options 

I encourage you to take advantage of all of the download options (most of which are free) that cnx.org 
8 has to offer. You can also customize this material for use in your organized courses or for personal self 
study. 

Feedback is appreciated 

And if you find the material useful, I would like to hear more about how you are using it. 


Legacy versus openstax presentation format Early in 2014, cnx.org ° began a transition 
from a legacy presentation format !° to a new openstax | presentation format. As of August, 
2015, some of the functionality of the legacy presentation format has not yet been ported to the 
openstax presentation format. 


If you find yourself viewing one of my collections or modules in the openstax !” presentation format 
(the format with no menu on the left side of the page) and some of the links appear to be broken, 
some of the images fail to display properly, etc., you may need to revert to the legacy presentation 
format !° . 


For example, as of August 2015, if you open this collection 4 in the openstax format and attempt 
to view the slides, you may find that they don’t display properly. (You may see a file not found 
error or something similar. I expect this issue to be resolved in the future but I’m not sure when.) 
However, if you open the same collection in the legacy presentation format 15 and attempt to view 
the slides, you should see that the slides display as expected. 


You can switch from openstax format to legacy format by selecting the Legacy Site link 
in the upper-right corner of the page when viewing a collection or module in openstax format. 


When you are viewing a module in the legacy format, you can switch to the openstax format by 
selecting a link that normally appears at the beginning of the page and reads something like the 
following: "Note: You are viewing an old style version of this document. The new style version is 
available here." 


Terminology: The folks at cnx.org ‘® have adopted some new terminology in conjunction with 
this transition. For example, the entity that is referred to asa Collection inthe legacy format 
is referred to as a Book inthe openstax format. The entity that is referred to as a Module 
in the legacy format is referred to asa Page inthe openstax format. You will probably find 
that I use these terms somewhat interchangeably in this material. 


The landing module or page: It is possible to open and view material at the level of a 
Collection in the legacy format as shown here 17 . However, when you open a Book in the 
openstax format, you will actually land on the first page in the book as shown here 18 . In other 
words, a Book is not a "stand alone" entity in the openstax format. 


Shttp://cnx.org/contents/e0e3e693-bf58-4deb-a99 1-bec64b89b355 
“http://cnx.org/contents/a431f34d-e41b-4118-8452-c16b0635cdfd 
Shttp://cnx.org/ 
®http://cnx.org/ 
lhttps:/ /legacy.cnx.org/content /coll11441/latest / 
'lhttp://cnx.org/contents/fb64661c-5b3f-4ea8-97c6-e48df112438a 
'http://cnx.org/contents/fb64661c-5b3f-4ea8-97c6-e48df112438a 
13https://legacy.cnx.org/content /col11441 /latest / 
'4http://cnx.org/contents/fb64661c-5b3f-4ea8-97c6-e48df112438a 
1 https://legacy.cnx.org/content /coll1441 /latest / 
16http://cnx.org/ 
'Thttps://legacy.cnx.org/content /col11441 
18http://cnx.org/contents/fb64661c-5b3f-4ea8-97c6-e48df112438a 
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Although it can be tricky to accomplish, it is possible to view Modules and Pages outside the 
context of the Collection or Book that contains them in both formats as shown here 1° and here ?° 
. This makes it possible to include a module in two or more collections or to include a page in two 
or more Books. (Note that depending on the state of cookies on your browser, it may be necessary 
for you to either clear out some cookies or to view the above links in a Firefox Private Window 
or a Chrome Incognito Window to view them outside the context of the Collection or Book.) 


1.1.3 Getting started with Java programming 


As is the case with many worthwhile endeavors, Java programming requires that you have some tools to 
begin. Fortunately, all of the tools that you need to get started programming in Java are available for free 
downloading. 

In addition to a computer with web access, you will need: 


e The Java Development Kit (JDK) and Java Runtime Engine (JRE) 
e The Java API documentation 
e A suitable text editor 


1.1.3.1 The JDK and the JRE 


The JDK, the JRE, and the API documentation are all freely available from Oracle. As of December 2012, 
you will find links to that material on the web page titled Java Platform Standard Edition 7 Documentation 
at http://docs.oracle.com/javase/7/docs/ 7! (The links given in this module may change as new versions of 
Java are released, but newer versions shouldn’t be too difficult to locate with a web search.) 

Download 

The JDK and the included JRE can be downloaded from http://www.oracle.com/technetwork /java/javase /downloads /ind« 
22 That page provides several download options. Beginners should download the Java Platform (JDK) 
for the latest released version. ((The JRE is included in the JDK package, so you don’t need to download 
both.) 

Install 

You will also probably need to follow the installation instructions for your computer that are 
available at http://docs.oracle.com /javase/7/docs/webnotes/install/index.html 7° Pay particular atten- 
tion to the instructions for setting the path and classpath environment variables. This is 
where many students stumble. Another useful document on the path and classpath is available at 
http:/ /docs.oracle.com /javase /tutorial /essential /environment /paths.html 24 


1.1.3.2 The Java API documentation 


The Java Platform, Standard Edition 7 API Specification is available at 
http://docs.oracle.com/javase/7/docs/api/index.html 7° . You should be able to find the documenta- 
tion for later versions with a web search. 

Also see my Java OOP documentation 7° module for instructions on how to use the documentation. 


'9https://legacy.cnx.org/content /m45222/?legacy=true 
?°http://cnx.org/contents/e86afl09-f5f1-4de8-a8f0-be0ef2d87567 

21 http://docs.oracle.com/javase/7/docs/ 
?2http://www.oracle.com/technetwork/java/javase /downloads/index.html 
3http://docs.oracle.com/javase/7/docs/webnotes/install/index.html 
4http://docs.oracle.com/javase/tutorial/essential /environment/paths.html 
5http://docs.oracle.com/javase/7/docs/api/index.html 
6http://cnx.org/contents/ba4f0233-f146-4057-86ea-3d442d898707 
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1.1.3.3 A suitable text editor 


The module titled Jb0110: Java OOP: Programming Fundamentals, Getting Started ?” explains how to use 
a text editor to create Java program code. Just about any text editor will do as long as you can ensure that 
the file name extension is .java. Something as simple as Windows Notepad or Windows WordPad would 
probably be best for your first few simple programs. 

Soon, however, you will probably want to upgrade to an editor that uses different colors to identify the 
different. parts of your program. My favorite color-coded editor is the free version of JCreator 78. (The 
free version seems to have disappeared from their web page so you may have trouble finding it.) 

Another free editor is DrJava 7° . An advantage of this editor is that it can be run from a USB drive 
with no installation required. Another possibility, although I have never had occasion to use it, is ]GRASP 
30 | Numerous other Java color-coded editors, including BlueJ 3! are available for free downloading on the 
web. 


1.1.4 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jy0010: Preface to Object-Oriented Programming (OOP) with Java 
e File: Jy0010.htm 

e Published: 11/16/12 

e Revised: 08/20/15 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


Į also want you to know that I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2"http://cnx.org/contents/920d09 1d-ea72-478f-986f-eab814c2d 992 
8http://www.jcreator.com/ 

°*http://drjava.sourceforge.net / 

3°http://www.jgrasp.org / 

3Thttp://www.bluej.org/ 
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Chapter 2 


Programming Fundamentals 


2.1 Jb0103 Preface to Programming Fundamentals’ 


2.1.1 Table of Contents 


e Welcome (p. 5) 
e The DrJava IDE and the Java Development Kit (p. 6) 
e Miscellaneous (p. 6) 


2.1.2 Welcome 


Welcome to Programming Fundamentals. 

This group of modules under the heading Programming Fundamentals is not part of a formal course 
of study at Austin Community College ? where I teach. Instead, it is a compilation of material that I have 
published over the years for the benefit of those students who desire to enroll in ITSE 2321 Object Oriented 
Programming * but who don’t have the required prerequisite knowledge for that course. 

If you fall in that category, or if you just want to get a good introduction to computer programming, you 
may find this material useful. 

Even if you have completed a programming fundamentals course in another language, or you have consid- 
erable programming experience in another language, you may still find this material useful as an introduction 
to the Java programming language and its syntax. 

In case you decide that you don’t need to study the material in this group of modules, you may still find 
it useful to take a look at the following three modules. These three modules will show you how to configure 
your computer and get started programming in Java. 


e Jb0110: Java OOP: Programming Fundamentals, Getting Started + 
e Jb0110r Review ° 
e Jb0115: Java OOP: First Program ĉ 


You may also find it useful to search the web for and study a few tutorials on the Windows "command 
prompt" as well as a few tutorials on Windows batch files. Here are a couple of possibilities that I found 
with a rudimentary search: 


1This content is available online at <http://cnx.org/content/m45179/1.10/>. 
*http://www.austincc.edu/ 

3http://cnx.org/content /m45222 
“http://cnx.org/contents/920d091d-ea72-478f-986f-eab814c2d 992 
°http://cnx.org/contents/6d86f0f3-bd le-4a3d-b339-1c98154dfa64 
®http://cnx.org/contents/b2760098-41f2-4b62-bb27-3800588 1c827 
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e Windows Command Prompt in 15 Minutes 7 
e Windows Batch Scripting: Getting Started 8 


If you are using a different operating system, you may need to find similar tutorials that match up with the 
operating system that you are using. 

Most of the topics in this group of modules are divided into two modules — a primary module and a review 
module. The review modules contain review questions and answers keyed to the material in the primary 
modules. 

In addition to the modules contained in this group, you will find several of my other tutorials on program- 
ming fundamentals at Obg0510: Programming Fundamentals ° . Those tutorials are still in their original 
html format and you may need to go to the Legacy Site !° to access them fully. They are awaiting conversion 
to cnxml, which is a requirement for publishing them as modules on cnx.org. 

As you work your way through the modules in this group, you should prepare yourself for the more 
challenging ITSE 2321 OOP tracks identified below: 


e Java 1600: Objects and Encapsulation |! 
e Java 3000: The Guzdial-Ericson Multimedia Class Library 1? 
e Java 4010: Getting Started with Java Collections +3 


2.1.3 The DrJava IDE and the Java Development K it 


In order to work with the material in this group of Programming Fundamentals modules, you will need 
access to Oracle’s Java Development Kit ‘4 (JDK) . You will also need access to a text editor, preferably 
one that is tailored to the creation of Java programs. One such freely available text editor is named DrJava 
15 

However, DrJava is more than just a text editor. It is an Integrated Development Environment ((IDE) 
that is designed for use by students learning how to program in the Java programming language. I recommend 
it for use with this group of Programming Fundamentals modules. 

See A Quick Start Guide to DrJava 16 for instructions on downloading and installing both the DrJava 
IDE and Oracle’s Java Development Kit (JDK) . 

The Quick Start Guide also provides instructions for using the DrJava IDE. 


2.1.4 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0103 Preface to Programming Fundamentals 
e File: Jb0103.htm 

e Published: 11/22/12 

e Revised: 09/03/15 


“http://www.cs.princeton.edu /courses/archive/spr05/cos126/cmd-prompt.html 
Shttp://steve-jansen.github.io/guides/windows-batch-scripting/part-1-getting-started-html 
®http://cnx.org/content /m48033/latest /?collection=col11478 /latest 
Mhttps://legacy.cnx.org/content /m48033/1.1/#Tutorial_ Links 
'http://cnx.org/content /m44153/latest /?collection=col11441/latest 
12http://cnx.org/content /m44148 
13http://cnx.org/content /m46135/latest /?collection=col11441/latest 
'4http://www-oracle.com/technetwork/java/javase /downloads/index.html 
l5http://www.drjava.org/ 
'6http://www.drjava.org/docs/quickstart /index.html 
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if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.2 Jb0105: Java OOP: Similarities and Differences between Java 
and C++” 


2.2.1 Table of Contents 


e Preface (p. 7) 
e Similarities and differences (p. 7) 
e Miscellaneous (p. 10) 


2.2.2 Preface 


This module, which presents some of the similarities and differences between Java and C++, is provided 
solely for the benefit of those students who are already familiar with C++ and are making the transition 
from C++ into Java. 

If you have some familiarity with C++, you may find the material in this module helpful. If not, simply 
skip this module and move on to the next module in the collection. 

In general, students in Prof. Baldwin’s Java/OOP courses are not expected to have any specific knowledge 
of C++. 

This module is intended to be general in nature. Therefore, although a few update notes were added 
prior to publication at cnx.org, no significant effort has been made to keep it up to date relative to any 
particular version of the Java JDK or any particular version of C++. Changes have occurred in both Java 
and C++ since the first publication of this document in 1997. Those changes may not be reflected in this 
module. 


2.2.3 Similarities and differences 


This list of similarities and differences is based heavily on The Java Language Environment, A White Paper 
18 by James Gosling and Henry McGilton and Thinking in Java by Bruce Eckel, which was freely available 
on the web when this document was first published. 

Java does not support typedefs , defines , ora preprocessor . Without a preprocessor, there are 
no provisions for including header files. 


'7This content is available online at <http://cnx.org/content /m45142/1.3/>. 
18http://net.uom.gr/Books/Manuals/langenviron-a4.pdf 
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Since Java does not have a preprocessor there is no concept of #define macros or manifest constants 
. However, the declaration of named constants is supported in Java through use of the final keyword. 


Java does not support enums but, as mentioned above, does support named constants . (Note: the 
enum type '® was introduced into Java sometime between the first publication of this document and Java 
version 7.) 


Java supports classes , but does not support structures or unions 

All stand-alone C++ programs require a function named main and can have numerous other functions, 
including both stand-alone functions and functions that are members of a class. There are no stand-alone 
functions in Java. Instead, there are only functions that are members of a class, usually called methods. 
However, a Java application (not a Java applet) does require a class definition containing a main method. 

Global functions and global data are not allowed in Java. However, variables that are declared static 
are shared among all objects instantiated from the class in which the static variables are declared. 
(Generally, static has a somewhat different meaning in C++ and Java. For example, the concept of a static 
local variable does not exist in Java as it does in C++.) 

All classes in Java ultimately inherit from the class named Object . This is significantly different from 
C++ where it is possible to create inheritance trees that are completely unrelated to one another. All Java 
objects contain the eleven methods that are inherited from the Object class. 

All function or method definitions in Java are contained within a class definition. To a C++ programmer, 
they may look like inline function definitions, but they aren’t. Java doesn’t allow the programmer to request 
that a function be made inline, at least not directly. 

Both C++ and Java support class (static) methods or functions that can be called without the require- 
ment to instantiate an object of the class. 

The interface keyword in Java is used to create the equivalence of an abstract base class containing 
only method declarations and constants. No variable data members or method definitions are allowed in a 
Java interface definition. (True abstract base classes can also be created in Java.) The interface concept 
is not supported by C++ but can probably be emulated. 

Java does not support multiple class inheritance. To some extent, the interface feature provides the 
desirable features of multiple class inheritance to a Java program without some of the underlying problems. 

While Java does not support multiple class inheritance, single inheritance in Java is similar to C++, but 
the manner in which you implement inheritance differs significantly, especially with respect to the use of 
constructors in the inheritance chain. 

In addition to the access modifiers applied to individual members of a class, C++ allows you to provide 
an additional access modifier when inheriting from a class. This latter concept is not supported by Java. 

Java does not support the goto statement (but goto is a reserved word) . However, it does support 
labeled break and continue statements, a feature not supported by C+-+. In certain restricted situations, 
labeled break and continue statements can be used where a goto statement might otherwise be used. 

Java does not support operator overloading 

Java does not support automatic type conversions (except where guaranteed safe) . 

Unlike C++, Java has a String type, and objects of this type are immutable (cannot be modified) 

(Note, although I’m not certain, I believe that the equivalent of a Java String type was introduced into 
C++ sometime after the original publication of this document.) 

Quoted strings are automatically converted into String objects in Java. Java also hasa StringBuffer 
type. Objects of this type can be modified, and a variety of string manipulation methods are provided. 

Unlike C++, Java provides true arrays as first-class objects. There is a length member, which tells you 
how big the array is. An exception is thrown if you attempt to access an array out of bounds. All arrays 
are instantiated in dynamic memory and assignment of one array to another is allowed. However, when 
you make such an assignment, you simply have two references to the same array. Changing the value of an 
element in the array using one of the references changes the value insofar as both references are concerned. 

Unlike C++, having two "pointers" or references to the same object in dynamic memory is not necessarily 
a problem (but it can result in somewhat confusing results) . In Java, dynamic memory is reclaimed 


'Shttp://docs.oracle.com/javase/tutorial/java/javaOO /enum.html 
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automatically, but is not reclaimed until all references to that memory become NULL or cease to exist. 
Therefore, unlike in C++, the allocated dynamic memory cannot become invalid for as long as it is being 
referenced by any reference variable. 

Java does not support pointers (at least it does not allow you to modify the address contained in 
a pointer or to perform pointer arithmetic) . Much of the need for pointers was eliminated by providing 
types for arrays and strings. For example, the oft-used C++ declaration char* ptr needed to point to the 
first character in a C++ null-terminated "string" is not required in Java, because a string is a true object 
in Java. 

A class definition in Java looks similar to a class definition in C++, but there is no closing semicolon. 
Also forward reference declarations that are sometimes required in C++ are not required in Java. 

The scope resolution operator (::) required in C++ is not used in Java. The dot is used to construct all 
fully-qualified references. Also, since there are no pointers, the pointer operator (->) used in C++ is not 
required in Java. 

In C++, static data members and functions are called using the name of the class and the name of the 
static member connected by the scope resolution operator. In Java, the dot is used for this purpose. 

Like C++, Java has primitive types such as int , float , etc. Unlike C++, the size of each primitive 
type is the same regardless of the platform. There is no unsigned integer type in Java. Type checking and 
type requirements are much tighter in Java than in C++. 

Unlike C++, Java provides a true boolean type. (Note, the C++ equivalent of the Java boolean type 
may have been introduced into C++ subsequent to the original publication of this document.) 

Conditional expressions in Java must evaluate to boolean rather than to integer, as is the case in C++. 
Statements such as 

if(x+y)... 

are not allowed in Java because the conditional expression doesn’t evaluate to a boolean 

The char type in C++ is an 8-bit type that maps to the ASCII (or extended ASCII) character 
set. The char type in Java is a 16-bit type and uses the Unicode character set (the Unicode values 
from 0 through 127 match the ASCII character set) . For information on the Unicode character set see 
http://www.unicode.org/ 7° . 

Unlike C++, the > operator in Java is a "signed" right bit shift, inserting the sign bit into the vacated 
bit position. Java adds an operator that inserts zeros into the vacated bit positions. 

C++ allows the instantiation of variables or objects of all types either at compile time in static memory or 
at run time using dynamic memory. However, Java requires all variables of primitive types to be instantiated 
at compile time, and requires all objects to be instantiated in dynamic memory at runtime. Wrapper classes 
are provided for all primitive types to allow them to be instantiated as objects in dynamic memory at runtime 
if needed. 

C requires that classes and functions be declared before they are used. This is not necessary in Java. 

The "namespace" issues prevalent in C++ are handled in Java by including everything in a class, and 
collecting classes into packages. 

C requires that you re-declare static data members outside the class. This is not required in Java. 

In C++, unless you specifically initialize variables of primitive types, they will contain garbage. Although 
local variables of primitive types can be initialized in the declaration, primitive data members of a class cannot 
be initialized in the class definition in C++. 

In Java, you can initialize primitive data members in the class definition. You can also initialize them in 
the constructor. If you fail to initialize them, they will be initialized to zero (or equivalent) automatically. 

Like C++, Java supports constructors that may be overloaded. As in C++, if you fail to provide 
a constructor, a default constructor will be provided for you. If you provide a constructor, the default 
constructor is not provided automatically. 

All objects in Java are passed by reference, eliminating the need for the copy constructor used in C++. 

(In reality, all parameters are passed by value in Java. However, passing a copy of a reference variable 
makes it possible for code in the receiving method to access the object referred to by the variable, and 


°http://www.unicode.org/ 
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possibly to modify the contents of that object. However, code in the receiving method cannot cause the 
original reference variable to refer to a different object.) 

There are no destructors in Java. Unused memory is returned to the operating system by way of a 
garbage collector , which runs in a different thread from the main program. This leads to a whole host of 
subtle and extremely important differences between Java and C++. 


Like C++, Java allows you to overload functions (methods) . However, default arguments are not 
supported by Java. 
Unlike C++, Java does not support templates. Thus, there are no generic functions or classes. (Note, 


generics similar to C++ templates were introduced into Java in version 5 subsequent to the original publi- 
cation of this document.) 

Unlike C++, several "data structure" classes are contained in the "standard" version of Java. (Note, 
the Standard Template Library was introduced into the C++ world subsequent to the original publication 
of this document.) 

More specifically, several "data structure" classes are contained in the standard class library that. is 
distributed with the Java Development Kit (JDK). For example, the standard version of Java provides the 
containers Vector and Hashtable that can be used to contain any object through recognition that any 
object is an object of type Object . However, to use these containers, you must perform the appropriate 
upcasting and downcasting, which may lead to efficiency problems. (Note, the upcasting and downcasting 
requirements were eliminated in conjunction with the introduction of "generics" into Java mentioned earlier.) 

Multithreading is a standard feature of the Java language. 

Although Java uses the same keywords as C++ for access control: private , public , and protected 
, the interpretation of these keywords is significantly different between Java and C++. 

There is no virtual keyword in Java. All non-static methods use dynamic binding, so the virtual 
keyword isn’t needed for the same purpose that it is used in C++. 

Java provides the final keyword that can be used to specify that a method cannot be overridden and 
that it can be statically bound. (The compiler may elect to make it inline in this case.) 

The detailed implementation of the exception handling system in Java is significantly different from that 
in C++. 

Unlike C++, Java does not support operator overloading. However, the (+) and (+=) operators are 
automatically overloaded to concatenate strings, and to convert other types to string in the process. 

As in C++, Java applications can call functions written in another language. This is commonly referred 
to as native methods . However, applets cannot call native methods. 

Unlike C++, Java has built-in support for program documentation. Specially written comments can be 
automatically stripped out using a separate program named javadoc to produce program documentation. 

Generally Java is more robust than C++ due to the following: 


Object handles (references) are automatically initialized to null. 

Handles are checked before accessing, and exceptions are thrown in the event of problems. 

You cannot access an array out of bounds. 

The potential for memory leaks is prevented (or at least greatly reduced) by automatic garbage 
collection. 


2.2.4 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0105: Java OOP: Similarities and Differences between Java and C++ 
e File: Jb0105.htm 

e Originally published: 1997 

e Published at cnx.org: 11/17/12 
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e Revised: 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.3 Jb0110: Java OOP: Programming Fundamentals, Getting 
Started” 


2.3.1 Table of Contents 


e Preface (p. 11) 


General (p. 11) 
Prerequisites (p. 12) 
Viewing tip (p. 12) 
x Listings (p. 12) 
e Writing, compiling, and running Java programs (p. 12) 
Writing Java code (p. 12) 
Preparing to compile and run Java code (p. 12) 


x Downloading the java development kit (JDK) (p. 12) 
x Installing the JDK (p. 13) 
x The JDK documentation (p. 13) 


Compiling and running Java code (p. 13) 


x Write your Java program (p. 13) 
* Create a batch file (p. 14) 
x A test program (p. 14) 


e Miscellaneous (p. 15) 


2.3.2 Preface 
2.3.2.1 General 


This module is part of a sub-collection of modules designed to help you learn to program computers. 
This module explains how to get started programming using the Java programming language. 


21 This content is available online at <http://cnx.org/content /m45137/1.4/>. 
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2.3.2.2 Prerequisites 


In addition to an Internet connection and a browser, you will need the following tools (as a minimum) to 
work through the exercises in these modules: 


e The Sun/Oracle Java Development Kit (JDK) (See http://www.oracle.com/technetwork /java/javase/downloads /index. 
22 ) 

e Documentation for the  Sun/Oracle Java Development Kit (JDK) (See 
http://download.oracle.com/javase/7/docs/api/?° ) 

e A simple IDE or text editor for use in writing Java code. 


The minimum prerequisites for understanding the material in these modules include: 


e An understanding of algebra. 
e An understanding of all of the material covered in the earlier modules in this collection. 


2.3.2.3 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


2.3.2.3.1 Listings 


e Listing 1 (p. 14) . Windows batch file. 
e Listing 2 (p. 15) . A test program. 


2.3.3 Writing, compiling, and running Java programs 
2.3.3.1 Writing Java code 


Writing Java code is straightforward. You can write Java code using any plain text editor. You simply need 
to cause the output file to have an extension of .java. 

There are a number of high-level Integrated Development Environments (IDEs) available, such as 
Eclipse and NetBeans, but they tend to be overkill for the relatively simple Java programs described in these 
modules. 

There are also some low-level IDEs available, such as JCreator and DrJava, which are very useful. I 
normally use a free version of JCreator, mainly because it contains a color-coded editor. 

So, just find an editor that you are happy with and use it to write your Java code. 


2.3.3.2 Preparing to compile and run Java code 
Perhaps the most complicated thing is to get your computer set up for compiling and running Java code in 
the first place. 


2.3.3.2.1 Downloading the java development kit (JDK) 


You will need to download and install the free Java JDK from the Oracle/Sun website. As of November, 
2012, you will find that website at http://www.oracle.com /technetwork/java/javase/downloads/index.html 
24 


?2http://www.oracle.com/technetwork/java/javase /downloads/index.html 
3http://download.oracle.com/javase/7/docs/api/ 
4http:/ /www.-oracle.com/technetwork/java/javase /downloads/index.html 
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There is a 64-bit version of the JDK, but I haven’t tried it yet because my home computer won’t can’t 
support it. I am still using the 32-bit version. However, I suspect that the 64-bit version will work just fine 
if you have a computer that supports it. 

Whether you elect to use the 32-bit or 64-bit version is strictly up to you. Either of them should do the 
job very nicely. 


2.3.3.2.2 Installing the JDK 


As of November 2012, you will find installation instructions at 
http://download.oracle.com /javase/7 /docs /webnotes /install/windows /jdk-installation-windows.html an 


I strongly recommend that you read the instructions and pay particular attention to the information 
having to do with setting the path environment variable. 

A word of caution 

If you happen to be running Windows Vista or Windows 7, you may need to use something like the 
following when updating the PATH Environment Variable 


;C:\Program Files (x86) \Java\jdk1.6.0_26\bin 
in place of 
;C:\Program Files\Java\jdk1.7.0\bin 


as shown in the installation instructions. 
I don’t have any experience with any Linux version. Therefore, I don’t have any hints to offer there. 


2.3.3.2.3 The JDK documentation 


It is very difficult to program in Java without access to the documentation for the JDK. 


Several different types of Java documentation are available online at 
http://www.oracle.com /technetwork /java/javase/documentation /index.html 7° . 
Specific documentation for classes, methods, etc., is available online at 


http://download.oracle.com /javase/7/docs/api/ °" . 

It is also possible to download the documentation and install it locally if you have room on your 
disk. The download links for JDK 6 and JDK 7 documentation are also shown on the page at 
http://www.oracle.com /technetwork /java/javase/downloads/index.html 7° . 


2.3.3.3 Compiling and running Java code 


There are a variety of ways to compile and run Java code. The way that I will describe here is the most 
basic and, in my opinion, the most reliable. These instructions apply to a Windows operating system. If you 
are using a different operating system, you will need to translate the instructions to your operating system. 


2.3.3.3.1 Write your Java program 


Begin by using your text editor to write your Java program into one or more text files, each with an extension 

of java. (Files of this type are often referred to as source code files.) Save the source code files in an empty 

folder somewhere on your disk. Make sure that the name of the class containing the main method 
(which you will learn about in a future module) matches the name of the file in which that class is contained 
(except for the extension of .java on the file name, which does not appear in the class name) . 


5http://download.oracle.com/javase/7/docs/webnotes/install/windows/jdk-installation-windows.html 
6http://www.oracle.com/technetwork/java/javase /documentation /index.html 

27http:/ /download.oracle.com/javase/7/docs/api/ 
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2.3.3.3.2 Create a batch file 


Use your text editor to create a batch file (or whatever the equivalent is for your operating system) containing 
the text shown in Listing 1 (p. 14) (with the modifications discussed below) and store it in the same folder 
as your Java source code files.. 

Then execute the batch file, which in turn will execute the program if there are no compilation errors. 


Listing 1 . Windows batch file. 


echo off 
cls 


del *.class 


javac -cp .; hello.java 
java -cp .; hello 


pause 


Table 2.1 


Comments regarding the batch file 
The commands in the batch file of Listing 1 (p. 14) will 


Open a command-line screen for the folder containing the batch file. 

Delete all of the compiled class files from the folder. (If the folder doesn’t contain any class files, this 
will be indicated on the command-line screen.) 

Attempt to compile the program in the file named _hello.java. 

Attempt to run the compiled program using a compiled Java file named hello.class 

Pause and wait for you to dismiss the command-line screen by pressing a key on the keyboard. 


If errors occur, they will be reported on the command-line screen and the program won’t be executed. 

If your program is named something other than hello , (which it typically would be) substitute the 
new name for the word hello where it appears twice in the batch file. 

Don’t delete the pause command 

The pause command causes the command-line window to stay on the screen until you dismiss it by 
pressing a key on the keyboard. You will need to examine the contents of the window if there are errors 
when you attempt to compile and run your program, so don’t delete the pause command. 

Translate to other operating systems 

The format of the batch file in Listing 1 (p. 14) is a Windows format. If you are using a different 
operating system, you will need to translate the information in Listing 1 (p. 14) into the correct format for 
your operating system. 


2.3.3.3.3 A test program 


The test program in Listing 2 (p. 15) can be used to confirm that Java is properly installed on your computer 
and that you can successfully compile and execute Java programs. 
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Listing 2 . A test program. 


class hello { 
public static void main(String[] args){ 
System.out.println("Hello World"); 
}//end main 
3//end class 


Table 2.2 


Instructions 

Copy the code shown in Listing 2 (p. 15) into a text file named hello.java and store in an empty folder 
somewhere on your disk. 

Create a batch file named hello.bat containing the text shown in Listing 1 (p. 14) and store that file 
in the same folder as the file named hello.java 

Execute the batch file. 

If everything is working, a command-line screen should open and display the following text: 


Hello World 
Press any key to continue . 


Congratulations 

If that happens, you have just written, compiled and executed your first Java program. 

Oops 

If that doesn’t happen, you need to go back to the installation instructions and see if you can determine 
why the JDK isn’t properly installed. 

If you get an error message similar to the following, that probably means that you didn’t set the path 
environment variable correctly. 


?javac’ is not recognized as an internal or external command, 
operable program or batch file. 


Beyond that, I can’t provide much advice in the way of troubleshooting hints. 


2.3.4 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0110: Java OOP: Programming Fundamentals, Getting Started 
e File: Jb0110.htm 

e Published: 11/16/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.4 Jb0110r Review” 


2.4.1 Table of Contents 


Preface (p. 17) 
Questions (p. 17) 


1 (p. 17) , 2 (p. 17) , 3 (p. 17) , 4 (p. 17) , 5 (p. 17) , 6 (p. 17) 
Listings (p. 18) 
Answers (p. 19) 
Miscellaneous (p. 20) 


2.4.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0110: Java OOP: Pro- 
gramming Fundamentals, Getting Started °° . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.4.3 Questions 

2.4.3.1 Question 1 

True or false? You need a special IDE to write Java code. 
Answer 1 (p. 20) 

2.4.3.2 Question 2 

True or false? All of the software that you need to create, compile, and run Java programs is free. 
Answer 2 (p. 20) 

2.4.3.3 Question 3 

True or false? Installing the Java JDK can be a little difficult. 
Answer 3 (p. 20) 

2.4.3.4 Question 4 

True or false? Java is so easy that you don’t need documentation to program using Java. 
Answer 4 (p. 20) 

2.4.3.5 Question 5 

True or false? The most fundamental way to compile and run Java applications is from the command line. 
Answer 5 (p. 19) 

2.4.3.6 Question 6 


Write a simple test program that can be used to confirm that the JDK is properly installed on your system. 
Answer 6 (p. 19) 


2°This content is available online at <http://cnx.org/content /m45162/1.6/>. 
3°http://cnx.org/content /m45137 
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2.4.4 Listings 
e Listing 1 (p. 19) . A Java test program. 


This image was inserted here simply to insert some space between the questions and the answers to keep 


them from being visible on the screen at the same time. 
The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 


Oriented Programming. 
None l- (Bx) 


Display your name 


Here is another image that was inserted for the same purpose — to insert space between the questions 


and the answers. 
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Put your name here 


ho 


A | 
Cra ai i 


2.4.5 Answers 
2.4.5.1 Answer 6 


If you can compile and run the program code shown in Listing 1 (p. 19) , the JDK is probably installed 
properly on your computer. 


Listing 1 . A Java test program. 


class hello { 
public static void main(String[] args){ 
System.out.println("Hello World"); 
}//end main 
}//end class 


Table 2.3 


Back to Question 6 (p. 17) 


2.4.5.2 Answer 5 


True. Although a variety of IDEs are available that can be used to compile and run Java applications, the 
most fundamental way is to compile and run the programs from the command line. A batch file in Windows, 
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or the equivalent in other operating systems, can be of some help in reducing the amount of typing required 
to compile and run a Java application from the command line. 
Back to Question 5 (p. 17) 


2.4.5.3 Answer 4 


False. Java uses huge class libraries, which few if any of us can memorize. Therefore, it is very difficult to 
program in Java without access to the documentation for the JDK. 

As of November 2012, several different types of Java documentation are available online at 
http://www.oracle.com /technetwork /java/javase/documentation /index.html 31 . 

Back to Question 4 (p. 17) 


2.4.5.4 Answer 3 


True. Installing the Java JDK can be a little difficult depending on your experi- 

ence and knowledge. As of November 2012, you will find installation instructions at 

http://download.oracle.com/javase /7 / docs /webnotes /install/windows /jdk-installation-windows.html op 
Back to Question 3 (p. 17) 

2.4.5.5 Answer 2 

True. You will need to download and install the free Java JDK from 

the Oracle/Sun website. As of November, 2012, you will find that website at 


http://www.oracle.com /technetwork /java/javase /downloads/index.html 33 


Back to Question 2 (p. 17) 


2.4.5.6 Answer 1 


False. You can write Java code using any plain text editor. You simply need to cause the output file to have 
an extension of .java. 
Back to Question 1 (p. 17) 


2.4.6 Miscellaneous 


This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Jb0110r Review for Programming Fundamentals, Getting Started 
e File: Jb0110r.htm 

e Published: 11/20/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


3Thttp://www.oracle.com/technetwork/java/javase /documentation /index.html 
32http://download.oracle.com/javase/7/docs/webnotes/install/windows/jdk-installation-windows.html 
33http://www.oracle.com/technetwork/java/javase/downloads/index.html 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.5 Jb0115: Java OOP: First Program” 


2.5.1 Table of Contents 


e Preface (p. 21) 
Viewing tip (p. 21) 
x Images (p. 22) 
x Listings (p. 22) 
e Discussion (p. 22) 


Instructions for compiling and running the program (p. 22) 
Comments (p. 22) 
Program output (p. 22) 


Run the program (p. 23) 
Miscellaneous (p. 23) 
Complete program listing (p. 23) 


2.5.2 Preface 


The purpose of this module is to present the first complete Java program of the collection that previews the 
most common forms of the three pillars of procedural programming: 


e sequence 
e selection 
e loop 


The program also illustrates 


e calling a method, 
e passing a parameter to the method, and 
e receiving a returned value from the method. 


As mentioned above, this is simply a preview. Detailed discussions of these topics will be presented in future 
modules. 
2.5.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


34This content is available online at <http://cnx.org/content /m45220/1.3/>. 
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2.5.2.1.1 Images 


e Image 1 (p. 22) . Program output. 


2.5.2.1.2 Listings 


e Listing 1 (p. 24) . Source code for FirstProgram. 


2.5.3 Discussion 
2.5.3.1 Instructions for compiling and running the program 


Assuming that the Java Development Kit (JDK) is properly installed on your computer (see  Jb0110: 
Java OOP: Programming Fundamentals, Getting Started °° ), do the following to compile and run this 
program. 

1. Copy the text from Listing 1 (p. 24) into a text file named FirstProgram.java and store the file 
in a folder on your disk. 

2. Open a command-line window in the folder containing the file. 

3. Type the following command at the prompt to compile the program: 

javac FirstProgram.java 

4. Type the following command at the prompt to run the program: 

java FirstProgram 


2.5.3.2 Comments 


Any text in the program code that begins with // is a comment. The compiler will ignore everything from 
the // to the end of the line. 

Comments were inserted into the program code to explain the code. 

The compiler also ignores blank lines. 

Note that this program was designed to illustrate the concepts while being as non-cryptic as possible. 


2.5.3.3 Program output 


The program should display the text shown in Image 1 (p. 22) on the screen except that the time will be 
different each time you run the program. 


Image 1 . Program output. 


5 
1353849164875 


value in 
Odd time 
countA = 
countA = 
countA = 
countB = 
countB = 


NOrRPONFRO Ill 


countB = 
value out = 10 


35http://cnx.org/content /m45137 
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Table 2.4 


2.5.4 Run the program 


I encourage you to copy the code from Listing 1 (p. 24) . Compile the code and execute it. Experiment with 
the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


2.5.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0115: Java OOP: First Program 
e File: Jb0115.htm 

e Published: 11/25/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


2.5.6 Complete program listing 


A complete listing of the program follows. 
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Listing 1 . Source code for FirstProgram. 


/* Begin block comment 

This is the beginning of a block comment in Java. 
Everything in this block comment is for human consumption 
and will be ignored by the Java compiler. 


File: FirstProgram. java 
Copyright 2012, R.G. Baldwin 


This program is designed to illustrate the most common 
forms of the three pillars of procedural programming in 
Java code: 


sequence 
selection 
loop 


The program also illustrates calling a method, passing 
a parameter to the method, and receiving a returned 
value from the method. 


Assuming that the Java Development Kit (JDK) is properly 
installed on your computer, do the following to compile 
and run this program. 


1. Copy this program into a file named FirstProgram. java 
and store the file in a folder on your disk. 

2. Open a command-line window in the folder containing 
the file. 

3. Type the following command to compile the program: 
javac FirstProgram. java 

4.4. Type the following command to run the program: 

java FirstProgram 


Any text that begins with // in the following program 
code is a comment. The compiler will ignore everything 
from the // to the end of the line. 


The compiler also ignores blank lines. 


Note that this program was designed to illustrate the 
concepts while being as non-cryptic as possible. 


The program should display the following text on the 
screen except that the time will be different each time 
that you run the program. 


value in = 5 
Odd time = 1353849164875 


countA = 0 
countA = 1 Available for free at Connexions <http://cnx.org/content /col11441/1.181> 
countA = 2 
countB = 0 
countB = 1 
countB = 2 
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Table 2.5 


-end- 


2.6 Jb0120: Java OOP: A Gentle Introduction to Java 
Programming” 


2.6.1 Table of Contents 


Preface (p. 25) 


General (p. 25) 
Prerequisites (p. 25) 
Viewing tip (p. 26) 


x Images (p. 26) 
x Listings (p. 26) 
e Discussion and sample code (p. 26) 
Introduction (p. 26) 
Compartments (p. 26) 


Checkout counter example (p. 27) 
Sample program (p. 29) 


Run the program (p. 31) 
Miscellaneous (p. 31) 


2.6.2 Preface 
2.6.2.1 General 


This module is part of a sub-collection of modules designed to help you learn to program computers. 
It provides a gentle introduction to Java programming. 


2.6.2.2 Prerequisites 


In addition to an Internet connection and a browser, you will need the following tools (as a minimum) to 
work through the exercises in these modules: 


e The Sun/Oracle Java Development Kit (JDK) (See http://www.oracle.com/technetwork/java/javase/downloads/index. 
37 ) 

e Documentation for the  Sun/Oracle Java Development Kit (JDK) (See 
http://download.oracle.com/javase/7/docs/api/ ?8 ) 

e A simple IDE or text editor for use in writing Java code. 


The minimum prerequisites for understanding the material in these modules include: 


e An understanding of algebra. 
e An understanding of all of the material covered in the earlier modules in this collection. 


36This content is available online at <http://cnx.org/content /m45138/1.3/>. 
37http://www.oracle.com/technetwork/java/javase /downloads/index.html 
38http://download.oracle.com/javase/7/docs/api/ 
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2.6.2.3 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


2.6.2.3.1 Images 


e Image 1 (p. 27) . A checkout counter algorithm. 


2.6.2.3.2 Listings 


e Listing 1 (p. 29) . Program named Memory(01. 
e Listing 2 (p. 30) . Batch file for Memory01. 


2.6.3 Discussion and sample code 
2.6.3.1 Introduction 


All data is stored in a computer in numeric form. Computer programs do what they do by executing a series 
of calculations on numeric data. It is the order and the pattern of those calculations that distinguishes one 
computer program from another. 

Avoiding the detailed work 

Fortunately, when we program using a high-level programming language such as Java, much of the 
detailed work is done for us behind the scenes. 

Musicians or conductors 

As programmers, we are more like conductors than musicians. The various parts of the computer represent 
the musicians. We tell them what to play, and when to play it, and if we do our job well, we produce a 
solution to a problem. 


2.6.3.2 Compartments 


As the computer program performs its calculations in the correct order, it is often necessary for it to store 
intermediate results someplace, and then come back and get them to use them in subsequent calculations 
later. The intermediate results are stored in memory, often referred to as RAM or Random Access Memory 


A mechanical analogy 

We can think of random access memory as being analogous to a metal rack containing a large number of 
compartments. The compartments are all the same size and are arranged in a column. Each compartment 
has a numeric address printed above it. No two compartments have the same numeric address. Each 
compartment also has a little slot into which you can insert a name or a label for the compartment. No two 
compartments can have the same name. 

Joe, the computer program 

Think of yourself as a computer program. You have the ability to write values on little slips of paper and 
to put them into the compartments. You also have the ability to read the values written on the little slips 
of paper and to use those values for some purpose. However, there are two rules that you must observe: 


e You may not remove a slip of paper from a compartment without replacing it by another slip of paper 
on which you have written a value. 
e You may not put a slip of paper in a compartment without removing the one already there. 
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2.6.3.3 Checkout counter example 


In understanding how you might behave as a human computer program, consider yourself to have a job 
working at the checkout counter of a small grocery store in the 1930s. 
You have two tools to work with: 


e A mechanical adding machine 
e The rack of compartments described above 


Initialization 
Each morning, the owner of the grocery store tells you to insert a name in the slot above each compartment 
and to place a little slip of paper with a number written on it inside each compartment. (In programming 
jargon, we would refer to this as initialization.) 
Each of the names on the compartments represents a type of grocery such as 


e Beans 
e Apples 
e Pears 


No two compartments can have the same name. 

No compartment is allowed to have more than one slip of paper inside it. 

The price of a can of beans 

When you place a new slip of paper in a compartment, you must be careful to remove and destroy the 
one that was already there. 

Each slip of paper that you insert into a compartment contains the price for the type of grocery identified 
by the label on the compartment. 

For example, the slip of paper in the compartment labeled Beans may contain the value 15, meaning 
that each can of beans costs 15 cents. 

The checkout procedure 

As each customer comes to your checkout counter during the remainder of the day, you execute the 
following procedure: 


e Examine each grocery item to determine its type. 
e Read the price stored in the compartment corresponding to that type of grocery. 
e Add that price to that customer’s bill using your mechanical adding machine. 


In programming jargon, we would say that as you process each grocery item for the same customer, you are 
looping . We would also say that you are executing a procedure or an algorithm . 
When you have processed all of the grocery items for a particular customer, you would 


e Press the TOTAL key on the adding machine, 
e Turn the crank, and 
e Present the customer with the bill. 


A schematic representation of the procedure 
We might represent the procedure in schematic form as shown in Image 1 (p. 27) . 


Image 1 . A checkout counter algorithm. 


continued on next page 
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For each customer, do the following: 


For each item, do the following: 
a. Identify the type of grocery item 
b. Get the price from the compartment 
c. Add the price to accumulated total 
End loop on grocery items 


Present customer with a bill 


End loop on a specific customer 


Table 2.6 


Common programming activities 
This procedure illustrates the three activities commonly believed to be the fundamental activities of any 
computer program: 


e sequence 
e selection 
e loop 


Sequence 

A sequence of operations is illustrated by the three items labeled a, b, and c in Image 1 (p. 27) because 

they are executed in sequential order. 
Selection 

The process of identifying the type of grocery item is often referred to as selection . A selection operation 

is the process of selecting among two or more choices. 
Loop 

The process of repetitively examining each grocery item and processing it is commonly referred to as a 
loop . In the early days of programming, for a programming language named FORTRAN, this was referred 
toasa do loop 

An algorithm 
The entire procedure is often referred to as an algorithm . 
Modifying stored data 

Sometimes during the day, the owner of the grocery store may come to you and say that he is going to 
increase the price of a can of Beans from 15 cents to 25 cents and asks you to take care of the change in 
price. 

You write 25 on a slip of paper and put it in the compartment labeled Beans, being careful to remove 
and destroy the slip of paper that was previously in that compartment. For the rest of the day, the new 
price for Beans will be used in your calculations unless the owner asks you to change it again. 

Not a bad analogy 
This is a pretty good analogy to how random access memory is actually used by a computer program. 
Names versus addresses 

As a programmer using a high-level language such as Java, you usually don’t have to be concerned about 
the numeric addresses of the compartments. 

You are able to think about them and refer to them in terms of their names. (Names are easier to 
remember than numeric addresses). However, deep inside the computer, these names are cross-referenced 
to addresses and at the lowest level, the program works with memory addresses instead of names. 

Execute an algorithm 
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A computer program always executes some sort of procedure, which is often called an algorithm . The 
algorithm may be very simple as described in the checkout counter example described above, or it may be 
very complex as would be the case for a spreadsheet program. As the program executes its algorithm, it 
uses the random access memory to store and retrieve the data that is needed to execute the algorithm. 

Why is it called RAM? 

The reason this kind of memory is called RAM or random access memory is that it can be accessed 
in any order. 

Sequential memory 

Some types of memory, such as a magnetic tape, must be accessed in sequential order. This means that 
to get a piece of data (the price of beans, for example) from deep inside the memory, it is necessary to 
start at the beginning and examine every piece of data until the correct one is found. 

Combination random /sequential 

Other types of memory, such as disks, provide a combination of sequential and random access. For 
example, the data on a disk is stored in tracks that form concentric circles on the disk. The tracks can be 
accessed in random order, but the data within a track must be accessed sequentially starting at a specific 
point on the track. 

Sequential memory isn’t very good for use by most computer programs because access to each particular 
piece of data is quite slow. 


2.6.3.4 Sample program 


Listing 1 (p. 29) shows a sample Java program that illustrates the use of memory for the storage and retrieval 
of data. 


Listing 1 . Program named Memory01. 


//File Memory01.java 
class Memory01 { 
public static void main(String[] args){ 
int beans; 
beans = 25; 
System. out.println(beans) ; 
}//end main 
}//End Memory01 class 


Table 2.7 


Listing 2 (p. 30) shows a batch file that you can use to compile and run this program. 
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Listing 2 . Batch file for Memory01. 


echo off 
cls 


del *.class 


javac -cp .; Memory01.java 
java -cp .; Memory01 


pause 


Table 2.8 


Using the procedure that you learned in the Getting Started 3°? module, you should be able to compile 
and execute this program. When you do, the program should display 25 on your computer screen. 

Variables 

You will learn in a future lesson that the term variable is synonymous with the term compartment 
that I have used for illustration purposes in this lesson. 

The important lines of code 

The use of memory is illustrated by the three lines of code in Listing 1 (p. 29) that begin with int , 

beans , and System . We will ignore the other lines in the program in this module and learn about 

them in future modules. 

Declaring a variable 

A memory compartment (or variable) is set aside and given the name beans by the line that begins 
with int in Listing 1 (p. 29) . 

In programmer jargon, this is referred to as declaring a variable . The process of declaring a variable 


e causes memory to be set aside to contain a value, and 
e causes that chunk of memory to be given a name. 


That name can be used later to refer to the value stored in that chunk of memory or variable. 

This declaration in Listing 1 (p. 29) specifies that any value stored in the variable must be of type int 
. Basically, this means that the value must be an integer. Beyond that, don’t worry about what the type 
means at this point. I will explain the concept of type in detail in a future module. 

Storing a value in the variable 

A value of 25 is stored in the variable named beans by the line in Listing 1 (p. 29) that begins with 
the word beans 

In programmer jargon, this is referred to as assigning a value to a variable 

From this point forward, when the code in the program refers to this variable by its name, beans , the 
reference to the variable will be interpreted to mean the value stored there. 

Retrieving a value from the variable 

The line in Listing 1 (p. 29) that begins with the word System reads the value stored in the variable 
named beans by referring to the variable by its name. 

This line also causes that value to be displayed on your computer screen. However, at this point, you 
needn’t worry about what causes it to be displayed. You will learn those details in a future module. Just 
remember that the reference to the variable by its name, beans , reads the value stored in the variable. 

The remaining details 


3°http://cnx.org/content /m45137 /latest / 
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Don’t be concerned at this point about the other details in the program. They are there to make it 


possible for you to compile and execute the program. You will learn about them in future modules. 


2.6.4 Run the program 


I encourage you to run the program that I presented in this lesson to confirm that you get the same results. 
Experiment with the code, making changes, and observing the results of your changes. Make certain that 


you can explain why your changes behave as they do. 


2.6.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0120: Java OOP: A Gentle Introduction to Java Programming 
e File: Jb0120.htm 

e Published: 11/16/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 


not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 


if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 


was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 


in Austin, TX. 


-end- 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


32 CHAPTER 2. PROGRAMMING FUNDAMENTALS 


2.7 Jb0120r Review” 


2.7.1 Table of Contents 
Preface (p. 32) 
Questions (p. 32) 


1 (p. 32) , 2 (p. 32) , 3 (p. 32) , 4 (p. 32) , 5 (p. 32) , 6 (p. 33) , 7 (p. 33) , 8 (p. 33) , 9 (p. 33) 
, 10 (p. 33) , 11 (p. 33) 


Answers (p. 35) 
Miscellaneous (p. 36) 


2.7.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0120: Java OOP: A Gentle 
Introduction to Java Programming *! . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.7.3 Questions 
2.7.3.1 Question 1 
True or false? All data is stored in a computer in numeric form. Computer programs do what they do by 
executing a series of calculations on numeric data. It is the order and the pattern of those calculations that 
distinguishes one computer program from another. 
Answer 1 (p. 36) 
2.7.3.2 Question 2 
True or false? When we program using Java, we must perform most of the detailed work. 
Answer 2 (p. 36) 
2.7.3.3 Question 3 


True or false? As the computer program performs its calculations in the correct order, it is often necessary 
for it to store intermediate results someplace, and then come back and get them to use them in subsequent 
calculations later. 

Answer 3 (p. 35) 
2.7.3.4 Question 4 


True or false? The structured solution to a computer programming problem is often called an algorithm. 
Answer 4 (p. 35) 


2.7.3.5 Question 5 


Which, if any of the following activities is not commonly believed to be fundamental activities of any computer 
program: 


e A. sequence 


40This content is available online at <http://cnx.org/content /m45164/1.5/>. 
4lhttp://cnx.org/content /m45138 
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e B. selection 
e C. loop 


Answer 5 (p. 35) 


2.7.3.6 Question 6 
True or false? As a programmer using a high-level language such as Java, you usually don’t have to be 
concerned about the numeric memory addresses of variables. 
Answer 6 (p. 35) 
2.7.3.7 Question 7 
Why is modern computer memory often referred to as RAM? 
Answer 7 (p. 35) 
2.7.3.8 Question 8 


True or false? The process of declaring a variable 


e causes memory to be set aside to contain a value, and 
e causes that chunk of memory to be given an address. 


Answer 8 (p. 35) 


2.7.3.9 Question 9 


True or false? A value of the type int must be an integer. 
Answer 9 (p. 35) 


2.7.3.10 Question 10 


True or false? In programmer jargon, storing a value in a variable is also referred to as assigning a value to 
a variable. 
Answer 10 (p. 35) 


2.7.3.11 Question 11 


True or false? A reference to a variable name in Java code returns the value stored in the variable. 

Answer 11 (p. 35) 

What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 
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None KEX] 


Display your namet 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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2.7.4 Answers 
2.7.4.1 Answer 11 
True. 

Back to Question 11 (p. 33) 
2.7.4.2 Answer 10 
True. 

Back to Question 10 (p. 33) 
2.7.4.3 Answer 9 
True. 

Back to Question 9 (p. 33) 
2.7.4.4 Answer 8 


False. The process of declaring a variable 


e causes memory to be set aside to contain a value, and 
e causes that chunk of memory to be givena name . 


Back to Question 8 (p. 33) 


2.7.4.5 Answer 7 


Modern computer memory is often called RAM or random access memory because it can be accessed in 
any order. 

Back to Question 7 (p. 33) 
2.7.4.6 Answer 6 


True. You are able to think about variables and refer to them in terms of their names. (Names are easier to 
remember than numeric addresses). However, deep inside the computer, these names are cross-referenced 
to addresses and at the lowest level, the program works with memory addresses instead of names. 
Back to Question 6 (p. 33) 
2.7.4.7 Answer 5 
None. All three are commonly believed to be the fundamental activities of any computer program. 
Back to Question 5 (p. 32) 
2.7.4.8 Answer 4 
True. 
Back to Question 4 (p. 32) 
2.7.4.9 Answer 3 


True. 
Back to Question 3 (p. 32) 
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2.7.4.10 Answer 2 


False. Fortunately, when we program using a high-level programming language such as Java, much of the 
detailed work is done for us behind the scenes. 
Back to Question 2 (p. 32) 


2.7.4.11 Answer 1 


True. 
Back to Question 1 (p. 32) 


2.7.5 Miscellaneous 


This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Jb0120r Review for A Gentle Introduction to Java Programming. 
e File: Jb0120r.htm 

e Published: 12/20/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.8 Jb0130: Java OOP: A Gentle Introduction to Methods in Java” 


2.8.1 Table of Contents 


e Preface (p. 37) 


General (p. 37) 
Prerequisites (p. 37) 
Viewing tip (p. 37) 
x Listings (p. 37) 
e Discussion and sample code (p. 38) 


Introduction (p. 38) 


42This content is available online at <http://cnx.org/content /m45139/1.3/>. 
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Standard methods (p. 38) 
Passing parameters (p. 38) 
Returning values (p. 39) 
Writing your own methods (p. 39) 
Sample program (p. 39) 
x Interesting code fragments (p. 39) 


e Run the program (p. 42) 
e Complete program listings (p. 42) 
e Miscellaneous (p. 43) 


2.8.2 Preface 
2.8.2.1 General 


This module is part of a sub-collection of modules designed to help you learn to program computers. 
It provides a gentle introduction to Java programming methods. 


2.8.2.2 Prerequisites 


In addition to an Internet connection and a browser, you will need the following tools (as a minimum) to 
work through the exercises in these modules: 


e The Sun/Oracle Java Development Kit (JDK) (See http://www.oracle.com/technetwork/java/javase/downloads /index. 
43 ) 

e Documentation for the  Sun/Oracle Java Development Kit (JDK) (See 
http://download.oracle.com/javase/7/docs/api/ ** ) 

e A simple IDE or text editor for use in writing Java code. 


The minimum prerequisites for understanding the material in these modules include: 


e An understanding of algebra. 
e An understanding of all of the material covered in the earlier modules in this collection. 


2.8.2.3 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


2.8.2.3.1 Listings 


Listing 1 (p. 40) . The price of beans. 

Listing 2 (p. 40) . Compute the square root of the price of beans. 

Listing 3 (p. 41) . Display the square root value. 

Listing 4 (p. 42) . Calling the same methods again. 

Listing 5 (p. 43) . The program named SqRt01. 

Listing 6 (p. 43) . A batch file for compiling and running the program named SqRt01. 


43h ttp://www.oracle.com/technetwork/java/javase /downloads/index.html 
44h ttp://download.oracle.com/javase/7/docs/api/ 
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2.8.3 Discussion and sample code 
2.8.3.1 Introduction 


Methods have been used in computer programming since the early days of programming. Methods are often 
called functions, procedures, subroutines, and various other names. 
Calculate the square root 

Suppose that your program needs to calculate the square root of a number. Referring back to your 
high-school algebra book, you could refresh your memory on how to calculate a square root. Then you could 
construct the algorithm describing that process. 

Having the algorithm available, you could write the code to calculate the square root and insert it into 
your program code. Then you could compile, and run your program. If you did it all correctly, your program 
should calculate the square root. (For reasons that will become apparent later, I will refer to the code that 
you inserted as in-line code.) 

Oops, need to do it all over again 

Suppose that further on in your program you discover that you need to calculate the square root of 
another number. And later, you discover that you need to calculate the square root of still another number. 
Obviously, with a few changes, you could copy your original code and insert it as in-line code at each 
location in your program where you need to calculate the square root of a number. 

Is there a better way? 

However, after doing this a few times, you might start asking if there is a better way. The answer is 
"yes, there is a better way." 

A method provides a better way 

The better way is to create a separate program module that has the ability to calculate the square root 
and make that module available for use as a helper to your main program each time your main program 
needs to calculate a square root. In Java, this separate program module is called a method 


2.8.3.2 Standard methods 


The Java programming language contains a large number of methods (in the class libraries) that are already 
available for your use. (Later, I will illustrate the use of a standard method for calculating the square root 
of a number.) 

In addition to the standard methods that are already available, if you need a method to perform some 
function and there is no standard method already available to perform that function, you can write your 
own method. 


2.8.3.3 Passing parameters 


Make the method general 

Normally, when designing and writing a method such as one that can calculate the square root of a 
number, it is desirable to write it in such a way that it can calculate the square root of any number (as 
opposed to only one specific number) . This is accomplished through the use of something called parameters 


The process of causing a method to be executed is commonly referred to as calling the method . 

Pass me the number please 

When your program calls the square-root method, it will need to tell the method the value for which the 
square root is needed. 

In general, many methods will require that you provide certain kinds of information when you call them. 
The code in the method needs this information to be able to accomplish its purpose. 

Passing parameters 

This process of providing information to a method when you call it is commonly referred to as passing 
parameters to the method. For the square-root method, you need to pass a parameter whose value is the 
value of the number for which you need the square root. 
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2.8.3.4 Returning values 
A method will usually 


e perform an action 
e send back an answer. or 
e some combination of the two 


Performing an action 

An example of a method that performs an action is the method named println . We used the printIn 
method in an earlier module to cause information to be displayed on the computer screen. This method does 
not need to send back an answer, because that is not the objective of the method. The objective is simply 
to display some information. 

Sending back an answer 

On the other hand, a method that is designed to calculate the square root of a number needs to be able 
to send the square-root value back to the program that called the method. After all, it wouldn’t be very 
useful if the method calculated the square root and then kept it a secret. The process of sending back an 
answer is commonly referred to as returning a value 

Returned values can be ignored 

Methods can be designed in such a way that they either will or will not return a value. When a method 
does return a value, the program that called the method can either pay attention to that value and use it 
for some purpose, or ignore it entirely. 

For example, in some cases where a method performs an action and also returns a value, the calling 
program may elect to ignore the returned value. On the other hand, if the sole purpose of a method is to 
return a value, it wouldn’t make much sense for a program to call that method and then ignore the value 
that is returned (although that would be technically possible) . 


2.8.3.5 Writing your own methods 


As mentioned earlier, you can write your own methods in Java. I mention this here so you will know that it 
is possible. I will have more to say about writing your own methods in future modules. 


2.8.3.6 Sample program 


A complete listing of a sample program named SqRt01.java is provided in Listing 5 (p. 43) near the end 
of the lesson. A batch file that you can use to compile and run the program is provided in Listing 6 (p. 43) . 
When you compile and run the program, the following output should appear on your computer screen: 
5.049752469181039 
6.0 
As you will see shortly, these are the square root values respectively for 25.5 and 36. 


2.8.3.6.1 Interesting code fragments 


I will explain portions of this program in fragments. I will explain only those portions of the program that 
are germane to this module. Don’t worry about the other details of the program. You will learn about those 
details in future modules. 

You may find it useful to open this lesson in another browser window so that you can easily scroll back 
and forth among the fragments while reading the discussion. 

The first code fragment that I will explain is shown in Listing 1 (p. 40) . 
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Listing 1 . The price of beans. 


double beans; 
beans = 25.5; 


Table 2.9 


What is the price of beans? 

The code fragment shown in Listing 1 (p. 40) declares a variable named beans and assigns a value 
of 25.5 to the variable. (I briefly discussed the declaration of variables in a previous module. I will discuss 
them in more detail in a future module.) 

What is that double thing? 

In an earlier module, I declared a variable with a type named int . At that time, I explained that only 
integer values could be stored in that variable. 

The variable named beans in Listing 1 (p. 40) is declared to be of the type double . I will explain 
the concept of data types in detail in a future module. Briefly, double means that you can store any 
numeric value in this variable, with or without a decimal part. In other words, you can store a value of 3 or 
a value of 3.33 in this variable, whereas a variable with a declared type of int won’t accept a value of 3.33. 

Every method has a name 

Every method, every variable, and some other things as well have names. The names are case sensitive 
. By case sensitive, I mean that the method named amethod is not the same as the method named 
aMethod 

A few words about names in Java 

There are several rules that define the format of allowable names in Java. You can dig into this in more 

detail on the web if you like, but if you follow these two rules, you will be okay: 


e Use only letters and numbers in Java names. 
e Always make the first character a letter. 


A standard method named sqrt 

Java provides a Math library that contains many standard methods. Included in those methods is 
a method named sqrt that will calculate and return the square root of a number that is passed as a 
parameter when the method is called. 

The sqrt method is called on the right-hand side of the equal sign (=) in the code fragment in Listing 
2 (p. 40) . 


Listing 2 . Compute the square root of the price of beans. 


double sqRtBns = Math.sqrt (beans) ; 


Table 2.10 


Calling the sqrt method 
I’m not sure why you would want to do this, but the code fragment in Listing 2 (p. 40) 


e calls the sqrt method and 
e passes a copy of the value stored in the beans variable as a parameter. 
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The sqrt method calculates and returns the square root of the number that it receives as its incoming 
parameter. In this case, it returns the square root of the price of a can of beans. 

A place to save the square root 

I needed some place to save the square root value until I could display it on the computer screen later 
in the program. I declared another variable named sqRtBns in the code fragment in Listing 2 (p. 40) . 
I also caused the value returned from the sqrt method to be stored in, or assigned to, this new variable 
named sqRtBns 

How should we interpret this code fragment? 

You can think of the process implemented by the code fragment in Listing 2 (p. 40) as follows. 

First note that there is an equal sign (=) near the center of the line of code. (Later we will learn that 
this is called the assignment operator.) 

The code on the left-hand side of the assignment operator causes a new chunk of memory to be set aside 
and named sqRtBns . (We call this chunk of code a variable.) 

The code on the right-hand side of the assignment operator calls the sqrt method, passing a copy of 
the value stored in the beans variable to the method. 

When the sqrt method returns the value that is the square root of its incoming parameter, the 
assignment operator causes that value to be stored and saved in the variable named sqRtBns 

Now display the square root value 

The code in the fragment in Listing 3 (p. 41) causes the value now stored in sqRtBns to be displayed 
on the computer screen. 


Listing 3 . Display the square root value. 


System. out.println(sqRtBns) ; 


Table 2.11 


Another method is called here 
The display of the square root value is accomplished by 


e calling another standard method named println and 
e passing a copy of the value stored in sqRtBns as a parameter to the method. 


The println method performs an action (displaying something on the computer screen) and doesn’t 
return a value. 

A method exhibits behavior 

We say that a method exhibits behavior. The behavior of the sqrt method is to calculate and return 
the square root of the value passed to it as a parameter. 

The behavior of the println method is to cause its incoming parameter to be displayed on the computer 
screen. 

What do we mean by syntax? 

Syntax is a word that is often used in computer programming. The thesaurus in the editor that I am 
using to type this document says that a synonym for syntax is grammar. 

I also like to think of syntax as meaning something very similar to format. 

Syntax for passing parameters 

Note the syntax in Listing 2 (p. 40) and Listing 3 (p. 41) for passing a parameter to the method. The 
syntax consists of following the name of the method with a pair of matching parentheses that contain the 
parameter. If more than one parameter is being passed, they are all included within the parentheses and 
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separated by commas. Usually, the order of the parameters is important if more than one parameter is being 
passed. 

Reusing the methods 

The purpose of the code fragment in Listing 4 (p. 42) is to illustrate the reusable nature of methods. 


Listing 4 . Calling the same methods again. 


double peas; 

peas = 36.; 

double sqRtPeas = Math.sqrt (peas) ; 
System. out.println(sqRtPeas) ; 


Table 2.12 


The code in this fragment calls the same sqrt method that was called before. In this case, the method 
is called to calculate the square root of the value stored in the variable named peas instead of the value 
stored in the variable named beans 

This fragment saves the value returned from the sqrt method in a new variable named sqRtPeas 
Then the fragment calls the same printIn method as before to display the value now stored in the variable 
named sqRtPeas 

Write once and use over and over 

Methods make it possible to write some code once and then use that code many times in the same 
program. This is the opposite of in-line code , which requires you to write essentially the same code 
multiple times in order to accomplish the same purpose more than once in a program. 


2.8.4 Run the program 


I encourage you to run the program that I presented in this lesson to confirm that you get the same results. 
Experiment with the code, making changes, and observing the results of your changes. Make certain that 
you can explain why your changes behave as they do. 


2.8.5 Complete program listings 
Listing 5 (p. 43) is a complete listing of the program named SqRt01 
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Listing 5 . The program named SqRt01. 


//File SqRt01.java 
class SqRt01 { 
public static void main(String[] args){ 
double beans; 
beans = 25.5; 
double sqRtBns = Math.sqrt (beans) ; 
System. out.println(sqRtBns) ; 
double peas; 
peas = 36.; 
double sqRtPeas = Math.sqrt (peas); 
System. out.println(sqRtPeas) ; 
}//end main 
}//End SqRt01 class 


Table 2.13 


Listing 6 (p. 43) contains the commands for a batch file that can be used to compile and run the program 
named SqRt01 


Listing 6 . A batch file for compiling and running the program named SqRt01. 


echo off 
cls 


del *.class 


javac -cp .; SqRt01.java 
java -cp .; SqRt01 


pause 


Table 2.14 


2.8.6 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Jb0130: Java OOP: A Gentle Introduction to Methods in Java 
e File: Jb0130.htm 

e Published: 12/16/12 

e Revised: 12/03/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.9 Jb0130r Review” 


2.9.1 Table of Contents 


e Preface (p. 45) 
e Questions (p. 45) 


1 (p. 45) , 2 (p. 45) , 3 (p. 45) , 4 (p. 45) , 5 (p. 45) , 6 (p. 46) , 7 (p. 46) , 8 (p. 46) , 9 (p. 46) 
, 10 (p. 46) , 11 (p. 46) , 12 (p. 48) , 13 (p. 46) , 14 (p. 47) , 15 (p. 47) 


e Answers (p. 48) 
e Miscellaneous (p. 50) 


2.9.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0130: Java OOP: A Gentle 
Introduction to Methods in Java 4° . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.9.3 Questions 

2.9.3.1 Question 1 

True or false? Methods are often called functions, procedures, subroutines, and various other names. 
Answer 1 (p. 50) 

2.9.3.2 Question 2 


True or false? A Java method can be thought of as a separate program module that has the ability to do 
something useful. Having written the method, you can make it available for use as a helper to your main 
program each time your main program needs to have that useful thing done. 

Answer 2 (p. 50) 


2.9.3.3 Question 3 
True or false? In Java, you must write all of the methods that you need. 
Answer 3 (p. 49) 


2.9.3.4 Question 4 


True or false? In the following statement, sqRtPeas is the name of a method. 
System.out.println(sqRtPeas); 
Answer 4 (p. 49) 


2.9.3.5 Question 5 


True or false? Java only allows you to use the pre-written methods in the class libraries. 
Answer 5 (p. 49) 


45This content is available online at <http://cnx.org/content /m45165/1.5/>. 
46http://cnx.org/content /m45139 
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2.9.3.6 Question 6 


Normally, when designing and writing a method such as one that can calculate the square root of a number, 
it is desirable to write it in such a way that it can calculate the square root of any number (as opposed to 
only one specific number) . How is that accomplished? 

Answer 6 (p. 49) 
2.9.3.7 Question 7 


True or false? According to common programming jargon, the process of causing a method to be executed 
is commonly referred to as setting the method. 

Answer 7 (p. 49) 
2.9.3.8 Question 8 


True or false? This process of providing information to a method when you call it is commonly referred to 
as sending a message to the method. 
Answer 8 (p. 49) 


2.9.3.9 Question 9 


True or false? When called, a method will usually 


e perform an action 
e send back an answer. or 
e some combination of the two 


Answer 9 (p. 49) 


2.9.3.10 Question 10 


True or false? A value of type double can be (almost) any numeric value, positive or negative, with or 
without a decimal part. 
Answer 10 (p. 49) 


2.9.3.11 Question 11 


True or false? Java is not a case-sensitive programming language. 
Answer 11 (p. 49) 


2.9.3.12 Question 12 


True or false? The following two rules will generally suffice to keep you out of trouble when defining variable 
and method names in Java: 


e Use only letters and numbers in Java names. 
e Always make the first character a letter. 


Answer 12 (p. 48) 


2.9.3.13 Question 13 


True or false? In Java, the assignment operator is the % character. 
Answer 13 (p. 48) 
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2.9.3.14 Question 14 


True or false? The behavior of the sqrt method is to calculate and display the square root of the value 
passed to it as a parameter. 
Answer 14 (p. 48) 


2.9.3.15 Question 15 


True or false? The syntax for passing parameters to a method consists of following the name of the method 
with a pair of matching parentheses that contain the parameter or parameters. If more than one parameter 
is being passed, they are all included within the parentheses and separated by commas. The order of the 
parameters is not important. 

Answer 15 (p. 48) 

What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


2.9.4 Answers 
2.9.4.1 Answer 15 
False. Normally the order in which parameters are passed to a method is very important. 
Back to Question 15 (p. 47) 
2.9.4.2 Answer 14 
False. The behavior of the sqrt method is to calculate and return the square root of the value passed 
to it as a parameter. 
Back to Question 14 (p. 47) 
2.9.4.3 Answer 13 
False. In Java, the assignment operator is the = character. 
Back to Question 13 (p. 46) 
2.9.4.4 Answer 12 


True. 
Back to Question 12 (p. 46) 
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2.9.4.5 Answer 11 

False. Just like C, C++, and C#, Java is very much a case-sensitive programming language. 
Back to Question 11 (p. 46) 

2.9.4.6 Answer 10 

True. 
Back to Question 10 (p. 46) 

2.9.4.7 Answer 9 

True. 
Back to Question 9 (p. 46) 

2.9.4.8 Answer 8 


False. If you continue in this field of study, you will learn that we send messages to objects by calling 
methods that belong to the objects. The process of providing information to a method when you call it is 
commonly referred to as passing parameters to the method. 

Back to Question 8 (p. 46) 


2.9.4.9 Answer 7 


False. The process of causing a method to be executed is commonly referred to as calling or possibly 
invoking the method. 
Back to Question 7 (p. 46) 


2.9.4.10 Answer 6 
That is accomplished through the use of something called method parameters . 
Back to Question 6 (p. 46) 


2.9.4.11 Answer 5 


False. In addition to the standard methods that are already available, if you need a method to perform some 
function and there is no standard method already available to perform that function, you can write your 
own method. 

Back to Question 5 (p. 45) 


2.9.4.12 Answer 4 


False. In the following statement, println is the name of a method. sqRtPeas is the name of a variable 
whose contents are being passed as a parameter to the println method. 

System.out.println(sqRtPeas); 

Back to Question 4 (p. 45) 


2.9.4.13 Answer 3 


False. The Java programming environment contains a large number of methods (in the class libraries) that 
are already available for you to use when you need them. 
Back to Question 3 (p. 45) 
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2.9.4.14 Answer 2 


True. 
Back to Question 2 (p. 45) 


2.9.4.15 Answer 1 


True. 
Back to Question 1 (p. 45) 


2.9.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0130r Review: A Gentle Introduction to Methods in Java 
e File: Jb0130r.htm 

e Published: 12/20/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.10 Jb0140: Java OOP: Java comments” 


2.10.1 Table of Contents 


e Preface (p. 51) 


General (p. 51) 
Prerequisites (p. 51) 
Viewing tip (p. 51) 
x Images (p. 51) 
x Listings (p. 51) 
e Discussion and sample code (p. 52) 


Comments (p. 52) 


47This content is available online at <http://cnx.org/content /m45140/1.4/>. 
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Sample program (p. 53) 
x Interesting code fragments (p. 53) 


e Run the program (p. 54) 
e Complete program listings (p. 54) 
e Miscellaneous (p. 54) 


2.10.2 Preface 

2.10.2.1 General 

This module is part of a sub-collection of modules designed to help you learn to program computers. 
It explains Java comments. 

2.10.2.2 Prerequisites 


In addition to an Internet connection and a browser, you will need the following tools (as a minimum) to 
work through the exercises in these modules: 


e The Sun/Oracle Java Development Kit (JDK) (See http://www.oracle.com/technetwork/java/javase/downloads/index. 
48 ) 

e Documentation for the Sun/Oracle Java Development Kit (JDK) (See 
http://download.oracle.com/javase/7/docs/api/ *° ) 

e A simple IDE or text editor for use in writing Java code. 


The minimum prerequisites for understanding the material in these modules include: 


e An understanding of algebra. 
e An understanding of all of the material covered in the earlier modules in this collection. 


2.10.2.3 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


2.10.2.3.1 Images 


e Image 1 (p. 52). Three styles of comments. 


2.10.2.3.2 Listings 


e Listing 1 (p. 53) . A multi-line comment. 

e Listing 2 (p. 53) . Three single-line comments. 

e Listing 3 (p. 54) . The program named Comments01. 

e Listing 4 (p. 54) . Batch file to compile and run the program named Comments01. 


48http://www.oracle.com/technetwork/java/javase /downloads/index.html 
49http://download.oracle.com/javase/7/docs/api/ 
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2.10.3 Discussion and sample code 
2.10.3.1 Comments 
Producing and using a Java program consists of the following steps: 


1. Write the source code. 
2. Compile the source code. 
3. Execute the program. 


The source code consists of a set of instructions that will later be presented to a special program called a 
compiler for the purpose of producing a program that can be executed. In other words, when you write the 
source code, you are writing instructions that the compiler will use to produce the executable program. 

Some things should be ignored 

Sometimes, when you are writing source code, you would like to include information that may be useful 
to you, but should be ignored by the compiler. Information of that sort is called a comment 

Three styles of comments 

Java supports the three styles of comments shown in Image 1 (p. 52) . 


Image 1 . Three styles of comments. 


/** special documentation comment 
used by the javadoc tool */ 


/* This is a 
multi-line comment */ 


//Single-line comment 
program code // Another single-line comment 


Table 2.15 


The javadoc tool 

The javadoc tool mentioned in Image 1 (p. 52) is a special program that is used to produce documentation 
for Java program. Comments of this style begin with /** and end with */ as shown in Image 1 (p. 52) . 

The compiler ignores everything in the source code that begins and ends with this pattern of characters. 
Documentation produced using the javadoc program is very useful for on-line or on-screen documentation. 

Multi-line comments 

Multi-line comments begin with /* and end with */ as shown in Image 1 (p. 52) . As you have probably 
already guessed, the compiler also ignores everything in the source code that matches this format. (A 
javadoc comment is simply a multi-line comment insofar as the compiler knows. Only the special program 
named javadoc.exe cares about javadoc comments.) 

The multi-line comment style is particularly useful for creating large blocks of information that should 
be ignored by the compiler. This style can be used to produce a comment consisting of a single line of text 
as well. However, the single-line comment style discussed in the next section requires less typing. 

Single-line comments 

Single-line comments begin with // and end at the end of the line. The compiler ignores the // and 
everything following the slash characters to the end of the line. 

This style is particularly useful for inserting short comments throughout the source code. In this case, 
the // can appear at the beginning of the line as shown in Image 1 (p. 52) , or can appear anywhere in the 
line, including at the end of some valid source code (also shown in Image 1 (p. 52) ) 
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2.10.3.2 Sample program 


The purpose of the program named Comments01 , which is shown in Listing 3 (p. 54) near the end of 
the module, is to illustrate the use of single and multi-line comments. The program does not contain any 
javadoc comments. 

The commands for a batch file that you can use to compile and run this program are provided in Listing 
4 (p. 54). 

When you compile and run the program, the following text should appear on your command-line screen: 

Hello World 


2.10.3.2.1 Interesting code fragments 


I will explain this program in fragments, and will explain only those portions of the program that are germane 
to this module. Don’t worry about the other details of the program at this time. You will learn about those 
details in future modules. 

A multi-line comment 

Listing 1 (p. 53) , shows a multi-line comment, which consists of three lines of text. 

As required, this multi-line comment begins with /* and ends with */. The extra stars on the third line 
are simply part of the comment. 

You will often see formats similar to this being used to provide a visual separation between multi-line 
comments and the other parts of a program. 


Listing 1 . A multi-line comment. 


/*File Comments01. java 
This is a multi-line comment. 
Tete CeCLeCLeCTrCrerrrrrrrerrererrere tt 2. 2 of 


Table 2.16 


Single-line comments 
Listing 2 (p. 53) shows three single-line comments. Can you spot them? Remember, single-line comments 
begin with //. 


Listing 2 . Three single-line comments. 


class Comments01 { 
//This is a single-line comment 
public static void main(String[] args){ 
System.out.println("Hello World"); 
}//end main 
}//End class 


Table 2.17 


One of the comments in Listing 2 (p. 53) starts at the beginning of the line. The other two comments 
follow some program code. 
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2.10.4 Run the program 


I encourage you to run the program that I presented in this lesson to confirm that you get the same results. 
Experiment with the code, making changes, and observing the results of your changes. Make certain that 
you can explain why your changes behave as they do. 


2.10.5 Complete program listings 


Listing 3 (p. 54) contains a complete listing of the program named Comments01 


Listing 3 . The program named Comments01. 


/*File Comments01.java 
This is a multi-line comment. 
OS ASIC I II I ICI ICI I A I A A ACK EEE EEEE EEEE EEEN 
class Comments01 { 
//This is a single-line comment 
public static void main(String[] args){ 
System.out.println("Hello World"); 
}//end main 
}//End class 


Table 2.18 


Listing 4 (p. 54) contains the commands for a batch file that can be used to compile and run the program 
named Comments01 


Listing 4 . Batch file to compile and run the program named Comments01. 


echo off 
cls 


del *.class 


javac -cp .; Comments01.java 
java -cp .; Comments01 


pause 


Table 2.19 


2.10.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 
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e Module name: JJb0140: Java OOP: Java comments 
e File: Jb0140.htm 

e Published: 11/16/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.11 Jb0140r Review” 


2.11.1 Table of Contents 


e Preface (p. 56) 
e Questions (p. 56) 


1 (p. 56) , 2 (p. 56) , 3 (p. 56) , 4 (p. 56) , 5 (p. 56) , 6 (p. 56) , 7 (p. 57) , 8 (p. 57) 


e Answers (p. 58) 
e Miscellaneous (p. 59) 


2.11.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0140: Java OOP: Java 
comments ° . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.11.3 Questions 

2.11.3.1 Question 1 

True or false? Comments in your source code are ignored by the compiler. 
Answer 1 (p. 59) 

2.11.3.2 Question 2 

True or false? Java supports the four styles of comments. 
Answer 2 (p. 59) 

2.11.3.3 Question 3 

True or false? The javadoc tool is a special program that is used to compile Java programs. 
Answer 3 (p. 59) 

2.11.3.4 Question 4 

True or false? Comments recognized by the javadoc tool begin with /** and end with */ 
Answer 4 (p. 59) 

2.11.3.5 Question 5 

True or false? Multi-line comments begin with /# and end with #/ 
Answer 5 (p. 58) 

2.11.3.6 Question 6 


True or false? The multi-line comment style is particularly useful for creating large blocks of information 
that should be ignored by the compiler. 
Answer 6 (p. 58) 


50This content is available online at <http://cnx.org/content /m45169/1.5/>. 
*1http://cnx.org/content /m45140 
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2.11.3.7 Question 7 


True or false? The multi-line comment style cannot be used to produce a comment consisting of a single line 
of text. 
Answer 7 (p. 58) 


2.11.3.8 Question 8 


True or false? Single-line comments begin with // and end at the end of the line. 

Answer 8 (p. 58) 

What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None 


Display your nami 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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2.11.4 Answers 
2.11.4.1 Answer 8 
True. 

Back to Question 8 (p. 57) 
2.11.4.2 Answer 7 
False. The multi-line comment style can be used to produce a comment consisting of none, one, or more 
lines of text. 

Back to Question 7 (p. 57) 
2.11.4.3 Answer 6 
True. 

Back to Question 6 (p. 56) 
2.11.4.4 Answer 5 


False. Multi-line comments begin with /* and end with */ 
Back to Question 5 (p. 56) 
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2.11.4.5 Answer 4 


True. 
Back to Question 4 (p. 56) 


2.11.4.6 Answer 3 


False. The javadoc tool is a special program that is used to produce documentation for Java program. 
Back to Question 3 (p. 56) 


2.11.4.7 Answer 2 


False. Java supports the three styles of comments. 
Back to Question 2 (p. 56) 


2.11.4.8 Answer 1 


True. 
Back to Question 1 (p. 56) 


2.11.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0140r Review: Java comments 
e File: Jb0140r.htm 

e Published: 11/21/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.12 Jb0150: Java OOP: A Gentle Introduction to Java Data Types” 


2.12.1 Table of Contents 


e Preface (p. 60) 


General (p. 60) 

Prerequisites (p. 60) 

Viewing tip (p. 60) 
x Images (p. 61) 

e Discussion (p. 61) 

Introduction (p. 61) 

Primitive types (p. 63) 
x Whole-number types (p. 63) 
x Floating-point types (p. 65) 
x The character type (p. 69) 
x The boolean type (p. 69) 


User-defined or reference types (p. 70) 
Sample program (p. 72) 


e Miscellaneous (p. 72) 


2.12.2 Preface 
2.12.2.1 General 


This module is part of a sub-collection of modules designed to help you learn to program computers. 
It introduces Java data types. 


2.12.2.2 Prerequisites 


In addition to an Internet connection and a browser, you will need the following tools (as a minimum) to 
work through the exercises in these modules: 


e The Sun/Oracle Java Development Kit (JDK) (See http://www.oracle.com/technetwork/java/javase/downloads /index. 
58 ) 

e Documentation for the  Sun/Oracle Java Development Kit (JDK) (See 
http://download.oracle.com/javase/7/docs/api/ 54 ) 

e A simple IDE or text editor for use in writing Java code. 


The minimum prerequisites for understanding the material in these modules include: 


e An understanding of algebra. 
e An understanding of all of the material covered in the earlier modules in this collection. 


2.12.2.3 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images while you are reading about them. 


52'This content is available online at <http://cnx.org/content /m45141/1.3/>. 
*3http://www.oracle.com/technetwork/java/javase /downloads/index.html 
54http://download.oracle.com/javase/7/docs/api/ 
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2.12.2.3.1 Images 


e Image 1 (p. 65) . Range of values for whole-number types. 

e Image 2 (p. 65) . Definition of floating point. 

e Image 3 (p. 66) . Different ways to represent 623.57185. 

e Image 4 (p. 66) . Relationships between multiplicative factors and exponentiation. 
e Image 5 (p. 67) . Other ways to represent the same information. 

e Image 6 (p. 67) . Still other ways to represent 623.57185. 

e Image 7 (p. 68) . Range of values for floating-point types. 

e Image 8 (p. 70) . Example of the use of the boolean type. 


2.12.3 Discussion 
2.12.3.1 Introduction 


Type-sensitive languages 

Java and some other modern programming languages make heavy use of a concept that we refer to as 
type ,or datatype . 

We refer to those languages as _ type-sensitive languages . Not all languages are type-sensitive languages. 
In particular, some languages hide the concept of type from the programmer and automatically deal with 
type issues behind the scenes. 

So, what do we mean by type? 

One analogy that comes to my mind is international currency. For example, many years ago, I spent a 
little time in Japan and quite a long time on an island named Okinawa (Okinawa is now part of Japan) . 

Types of currency 

At that time, as now, the type of currency used in the United States was the dollar. The type of currency 
used in Japan was the yen, and the type of currency used on the island of Okinawa was also the yen. However, 
even though two of the currencies had the same name, they were different types of currency, as determined 
by the value relationships among them. 

The exchange rate 

As I recall, at that time, the exchange rate between the Japanese yen and the U.S. dollar was 360 yen for 
each dollar. The exchange rate between the Okinawan yen and the U.S. dollar was 120 yen for each dollar. 
This suggests that the exchange rate between the Japanese yen and the Okinawan yen would have been 3 
Japanese yen for each Okinawan yen. 

Analogous to different types of data 

So, why am I telling you this? I am telling you this to illustrate the concept that different types of 
currency are roughly analogous to different data types in programming. 

Purchasing transactions were type sensitive 

In particular, because there were three different types of currency involved, the differences in the types 
had to be taken into account in any purchasing transaction to determine the price in that particular currency. 
In other words, the purchasing process was sensitive to the type of currency being used for the purchase 
(type sensitive) . 

Different types of data 

Type-sensitive programming languages deal with different types of data. Some data types such at type 
int involve whole numbers only (no fractional parts are allowed) . 

Other data types such as double involve numbers with fractional parts. 

Some data types conceptually have nothing to do with numeric values, but deal only with the concept of 
true or false ( boolean ) or with the concept of the letters of the alphabet and the punctuation characters 
( char ) . 

Type specification 

For every different type of data used with a particular programming language, there is a specification 
somewhere that defines two important characteristics of the type: 
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1. What is the set of all possible data values that can be stored in an instance of the type (we will learn 
some other names for instance later) ? 

2. Once you have an instance of the type, what are the operations that you can perform on that instance 
alone, or in combination with other instances? 


What do I mean by an instance of a type? 

Think of the type specification as being analogous to the plan or blueprint for a model airplane. Assume 
that you build three model airplanes from the same set of plans. You will have created three instances of 
the plans. 

We might say that an instance is the physical manifestation of a plan or a type. 

Using mixed types 

Somewhat secondary to the specifications for the different types, but also extremely important, is a set 
of rules that define what happens when you perform an operation involving mixed types (such as making a 
purchase using some yen currency in combination with some dollar currency) . 

The short data type 

For example, in addition to the integer type int , there is a data type in Java known as short . The 
short type is also an integer type. 

If you have an instance of the short type, the set of all possible values that you can store in that 
instance is the set of all the whole numbers ranging from -32,768 to +32,767. 

This constitutes a set of 65,536 different values, including the value zero. No other value can be stored 
in an instance of the type short . For example, you cannot store the value 35,000 in an instance of the 
type short in Java. If you need to store that value, you will need to use some type other than short 

Kind of like an odometer 

This is somewhat analogous to the odometer in your car (the thing that records how many miles the car 
has been driven) . For example, depending on the make and model of car, there is a specified set of values 
that can appear in the odometer. The value that appears in the odometer depends on how many miles your 
car has been driven. 

It is fairly common for an odometer to be able to store and to display the set of all positive values 
ranging from zero to 99999. If your odometer is designed to store that set of values and if you drive your 
car more than 99999 miles, it is likely that the odometer will roll over and start back at zero after you pass 
the 99999-mile mark. In other words, that particular odometer does not have the ability to store a value of 
100,000 miles. Once you pass the 99999-mark, the data stored in the odometer is corrupt. 

Now let’s return to the Java type named short 

Assume that you have two instances of the type short in a Java program. What are the operations 

that you can perform on those instances? For example: 


You can add them together. 

You can subtract one from the other. 

You can multiply one by the other. 

You can divide one by the other. 

You can compare one with the other to determine which is algebraically larger. 


There are some other operations that are allowed as well. In fact, there is a well-defined set of operations 
that you are allowed to perform on those instances. That set of operations is defined in the specification for 
the type short 

What if you want to do something different? 

However, if you want to perform an operation that is not allowed by the type specification, then you will 
have to find another way to accomplish that purpose. 

For example, some programming languages allow you to raise whole-number types to a power (examples: 
four squared, six cubed, nine to the fourth power, etc.) . However, that operation is not allowed by the 
Java specification for the type short . If you need to do that operation with a data value of the Java 
short type, you must find another way to do it. 
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Two major categories of type 
Java data types can be subdivided into two major categories: 


e Primitive types 
e User-defined or reference types 


These categories are discussed in more detail in the following sections. 


2.12.3.2 Primitive types 


Java is an extensible programming language 

What this means is that there is a core component to the language that is always available. Beyond this, 
individual programmers can extend the language to provide new capabilities. The primitive types discussed 
in this section are the types that are part of the core language. A later section will discuss user-defined types 
that become available when a programmer extends the language. 

More subdivision 

It seems that when teaching programming, I constantly find myself subdividing topics into sub-topics. I 

am going to subdivide the topic of Primitive Types into four categories: 


Whole-number types 
Floating-point types 
Character types 
Boolean types 


Hopefully this categorization will make it possible for me to explain these types in a way that is easier for 
you to understand. 


2.12.3.2.1 Whole-number types 


The whole-number types, often called integer types, are relatively easy to understand. These are types 
that can be used to represent data without fractional parts. 

Applesauce and hamburger 

For example, consider purchasing applesauce and hamburger. At the grocery store where I shop, I am 
allowed to purchase cans of applesauce only in whole-number or integer quantities. 

Can purchase integer quantities only 

For example, the grocer is happy to sell me one can of applesauce and is even happier to sell me 36 cans 
of applesauce. However, she would be very unhappy if I were to open a can of applesauce in the store and 
attempt to purchase 6.3 cans of applesauce. 

Counting doesn’t require fractional parts 

A count of the number of cans of applesauce that I purchase is somewhat analogous to the concept of 
whole-number data types in Java. Applesauce is not available in fractional parts of cans (at my grocery 
store) . 

Fractional pounds of hamburger are available 

On the other hand, the grocer is perfectly willing to sell me 6.3 pounds of hamburger. This is somewhat 
analogous to floating-point data types in Java. 

Accommodating applesauce and hamburger in a program 

Therefore, if I were writing a program dealing with quantities of applesauce and hamburger, I might elect 
to use a whole number type to represent cans of applesauce and to use a floating-point type to represent 
pounds of hamburger. 

Different whole-number types 

In Java, there are four different whole-number types: 


e byte 
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e short 
e int 
e long 


(The char type is also a whole number type, but since it is not intended to be used for arithmetic, I discuss 
it later as a character type.) 

The four types differ primarily in terms of the range of values that they can accommodate and the amount 
of computer memory required to store instances of the types. 

Differences in operations? 
Although there are some subtle differences among the four whole-number types in terms of the operations 
that you can perform on them, I will defer a discussion of those differences until a more advanced module. 
(For example some operations require instances of the byte and short types to be converted to type 
int before the operation takes place.) 
Algebraically signed values 

All four of these types can be used to represent algebraically signed values ranging from a specific negative 

value to a specific positive value. 
Range of the byte type 

For example, the byte type can be used to represent the set of whole numbers ranging from -128 to 
+127 inclusive. (This constitutes a set of 256 different values, including the value zero.) 

The byte type cannot be used to represent any value outside this range. For example, the byte type 
cannot be used to represent either -129 or +128. 

No fractional parts allowed by the byte type 

Also, the byte type cannot be used to represent fractional values within the allowable range. For 
example, the byte type cannot be used to represent the value of 63.5 or any other value that has a fractional 
part. 

Like a strange odometer 

To form a crude analogy, the byte type is sort of like a strange odometer in a new (and unusual) car 
that shows a mileage value of -128 when you first purchase the car. As you drive the car, the negative values 
shown on the odometer increment toward zero and then pass zero. Beyond that point they increment up 
toward the value of +127. 

Oops, numeric overflow! 

When the value passes (or attempts to pass) +127 miles, something bad happens. From that point 
forward, the value shown on the odometer is not a reliable indicator of the number of miles that the car has 
been driven. 

Ranges for each of the whole-number types 

Image 1 (p. 65) shows the range of values that can be accommodated by each of the four whole-number 

types supported by the Java programming language: 
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Image 1 . Range of values for whole-number types. 


byte 
-128 to +127 


short 
-32768 to +32767 


int 
-2147483648 to +2147483647 


long 
-9223372036854775808 to +9223372036854775807 


Table 2.20 


Can represent some fairly large values 

As you can see, the int and long types can represent some fairly large values. However, if your task 
involves calculations such as distances in interstellar space, these ranges probably won’t accommodate your 
needs. This will lead you to consider using the floating-point types discussed in the upcoming sections. I 
will discuss the operations that can be performed on whole-number types more fully in future modules. 


2.12.3.2.2 Floating-point types 


Floating-point types are a little more complicated than whole-number types. I found the definition of 
floating-point shown in Image 2 (p. 65) in the Free On-Line Dictionary of Computing at this URL °° . 


Image 2 . Definition of floating point. 


A number representation consisting of a mantissa, M, an exponent, E, and an (assumed) radix (or "base") . The number 


Table 2.21 


So what does this really mean? 
Assuming a base or radix of 10, I will attempt to explain it using an example. 
Consider the following value: 
623.57185 
I can represent this value in any of the ways shown in Image 3 (p. 66) (where * indicates multiplication). 


'5http://foldoc.org/floating+point 
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Image 3 . Different ways to represent 623.57185. 


.62357185*1000 
6.2357185*100 
62.357185*10 
623.57185*1 
6235.7185*0.1 
62357 .185*0.01 
623571 .85%*0.001 
6235718 .5*0.0001 
62357185. *0.00001 


Table 2.22 


In other words, I can represent the value as a mantissa (62357185) multiplied by a factor where the 
purpose of the factor is to represent a left or right shift in the position of the decimal point. 

Now consider the factor 

Each of the factors shown in Image 3 (p. 66) represents the value of ten raised to some specific power, 
such as ten squared, ten cubed, ten raised to the fourth power, etc. 

Exponentiation 

If we allow the following symbol (^) to represent exponentiation (raising to a power) and allow the 
following symbol (/) to represent division, then we can write the values for the above factors in the ways 
shown in Image 4 (p. 66) . 

Note in particular the characters following the first equal character (=) on each line, which I will refer 
to later as the exponents. 


Image 4 . Relationships between multiplicative factors and exponentiation. 


1000 = 107+3 = 1*10*10*10 
100 = 107+2 = 1*10*10 
10 = 107+1 = 1*10 
1 = 10^+0 = 1 
0.1 = 107-1 = 1/10 
0.01 = 107-2 = 1/(10*10) 
0.001 = 107-3 = 1/(10*10*10) 
0.0001 = 107-4 = 1/(10*10*10*10) 
0.00001 = 107-5 = 1/(10*10*10*10%*10) 


Table 2.23 


In the above notation, the term 10°+3 means 10 raised to the third power. 

The zeroth power 

By definition, the value of any value raised to the zeroth power is 1. (Check this out in your high-school 
algebra book.) 

The exponent and the factor 

Hopefully, at this point you will understand the relationship between the exponent and the factor intro- 
duced earlier in Image 3 (p. 66) . 
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Different ways to represent the same value 

Having reached this point, by using substitution, I can rewrite the original set of representations (p. 66) 
of the value 623.57185 in the ways shown in Image 5 (p. 67) . 

(It is very important to for you to understand that these are simply different ways to represent the same 
value.) 


Image 5 . Other ways to represent the same information. 


.62357185*107+3 
6.2357185*107+2 
62.357185*107+1 
623.57185*107+0 
6235.7185*107-1 
62357 .185*107-2 
623571 .85*107-3 
6235718 .5*107-4 
62357185. *107-5 


Table 2.24 


A simple change in notation 
Finally, by making a simplifying change in notation where I replace (*10*) by (E) I can rewrite the 
different representations of the value of 623.57185 in the ways shown in Image 6 (p. 67) . 


Image 6 . Still other ways to represent 623.57185. 


.62357185E+3 
6.2357185E+2 
62.357185E+1 
623.57185E+0 
6235.7185E-1 
62357 .185E-2 
623571 .85E-3 
6235718 .5E-4 
62357185.E-5 


Table 2.25 


Getting the true value 

Floating point types represent values as a mantissa containing a decimal point along with an exponent 
value which tells how many places to shift the decimal point to the left or to the right in order to determine 
the true value. 

Positive exponent values mean that the decimal point should be shifted to the right. Negative exponent 
values mean that the decimal point should be shifted to the left. 

Maintaining fractional parts 

One advantage of floating-point types is that they can be used to maintain fractional parts in data values, 
such as 6.3 pounds of hamburger. 
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Accommodating a very large range of values 

Another advantage is that a very large range of values can be represented using a reasonably small amount 
of computer memory for storage of the values. 

Another example 

For example (assuming that I counted the number of digits correctly) the following very large value 

62357185000000000000000000000000000000.0 

can be represented as 

6.2357185E+37 

Similarly, again assuming that I counted the digits correctly, the following very small value 

0.0000000000000000000000000000062357185 

can be represented as 

6.2357185E-30 

When would you use floating-point? 

If you happen to be working in an area where you 


e need to keep track of fractional parts (such as the amount of hamburger in a package) , 
e have to work with extremely large numbers (distances between galaxies) , or 
e have to work with extremely small values (the size of atomic particles) , 


then you will need to use the floating-point types. 

Don’t use floating-point in financial transactions 

You probably don’t want to use floating-point in financial calculations, however, because there is a lot of 
rounding that takes place in floating-point calculations. In other words, floating point calculations provide 
answers that are very close to the truth but the answers are often not exact. 

Two floating-point types 

Java supports two different floating point types: 


e float 
e double 


These two types differ primarily in terms of the range of values that they can support. 

Range of values for floating point types 

The table in Image 7 (p. 68) shows the smallest and largest values that can be accommodated by each 
of the floating-point types. Values of either type can be either positive or negative. 


Image 7 . Range of values for floating-point types. 


float 
1.4E-45 to 3.4028235E38 


double 
4.9E-324 to 1.7976931348623157E308 


Table 2.26 


I will discuss the operations that can be performed on floating-point types in a future module. 
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2.12.3.2.3 The character type 


Computers deal only in numeric values. They don’t know how to deal directly with the letters of the alphabet 
and punctuation characters. This gives rise to a type named char 
Purpose of the char type 

The purpose of the character type is to make it possible to represent the letters of the alphabet, the 
punctuation characters, and the numeric characters internally in the computer. This is accomplished by 
assigning a numeric value to each character, much as you may have done to create secret codes when you 
were a child. 

A single character type 

Java supports a single character type named char . The char type uses a standard character represen- 

tation known as Unicode to represent up to 65,535 different characters. 
Why so many characters? 

The reason for the large number of possible characters is to make it possible to represent the characters 

making up the alphabets of many different countries and many different spoken languages. 
What are the numeric values representing characters? 

As long as the characters that you use in your program appear on your keyboard, you usually don’t have 
a need to know the numeric value associated with the different characters. If you are curious, however, the 
upper-case A is represented by the value 65 in the Unicode character set. 

Representing a character symbolically 

In Java, you usually represent a character in your program by surrounding it with apostrophes as shown 
below: 

A’. 

The Java programming tools know how to cross reference that specific character symbol against the 
Unicode table to obtain the corresponding numeric value. (A discussion of the use of the char type to 
represent characters that don’t appear on your keyboard is beyond the scope of this module.) 

I will discuss the operations that can be performed on the char type in a future module. 


2.12.3.2.4 The boolean type 


The boolean type is the simplest type supported by Java. It can have only two values: 


e true 
e false 


Generally speaking, about the only operations that can be directly applied to an instance of the boolean 
type are to change it from true to false , and vice versa. However, the boolean type can be included 
in a large number of somewhat higher-level operations. 

The boolean type is commonly used in some sort of a test to determine what to do next, such as that 
shown in Image 8 (p. 70) . 


Image 8 . Example of the use of the boolean type. 


Perform a test that returns a value of type boolean. 
if that value is true, 

do one thing 
otherwise (meaning that value is false) 

do a different thing 


Table 2.27 
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I will discuss the operations that can be performed on the boolean type in more detail in a future module. 


2.12.3.3 User-defined or reference types 


Extending the language 

Java is an extensible programming language. By this, I mean that there is a core component to 
the language that is always available. Beyond the core component, different programmers can extend the 
language in different ways to meet their individual needs. 

Creating new types 

One of the ways that individual programmers can extend the language is to create new types. When 
creating a new type, the programmer must define the set of values that can be stored in an instance of the 
type as well as the operations that can be performed on instances of the type. 

No magic involved 

While this might initially seem like magic, once you get to the heart of the matter, it is really pretty 
straightforward. New types are created by combining instances of primitive types along with instances of 
other user-defined types. In other words, the process begins with the primitive types explained earlier and 
builds upward from there. 

An example 

For example, a String type, which can be used to represent a person’s last name, is just a grouping of 
a bunch of instances of the primitive char or character type. 

A user-defined Person type, which could be used to represent both a person’s first name and their last 
name, might simply be a grouping of two instances of the user-defined String type. 

Differences 

The biggest conceptual difference between the String type and the Person type is that the String 
type is contained in the standard Java library while the Person type isn’t in that library. However, you 
could put it in a library of your own design if you choose to do so. 

Removing types 

You could easily remove the String type from your copy of the standard Java library if you choose 
to do so, although that would probably be a bad idea. However, you cannot remove the primitive double 
type from the core language without making major modifications to the language. 

The company telephone book 

A programmer responsible for producing the company telephone book might create a new type that can 
be used to store the first and last names along with the telephone number of an individual. That programmer 
might choose to give the new type the name Employee 

The programmer could create an instance of the Employee type to represent each employee in the 
company, populating each such instance with the name and telephone number for an individual employee. 

(At this point, let me sneak a little jargon in and tell you that we will be referring to such instances as 

objects.) 

A comparison operation 

The programmer might define one of the allowable operations for the new Employee type to bea 
comparison between two objects of the new type to determine which is greater in an alphabetical sorting sense. 
This operation could be used to sort the set of objects representing all of the employees into alphabetical 
order. The set of sorted objects could then be used to print a new telephone book. 

A name-change operation 

Another allowable operation that the programmer might define would be the ability to change the name 
stored in an object representing a particular employee. For example when Suzie Smith marries Tom Jones, 
she might elect to thereafter be known as 


e Suzie Smith 

e Suzie Jones, 

e Suzie Smith-Jones, 

e Suzie Jones-Smith, or 
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e something entirely different. 


In this case, there would be a need to modify the object that represents Suzie in order to reflect her newly- 
elected surname. (Or perhaps Tom Jones might elect to thereafter be known as Tom Jones-Smith, in which 
case it would be necessary to modify the object that represents him.) 

An updated telephone book 

The person charged with maintaining the database could 


e use the name-changing operation to modify the object and change the name, 
e make use of the sorting operation to re-sort the set of objects, and 
e print and distribute an updated version of the telephone book. 


Many user-defined types already exist 

Unlike the primitive types which are predefined in the core language, I am unable to give you much in 
the way of specific information about user-defined types, simply because they don’t exist until a user defines 
them. 

I can tell you, however, that when you obtain the Java programming tools from Sun, you not only receive 
the core language containing the primitive types, you also receive a large library containing several thousand 
user-defined types that have already been defined. A large documentation package is available from Sun to 
help you determine the individual characteristics of these user-defined types. 

The most important thing 

At this stage in your development as a Java programmer, the most important thing for you to know 
about user-defined types is that they are possible. 

You can define new types. Unlike earlier procedural programming languages such as C and Pascal, you 
are no longer forced to adapt your problem to the available tools. Rather, you now have the opportunity to 
extend the tools to make them better suited to solve your problem. 

The class definition 

The specific Java mechanism that makes it possible for you to define new types is a mechanism known 
as the class definition . 

In Java, whenever you define a new class, you are at the same time defining a new type. Your new type 
can be as simple, or as complex and powerful as you want it to be. 

An object (instance) of your new type can contain a very small amount of data, or it can contain a very 
large amount of data. The operations that you allow to be performed on an object of your new type can be 
rudimentary, or they can be very powerful. 

It is all up to you 

Whenever you define a new class (type) you not only have the opportunity to define the data definition 

and the operations, you also have a responsibility to do so. 
Much to learn and much to do 

But, you still have much to learn and much to do before you will need to define new types. 

There are a lot of fundamental programming concepts that we will need to cover before we seriously 
embark on a study involving the definition of new types. 

For the present then, simply remember that such a capability is available, and if you work to expand 
your knowledge of Java programming one small step at a time, when we reach the point of defining new 
types, you will be ready and eager to do so. 


2.12.3.4 Sample program 


I’m not going to provide a sample program in this module. Instead, I will be using what you have learned 
about Java data types in the sample programs in future modules. 
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2.12.4 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0150: Java OOP: A Gentle Introduction to Java Data Types 
e File: Jb0150.htm 

e Published: 11/17/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.13 Jb0150r Review” 


2.13.1 Table of Contents 


e Preface (p. 73) 
e Questions (p. 73) 


1 (p. 73) , 2 (p. 73) , 3 (p. 73) , 4 (p. 73) , 5 (p. 73) , 6 (p. 74) , 7 (p. 74) , 8 (p. 74) , 9 (p. 74) 
, 10 (p. 74) , 11 (p. 74) , 12 (p. 79) , 13 (p. 75) , 14 (p. 75) , 15 (p. 75) , 16 (p. 75) , 17 (p. 75) , 
18 (p. 75) , 19 (p. 75) , 20 (p. 75) , 21 (p. 76) , 22 (p. 76) , 23 (p. 76) , 24 (p. 76) , 25 (p. 76) , 


e Answers (p. 78) 
e Miscellaneous (p. 80) 


2.13.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0150: Java OOP: A Gentle 
Introduction to Java Data Types 57 . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.13.3 Questions 

2.13.3.1 Question 1 

True or false? Java is a type-sensitive language. 
Answer 1 (p. 80) 

2.13.3.2 Question 2 

True or false? Data type double involves whole numbers only (no fractional parts are allowed) . 
Answer 2 (p. 80) 

2.13.3.3 Question 3 

True or false? Type double involves numbers with fractional parts. 
Answer 3 (p. 80) 

2.13.3.4 Question 4 

True or false? All Java data types conceptually have something to do with numeric values. 
Answer 4 (p. 80) 

2.13.3.5 Question 5 


True or false? The Java char type deals conceptually with the letters of the alphabet, the numeric 
characters, and the punctuation characters. 
Answer 5 (p. 80) 


56 This content is available online at <http://cnx.org/content /m45168/1.5/>. 
57http://cnx.org/content /m45141 
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2.13.3.6 Question 6 


True or false? For every different type of data used with a particular programming language, there is a 
specification somewhere that defines two important characteristics of the type: 


1. What is the set of all possible data values that can be stored in an instance of the type? 
2. Once you have an instance of the type, what are the operations that you can perform on that instance 
alone, or in combination with other instances? 


Answer 6 (p. 80) 


2.13.3.7 Question 7 
True or false? If you have an instance of the byte type, the set of all possible values that you can store in 
that instance is the set of all the whole numbers ranging from -256 to +255. 
Answer 7 (p. 80) 
2.13.3.8 Question 8 
Name or describe four of the operations that you can perform with data of type short 
Answer 8 (p. 79) 
2.13.3.9 Question 9 


True or false? Java data types can be subdivided into two major categories: 


e Primitive types 
e User-defined or reference types 


Answer 9 (p. 79) 


2.13.3.10 Question 10 

True or false? The primitive types are not part of the core language. 
Answer 10 (p. 79) 

2.13.3.11 Question 11 


True or false? For purposes of discussion, primitive types can be subdivided into four categories: 


Whole-number types 
Floating-point types 
Character types 
Boolean types 


Answer 11 (p. 79) 


2.13.3.12 Question 12 


True or false? In Java, there are three different whole-number types: 
byte 
short 


int 


Answer 12 (p. 79) 
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2.13.3.13 Question 13 


True or false? The whole-number types differ in terms of the range of values that they can accommodate 
and the amount of computer memory required to store instances of the types. 
Answer 13 (p. 79) 


2.13.3.14 Question 14 

True or false? Java provides an unsigned version of all of the primitive whole-number types. 
Answer 14 (p. 79) 

2.13.3.15 Question 15 


True or false? Floating point types represent values as a mantissa containing a decimal point along with an 
exponent value that tells how many places to shift the decimal point to the left or to the right in order to 
determine the true value. 

Answer 15 (p. 79) 


2.13.3.16 Question 16 


True or false? With a floating point type, positive exponent values mean that the decimal point should be 

shifted to the left. Negative exponent values mean that the decimal point should be shifted to the right. 
Answer 16 (p. 79) 

2.13.3.17 Question 17 


True or false? Java supports two different floating point types: 


e float 
e double 


Answer 17 (p. 78) 


2.13.3.18 Question 18 


True or false? The purpose of the char type is to make it possible to represent the letters of the alphabet, 
the punctuation characters, and the numeric characters internally in the computer. This is accomplished by 
assigning a numeric value to each character. 

Answer 18 (p. 78) 


2.13.3.19 Question 19 


True or false? The char type uses a standard character representation known as Unicode to represent 
up to 65,535 different characters. 
Answer 19 (p. 78) 


2.13.3.20 Question 20 


True or false? In Java, you usually represent a character in your program by surrounding it with quotation 
marks as shown below: 

"A", 

Answer 20 (p. 78) 
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2.13.3.21 Question 21 


True or false? The boolean type can have three values: 


e true 
e false 
e maybe 


Answer 21 (p. 78) 


2.13.3.22 Question 22 


True or false? Java is an extensible programming language, meaning that there is a core component to 
the language that is always available. Beyond the core component, different programmers can extend the 
language in different ways to meet their individual needs. 

Answer 22 (p. 78) 


2.13.3.23 Question 23 


True or false? As is the case in C++, one of the ways that individual programmers can extend the Java 
language is to create overloaded operators for the primitive types. 
Answer 23 (p. 78) 


2.13.3.24 Question 24 


True or false? One of the ways that individual programmers can extend the Java language is to create new 


types. 
Answer 24 (p. 78) 


2.13.3.25 Question 25 


True or false? The specific Java mechanism that makes it possible for programmers to define new types is a 
mechanism known as the class definition . 

Answer 25 (p. 78) 

What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


77 


None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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2.13.4 Answers 
2.13.4.1 Answer 25 
True. 
Back to Question 25 (p. 76) 
2.13.4.2 Answer 24 
True. 
Back to Question 24 (p. 76) 
2.13.4.3 Answer 23 
False. Java does not allow programmers to create overloaded operators for the primitive types. 
Back to Question 23 (p. 76) 
2.13.4.4 Answer 22 
True. 
Back to Question 22 (p. 76) 
2.13.4.5 Answer 21 


False. The boolean type can have only two values: 


e true 
e false 


Back to Question 21 (p. 76) 


2.13.4.6 Answer 20 
False. In Java, you usually represent a character in your program by surrounding it with apostrophes as 
shown below: 

A’. 

Back to Question 20 (p. 75) 
2.13.4.7 Answer 19 
True. 

Back to Question 19 (p. 75) 
2.13.4.8 Answer 18 
True. 

Back to Question 18 (p. 75) 
2.13.4.9 Answer 17 


True. 
Back to Question 17 (p. 75) 
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2.13.4.10 Answer 16 
False. With a floating point type, positive exponent values mean that the decimal point should be shifted 
tothe right . Negative exponent values mean that the decimal point should be shifted to the left 
Back to Question 16 (p. 75) 
2.13.4.11 Answer 15 
True. 
Back to Question 15 (p. 75) 
2.13.4.12 Answer 14 
False. Other than type char , there are no unsigned whole-number primitive types in Java. 
Back to Question 14 (p. 75) 
2.13.4.13 Answer 13 
True. 
Back to Question 13 (p. 75) 
2.13.4.14 Answer 12 
False. In Java, there are five different whole-number types: 
byte 
short 
int 


long 
char 


Back to Question 12 (p. 74) 


2.13.4.15 Answer 11 

True. 
Back to Question 11 (p. 74) 

2.13.4.16 Answer 10 

False. The primitive types are part of the core language. 
Back to Question 10 (p. 74) 

2.13.4.17 Answer 9 

True. 
Back to Question 9 (p. 74) 

2.13.4.18 Answer 8 


Four of the possible operations are: 


e You can add them together. 
e You can subtract one from the other. 
e You can multiply one by the other. 
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e You can divide one by the other. 


Back to Question 8 (p. 74) 


2.13.4.19 Answer 7 
False. If you have an instance of the byte type, the set of all possible values that you can store in that 
instance is the set of all the whole numbers ranging from -128 to +127. 
Back to Question 7 (p. 74) 
2.13.4.20 Answer 6 
True. 
Back to Question 6 (p. 74) 
2.13.4.21 Answer 5 
True. 
Back to Question 5 (p. 73) 
2.13.4.22 Answer 4 
False. In Java, data type boolean conceptually has nothing to do with numeric values, but deals only 
with the concept of true or false 
Back to Question 4 (p. 73) 
2.13.4.23 Answer 3 
True. 
Back to Question 3 (p. 73) 
2.13.4.24 Answer 2 
False. Some data types such at type int involve whole numbers only (no fractional parts are allowed) . 
Back to Question 2 (p. 73) 
2.13.4.25 Answer 1 


True. 
Back to Question 1 (p. 73) 


2.13.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0150r Review: A Gentle Introduction to Java Data Types 
e File: Jb0150r-htm 

e Published: 11/21/12 

e Revised: 12/04/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.14 Jb0160: Java OOP: Hello World” 


2.14.1 Table of Contents 


Preface (p. 81) 
Viewing tip (p. 81) 

Images (p. 81) 

Listings (p. 82) 
Introduction (p. 82) 
The Java version of Hello World (p. 84) 
Interesting code fragments (p. 84) 
General information (p. 85) 
Run the program (p. 86) 
Miscellaneous (p. 86) 
Complete program listing (p. 87) 


2.14.2 Preface 


It is traditional in introductory programming courses to write and explain a simple program that prints the 
text "Hello World" on the computer screen. 
This module continues that tradition. 


2.14.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view images and listings while you are reading about them. 


2.14.2.1.1 Images 


e Image 1 (p. 83) . How to compile and run a Java application. 


58 This content is available online at <http://cnx.org/content /m45143/1.3/>. 
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2.14.2.1.2 Listings 


e Listing 1 (p. 84) . Beginning of the class named hello1. 
e Listing 2 (p. 85) . Beginning of the main method. 

e Listing 3 (p. 85) . Display the string Hello World. 

e Listing 4 (p. 85) . End of the class named hello1. 

e Listing 5 (p. 87) . Complete program listing. 


2.14.3 Introduction 


This module introduces you to Java programming by presenting and discussing a traditional Hello World 
program. 

Two approaches 

Java programs can be written and executed in several different. ways, including the following: 


e Stand-alone application from the command line. 
e Applet that runs under control of a Java-capable browser. 


It is also possible in many cases to write applets, which can be run in a stand-alone mode from the command 
line, or can be run under control of a Java-capable browser. An example of such an applet will be presented 
in a future module. 

Applets vs. applications 

Programming an "application" in Java is significantly different from programming an "applet." Applets 
are designed to be downloaded and executed on-line under control of a browser. 

Restrictions on applets 

Their functionality of an applet is usually restricted in an attempt to prevent downloaded applets from 

damaging your computer or your data. No such restrictions apply to the functionality of a Java application. 
Class definitions 

All Java programs consist of one or more class definitions. In this course, I will often refer to the 

primary class definition for a Java application as the controlling class . 
The main method 

A stand-alone Java application requires a method named main in its controlling class . 

An Applet does not require a main method. The reason that a Java Applet does not require a 
main method will be explained in a future module. 

Getting started 

Image 1 (p. 83) shows the steps for compiling and running a Java application. 

1. Download and install the JDK from Oracle. Also consider downloading and installing the documen- 
tation, which is a separate download. 

2. Using any editor that can produce a plain text file (such as Notepad), create a source code file with 
the extension on the file name being .java This file contains your actual Java instructions. (You can copy 
some sample programs from the early lessons in this collection to get started.) 

3. Open a command-line window and change directory to the directory containing the source file. It 
doesn’t really matter which directory the source file is in, but I normally put my Java files in a directory all 
their own. 

4. Assume that the name of the file is joe.java  , just to have something definitive to refer to. 

5. To compile the file, enter the following command at the prompt: 

javac joe.java 

6. Correct any compiler errors that show up. Once you have corrected all compiler errors, the javac 
program will execute and return immediately to the prompt with no output. At that point, the directory 
should also contain a file named joe.class and possibly some other files with a .class extension as well. 
These are the compiled Java files. 

7. To run the program, enter the following command: 
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java joe 
8. If your program produces the correct output, congratulations. You have written, compiled, and 
executed a Java application. If not, you will need to determine why not. 


1. Download and install the JDK from Oracle. Also consider downloading and installing the documen- 
tation, which is a separate download. 

2. Using any editor that can produce a plain text file (such as Notepad), create a source code file with 
the extension on the file name being .java This file contains your actual Java instructions. (You can copy 
some sample programs from the early lessons in this collection to get started.) 

3. Open a command-line window and change directory to the directory containing the source file. It 
doesn’t really matter which directory the source file is in, but I normally put my Java files in a directory all 
their own. 

4. Assume that the name of the file is joe.java_ , just to have something definitive to refer to. 

5. To compile the file, enter the following command at the prompt: 

javac joe.java 

6. Correct any compiler errors that show up. Once you have corrected all compiler errors, the javac 
program will execute and return immediately to the prompt with no output. At that point, the directory 
should also contain a file named joe.class and possibly some other files with a .class extension as well. 
These are the compiled Java files. 

7. To run the program, enter the following command: 

java joe 

8. If your program produces the correct output, congratulations. You have written, compiled, and 
executed a Java application. If not, you will need to determine why not. 


1. Download and install the JDK from Oracle. Also consider downloading and installing the documen- 
tation, which is a separate download. 

2. Using any editor that can produce a plain text file (such as Notepad), create a source code file with 
the extension on the file name being .java This file contains your actual Java instructions. (You can copy 
some sample programs from the early lessons in this collection to get started.) 

3. Open a command-line window and change directory to the directory containing the source file. It 
doesn’t really matter which directory the source file is in, but I normally put my Java files in a directory all 
their own. 

4. Assume that the name of the file is joe.java  , just to have something definitive to refer to. 

5. To compile the file, enter the following command at the prompt: 

javac joe.java 

6. Correct any compiler errors that show up. Once you have corrected all compiler errors, the javac 
program will execute and return immediately to the prompt with no output. At that point, the directory 
should also contain a file named joe.class and possibly some other files with a .class extension as well. 
These are the compiled Java files. 

7. To run the program, enter the following command: 

java joe 

8. If your program produces the correct output, congratulations. You have written, compiled, and 
executed a Java application. If not, you will need to determine why not. 


Image 1 . How to compile and run a Java application. 


Here are the steps for compiling and running a Java application, based on the assumption that you are running under Wit 
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Table 2.28 


2.14.4 The Java version of Hello World 


The class file 

Compiled Java programs are stored in "bytecode" form in a file with an extension of class where the 
name of the file is the same as the name of the controlling class (or other class) in the program. 

The main method is static 

The main method in the controlling class of an application must be static , which results in main 
being a class method. 

Class methods can be called without a requirement to instantiate an object of the class. 

When a Java application is started, the Java Virtual Machine or JVM (an executable file named 
java.exe) finds and calls the main method in the class whose name matches the name of the class file 
specified on the command line. 

Running an application 

For example, to start the JVM and run a Java application named hellol , a command such as the 
following must be executed at the operating system prompt: 

java hellol 

This command instructs the operating system to start the JVM, and then instructs the JVM to find and 
execute the java application stored in the file named hellol.class . (Note that the .class extension is not 
included in the command (p. 84) .) 

This sample program is a Java application named hellol.java . 

When compiled, it produces a class file named hellol.class 

When the program is run, the JVM calls the main method defined in the controlling class . 

The main method isa class method. 

Class methods can be called without a requirement to instantiate an object of the class. 

The program displays the following words on the screen: 

Hello World 


2.14.5 Interesting code fragments 


I will explain this program code in fragments. A complete listing of the program is provided in Listing 5 (p. 
87) . 

The code fragment in Listing 1 (p. 84) shows the first line of the class definition for the controlling class 
named hello1 . (I will discuss class definitions in detail in a future module.) 


Listing 1 . Beginning of the class named hellol. 


class helloi { //define the controlling class 


Table 2.29 


The code fragment in Listing 2 (p. 85) begins the definition of the main method. I will also discuss 
method definitions in detail in a future module. 
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Listing 2 . Beginning of the main method. 


public static void main(String[] args){ 


Table 2.30 


The fragment in Listing 3 (p. 85) causes the string Hello World to be displayed on the command-line 
screen. 

The statement in Listing 3 (p. 85) is an extremely powerful statement from an object-oriented program- 
ming viewpoint. When you understand how it works, you will be well on your way to understanding the 
Java version of Object-Oriented Programming (OOP). 

I will discuss this statement in more detail later in a future module. 


Listing 3 . Display the string Hello World. 


System.out.println("Hello World"); 


Table 2.31 


Listing 4 (p. 85) ends the main method and also ends the class definition for the class named hellol 


Listing 4 . End of the class named hellol. 


}//end main 
}//End helloi class 


Table 2.32 


The complete program listing 
As mentioned earlier, a complete listing of the program is provided in Listing 5 (p. 87) near the end of 
the module. 


2.14.6 General information 


This program illustrates several general aspects of Java programming. 

Overall skeleton of java program 

The overall skeleton of any Java program consists of one or more class definitions. 

All methods and variables must be defined inside a class definition. There can be no freestanding 
methods or global variables. 

File names and extensions 

The name of the controlling class should be the same as the name of the source file that contains it. 

Files containing source code in Java have an extension of java . 
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The main method 

The controlling class definition for an application must contain the main method. 

The primary class file 

The file produced by compiling the file containing the controlling class has the same name as the con- 
trolling class, and has an extension of class 

Many class files may be produced 

The java compiler produces a separate file for every class definition contained in an application or applet, 
even if two or more class definitions are contained in the same source file. 

Thus, the compilation of a large application can produce many different class files. 

What are jar files? 

A feature known as a jar file can be used to consolidate those class files into a single file for more 
compact storage, distribution, and transmission. Such a file has an extension of jar 

The main method is static 

The controlling class for a Java application must contain a static method named main 

When you run the application using the JVM, you specify the name of the class file that you want to 
run. 

The JVM then calls the main method defined in the class file having that name. This is possible 
because a class method can be called without a requirement to instantiate an object of the class. 

The main method defined in that class definition controls the flow of the program. 


2.14.7 Run the program 


I encourage you to copy the code from Listing 5 (p. 87) . Compile the code and execute it. Experiment with 
the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


2.14.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0160: Java OOP: Hello World 
e File: Jb0160.htm 

e Originally published: 1997 

e Published at cnx.org: 11/17/12 

e Revised: 12/04/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2.14.9 Complete program listing 


A complete listing of the program discussed in this module is provided in Listing 5 (p. 87) . 
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Listing 5 . Complete program listing. 


/*File hellol.java Copyright 1997, R.G.Baldwin 
This is a Java application program . 


When compiled, this program produces the class named: 
hellol.class 


When the Java interpreter is called upon the application’s 
controlling class using the following statement at the 
command line: 


java hellol 


the interpreter starts the program by calling the main 
method defined in the controlling class. The main method is 
a class method which can be called without the requirement 
to instantiate an object of the class. 


The program displays the following words on the screen: 
Hello World 


FOSS OIG OIG CI ASIII SCI I I I I I I ISI A a EEEE EEEE 
class helloi { //define the controlling class 
//define main method 
public static void main(String[] args){ 
//display text string 
System. out .println("Hello World"); 
}//end main 
}//End hellot class. 


Table 2.33 


-end- 
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2.15 Jb0160r Review” 


2.15.1 Table of Contents 


e Preface (p. 88) 
e Questions (p. 88) 


1 (p. 88) , 2 (p. 88) , 3 (p. 88) , 4 (p. 88) , 5 (p. 88) , 6 (p. 89) , 7 (p. 89) , 8 (p. 89) , 9 (p. 89) 
, 10 (p. 89) , 11 (p. 89) , 12 (p. 92) , 13 (p. 89) 


e Listings (p. 89) 
e Answers (p. 91) 
e Miscellaneous (p. 94) 


2.15.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0160: Java OOP: Hello 
World © . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.15.3 Questions 
2.15.3.1 Question 1 
True or false? Applications are designed to be downloaded and executed on-line under control of a web 
browser, while applets are designed to be executed in a stand-alone mode from the command line. 
Answer 1 (p. 93) 
2.15.3.2 Question 2 
True or false? All applications and applets written in Java require a main method. 
Answer 2 (p. 93) 
2.15.3.3 Question 3 
Explain the relationship between the name of the class file for a Java application and the location of the 
main method in the application. 
Answer 3 (p. 93) 
2.15.3.4 Question 4 
Explain how you cause a method to bea class method in Java. 
Answer 4 (p. 93) 
2.15.3.5 Question 5 


True or false? Class methods can be called without the requirement to instantiate an object of the class: 
Answer 5 (p. 93) 


59This content is available online at <http://cnx.org/content /m45159/1.8/>. 
*°http://cnx.org/content /m45143 
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2.15.3.6 Question 6 


Write the source code for a Java application that will display your name and address on the standard output 
device. Show the command-line statement that would be required to execute a compiled version of your 
application. 

Answer 6 (p. 92) 
2.15.3.7 Question 7 


Show the three styles of comment indicators that are supported by Java. 
Answer 7 (p. 92) 


2.15.3.8 Question 8 
True or false? Java allows free-standing methods outside of a class definition? 
Answer 8 (p. 92) 
2.15.3.9 Question 9 
What is the relationship between the name of the controlling class in an application and the names of the 
files that comprise that application. 
Answer 9 (p. 92) 
2.15.3.10 Question 10 


What is the relationship between the number of classes in an application and the number of separate files 
with the class extension that go to make up that application? How does this change when all the classes 
are defined in the same source file? 

Answer 10 (p. 92) 
2.15.3.11 Question 11 


True or false? Class methods in Java can only be called relative to a specific object. 
Answer 11 (p. 92) 

2.15.3.12 Question 12 

Write the signature line for the main method in a Java application. 
Answer 12 (p. 92) 

2.15.3.13 Question 13 


Write a Java application that will display your name on the screen. 
Answer 13 (p. 91) 


2.15.4 Listings 


e Listing 1 (p. 91) . Listing for Answer 13. 
e Listing 2 (p. 92) . Listing for Answer 7. 
e Listing 3 (p. 93) . Listing for Answer 6. 


What is the meaning of the following two images? 
This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 
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The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


BE None | JER 


Display your nam, 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Put your name here 


2.15.5 Answers 
2.15.5.1 Answer 13 
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Listing 1 . Listing for Answer 13. 


/*File SampProg02. java from lesson 10 
Copyright 1997, R.G.Baldwin 
Without reviewing the following solution, write an 
application that will display your name on the screen. 
FE AGO EEEE EEEE E EE I I IK ak Ka 1 E 21 1 4 21 21 EE EEE E E EE 2 ak kak // 
class SampProg02 { //define the controlling class 
public static void main(String[] args){ //define main 
System.out.println("Dick Baldwin"); 
}//end main 
}//End SampProg02 class. 


Table 2.34 


Back to Question 13 (p. 89) 
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2.15.5.2 Answer 12 


public static void main(String[] args) 
Back to Question 12 (p. 89) 


2.15.5.3 Answer 11 


False. Class methods can be called by joining the name of the class with the name of the method using 
a period. 

Back to Question 11 (p. 89) 
2.15.5.4 Answer 10 


Each class definition results in a separate class file regardless of whether or not the classes are defined 
in separate source files. 
Back to Question 10 (p. 89) 
2.15.5.5 Answer 9 
One of the files must have the same name as the controlling class with an extension of class 
Back to Question 9 (p. 89) 
2.15.5.6 Answer 8 
False. 
Back to Question 8 (p. 89) 


2.15.5.7 Answer 7 


Listing 2 . Listing for Answer 7. 


/** special documentation comment used by the JDK javadoc tool */ 
/* C/C++ style multi-line comment */ 
// C/C++// C/C++ style single-line comment 


Table 2.35 


Back to Question 7 (p. 89) 


2.15.5.8 Answer 6 
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Listing 3 . Listing for Answer 6. 


/*File NameO1.java 
This is a Java application that will display a 
name on the standard output device. 


The command required at the command line to execute this 
program is: 


java NameO1 
FE AG EEE EEEE EEEE E EE EEEE I I I I EEE EE 21 21 21 1 4 21 2k E E EE 2 ak ak ak // 


class Name01 { //define the controlling class 
public static void main(String[] args){ //define main 
System. out .print1n( 
"Dick Baldwin\nAustin Community College\nAustin, TX"); 
}//end main 
}//End Name01 class. 


Table 2.36 


Note that the \n characters in Listing 3 (p. 93) cause the output display to advance to the next line. 
Back to Question 6 (p. 89) 
2.15.5.9 Answer 5 
True. 
Back to Question 5 (p. 88) 
2.15.5.10 Answer 4 
Preface or precede the name of the method with the static keyword. 
Back to Question 4 (p. 88) 
2.15.5.11 Answer 3 
The name of the class file must be the same as the name of the class that contains the main method 
(sometimes called the controlling class) . 
Back to Question 3 (p. 88) 
2.15.5.12 Answer 2 
False. Applets do not require a main method while applications do require a main method. 
Back to Question 2 (p. 88) 
2.15.5.13 Answer 1 


False. Applications are for stand-alone use while applets are for browsers. 
Back to Question 1 (p. 88) 
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2.15.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0160r Review: Hello World 
e File: Jb0160r.htm 

e Published: 11/18/12 

e Revised: 12/04/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.16 Jb0170: Java OOP: A little more information about classes.” 


2.16.1 Table of Contents 


e Preface (p. 94) 

Listings (p. 94) 

Introduction (p. 95) 

Defining a class in Java (p. 95) 
Miscellaneous (p. 96) 


2.16.2 Preface 


This module is part of a sub-collection of modules designed to help you learn to program computers. 
This module sheds a little more light on the Java construct called a class . 


2.16.3 Listings 


e Listing 1 (p. 95) . General syntax for defining a Java class. 


61This content is available online at <http://cnx.org/content /m45144/1.3/>. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


95 


2.16.4 Introduction 


New types 

Java makes extensive use of classes. When a class is defined in Java, anew type comes into being. The 
new type definition can then be used to instantiate (create instances of) one or more objects of that new 
type. 

A blueprint 

The class definition provides a blueprint that describes the data contained within, and the behavior 
of objects instantiated according to the new type. 

The data 

The data is contained in variables defined within the class (often called member variables, data members, 
attributes, fields, properties, etc. ). 

The behavior 

The behavior is controlled by methods defined within the class. 

State and behavior 

An object is said to have state and behavior . At any instant in time, the state of an object is 
determined by the values stored in its variables and its behavior is determined by its methods 

Class vs. instance 

It. is possible to define: 


e instance variables and instance methods 
e static or class variables and static or class methods. 


Instance variables and instance methods can only be accessed through an object instantiated from the class. 
They belong to the individual objects, (which is why they are called instance variables and instance methods) 


Class variables and class methods can be accessed without first instantiating an object. They are 
shared among all of the objects instantiated from the class and are even accessible in the total absence of an 
object of the class. 

The class name alone is sufficient for accessing class variables and class methods by joining the name 
of the class to the name of the variable or method using a period. 


2.16.5 Defining a class in Java 


The general syntax for defining a class in Java is shown in Listing 1 (p. 95) . 


Listing 1 . General syntax for defining a Java class. 


class MyClassNamef{ 


} //End of class definition. 


Table 2.37 
This syntax defines a class and creates a new type named MyClassName 


The definitions of variables, methods, constructors, and a variety of other members are inserted between 
the opening and closing curly brackets. 
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2.16.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0170: Java OOP: A little more information about. classes. 
e File: Jb0170.htm 

e Originally published: 1997 

e Published at cnx.org: 11/17/12 

e Revised: 12/04/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.17 Jb0170r: Review” 


2.17.1 Table of Contents 


e Preface (p. 97) 
e Questions (p. 97) 
1 (p. 97) , 2 (p. 97) , 3 (p. 97) , 4 (p. 97) , 5 (p. 97) , 6 (p. 97) , 7 (p. 98) , 8 (p. 98) 


e Answers (p. 99) 
e Miscellaneous (p. 100) 


2.17.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0170: Java OOP: A little 


more information about classes 3 . 


The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.17.3 Questions 

2.17.3.1 Question 1 

List two of the many names commonly used for variables defined within a class in Java. 
Answer 1 (p. 100) 

2.17.3.2 Question 2 

List two of the many names commonly used for the functions defined within a class in Java. 
Answer 2 (p. 100) 

2.17.3.3 Question 3 


An object is said to have state and behavior . At any instant in time, the state of an object is determined 
by the values stored in its (a) and its behavior is determined by its (b) 
Answer 3 (p. 100) 


2.17.3.4 Question 4 

What keyword is used to cause a variable or method to become a class variable or class method in Java? 
Answer 4 (p. 99) 

2.17.3.5 Question 5 


True or false? Instance variables and instance methods can only be accessed through an object of the 
class in Java. 
Answer 5 (p. 99) 


2.17.3.6 Question 6 


True or false? In Java, the class name alone is sufficient for accessing class variables and class methods 
by joining the name of the class with the name of the variable or method using a colon. 
Answer 6 (p. 99) 


62This content is available online at <http://cnx.org/content /m45177/1.5/>. 
*3http://cnx.org/content /m45144 
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2.17.3.7 Question 7 


True or false? Show the general syntax of an empty class definition in Java. 
Answer 7 (p. 99) 


2.17.3.8 Question 8 


True or false? The syntax for a class definition in Java requires a semicolon following the closing curly 
bracket. 

Answer 8 (p. 99) 

What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None 


Display your nam: 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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2.17.4 Answers 

2.17.4.1 Answer 8 

False. Java does not require the use of a semicolon following the closing curly bracket in a class definition. 
Back to Question 8 (p. 98) 

2.17.4.2 Answer 7 

class NameOfClass{} 
Back to Question 7 (p. 98) 

2.17.4.3 Answer 6 

False. A colon is not used in Java. Instead, a period is used in Java. 
Back to Question 6 (p. 97) 

2.17.4.4 Answer 5 

True. 
Back to Question 5 (p. 97) 

2.17.4.5 Answer 4 


static 
Back to Question 4 (p. 97) 
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2.17.4.6 Answer 3 


e (a) instance variables 
e (b) methods 


Back to Question 3 (p. 97) 


2.17.4.7 Answer 2 


Member functions and instance methods. 
Back to Question 2 (p. 97) 


2.17.4.8 Answer 1 


Instance variables and attributes. 
Back to Question 1 (p. 97) 


2.17.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0170r: Review: A little more information about classes 
e File: Jb0170r.htm 

e Published: 11/21/12 

e Revised: 12/04/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.18 Jb0180: Java OOP: The main method.” 


2.18.1 Table of Contents 


e Preface (p. 101) 
Viewing tip (p. 101) 


64This content is available online at <http://cnx.org/content /m45145/1.3/>. 
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x Images (p. 101) 


e The main method in Java (p. 101) 
e Miscellaneous (p. 103) 


2.18.2 Preface 


This module is part of a sub-collection of modules designed to help you learn to program computers. 
Every Java application requires a class containing a method named main . This module provides 
information on the main method. 


2.18.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images while you are reading about them. 


2.18.2.1.1 Images 


e Image 1 (p. 101) . The method signature according to Niemeyer and Peck. 
e Image 2 (p. 102) . The method signature according to Oracle. 
e Image 3 (p. 102) . Allowable signatures for the main method. 


2.18.3 The main method in Java 


There must be a main method in the controlling class in every Java application. 
The method signature 
The Java literature frequently refers to the signature of a method, or the method signature . 
Exploring Java by Patrick Niemeyer and Joshua Peck (O’Reilly) provides the definition of a method 
signature shown in Image 1 (p. 101) . 


Image 1 . The method signature according to Niemeyer and Peck. 


"A method signature is a collection of information about the method, as in a C prototype or a forward function declaratic 


Table 2.38 


Type 

Apparently in this definition, the authors are referring to the type of the method as distinguishing 
between static and non-static. (Other literature refers to the type of a function or method as being the 
return type which according to the above definition is a separate part of the signature.) 

Visibility 

Apparently also the use of the word visibility in the above definition refers to the use of public , 
private , etc. 

According to Oracle... 
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Oracle’s Java Tutorials © , on the other hand, describe the method signature as in Image 2 (p. 102) . 


Image 2 . The method signature according to Oracle. 


Definition: Two of the components of a method declaration comprise the method signature-the method’s name and the pé 


Table 2.39 


As you can see, the Oracle definition is more restrictive than the Niemeyer and Peck definition. 

Bottom line on method signature 

The method signature can probably be thought of as providing information about the programming 
interface to the method. In other words, it provides the information that you need to be able to call the 
method in your program code. 

Signature of main method 

The controlling class of every Java application must contain a main method having one of the signatures 
shown in Image 3 (p. 102) . 


Image 3 . Allowable signatures for the main method. 


public static void main(String[] args) 


public static void main(String args[]) 


Table 2.40 


(I prefer the first signature in Image 3 (p. 102) as being the most descriptive of an array of String 
references which is what is passed in as an argument.) 

public 

The keyword public indicates that the method can be called by any object. A future module will 
discuss the keywords public , private , and protected in more detail. 

static 

The keyword static indicates that the method is a class method, which can be called without the 
requirement to instantiate an object of the class. This is used by the JVM to launch the program by calling 
the main method of the class identified in the command to start the program. 

void 

The keyword void indicates that the method doesn’t return any value. 

args 

The formal parameter args is a reference to an array object of type String . The array elements 
contain references to String objects that encapsulate String representations of the arguments, if any, 
entered at the command line. 


®5http://docs.oracle.com/javase/tutorial/java/javaOO /methods.html 
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Note that the args parameter must be specified whether or not the user is required to enter command- 
line arguments and whether or not the code in the program actually makes use of the argument. Also note 
that the name can be any legal Java identifier. It doesn’t have to be args . It could be joe or sue, for 
example. 

The length property 

The parameter named args is a reference to an array object. Java array objects have a property named 

length , which specifies the number of elements in the array. 

The runtime system monitors for the entry of command-line arguments by the user and constructs the 
String array containing those arguments. 

Processing command-line arguments 

The args.length property can be used by the code in the program to determine the number of arguments 
actually entered by the user. 

Ifthe length property is not equal to zero, the first string in the array corresponds to the first argument 
entered on the command line. 

Command-line arguments along with strings and String arrays will be discussed in more detail in a 
future module. 


2.18.4 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0180: Java OOP: The main method. 
e File: Jb0180.htm 

e Originally published: 1997 

e Published at cnx.org: 11/17/12 

e Revised: 12/04/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.19 Jb0180r Review“ 


2.19.1 Table of Contents 


e Preface (p. 104) 
e Questions (p. 104) 


1 (p. 104) , 2 (p. 104) , 3 (p. 104) , 4 (p. 104) , 5 (p. 104) , 6 (p. 104) , 7 (p. 105) , 8 (p. 105) 


e Answers (p. 106) 
e Miscellaneous (p. 107) 


2.19.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0180: Java OOP: The main 
method ® . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.19.3 Questions 

2.19.3.1 Question 1 

Write the method signature for the main method in a Java application. 
Answer 1 (p. 107) 

2.19.3.2 Question 2 

Briefly explain the reason that the main method in a Java application is declared public . 
Answer 2 (p. 107) 

2.19.3.3 Question 3 

Explain the reason that the main method in a Java application must be declared static . 
Answer 3 (p. 107) 

2.19.3.4 Question 4 

Describe the purpose of the keyword void when used as the return type for the main method. 
Answer 4 (p. 107) 

2.19.3.5 Question 5 


True or false? If the Java application is not designed to use command-line arguments, it is not necessary to 
include a formal parameter for the main method. 
Answer 5 (p. 106) 


2.19.3.6 Question 6 


True or false? When using command-line arguments in Java, if the name of the string array is args , 
the args.length variable can be used by the code in the program to determine the number of arguments 
actually entered. 

Answer 6 (p. 106) 


®6This content is available online at <http://cnx.org/content /m45171/1.5/>. 
®“http://cnx.org/content /m45145 
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2.19.3.7 Question 7 


True or false? The first string in the array of command-line arguments contains the name of the Java 
application 
Answer 7 (p. 106) 


2.19.3.8 Question 8 


The controlling class of every Java application must contain a main method. Can other classes in the 
same application also have a main method? If not, why not? If so, why might you want to do that? 

Answer 8 (p. 106) 

What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None KEX] 


Display your nami 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


2.19.4 Answers 
2.19.4.1 Answer 8 


Any and all classes in a Java application can have a main method. Only the one in the controlling class 
for the program being executed is actually called. 

It is often desirable to provide a main method for a class that will not ultimately be the controlling 
class to allow the class to be tested in a stand-alone mode, independent of other classes. 

Back to Question 8 (p. 105) 


2.19.4.2 Answer 7 
False. Unlike C++, the first string in the array of command-line arguments in a Java application does not 
contain the name of the application. 
Back to Question 7 (p. 105) 
2.19.4.3 Answer 6 
True. 
Back to Question 6 (p. 104) 
2.19.4.4 Answer 5 


False. The main method in a Java program must always provide the formal argument list regardless of 
whether it is actually used in the program. 
Back to Question 5 (p. 104) 
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2.19.4.5 Answer 4 


The void keyword when used as the return type for any Java method indicates that the method does not 
return anything. 
Back to Question 4 (p. 104) 


2.19.4.6 Answer 3 


The keyword static indicates that the method is a class method which can be called without the 
requirement to instantiate an object of the class. This is used by the Java virtual machine to launch the 
program by calling the main method of the class identified in the command to start the program. 

Back to Question 3 (p. 104) 


2.19.4.7 Answer 2 


The keyword public indicates that the method can be called by any object. 
Back to Question 2 (p. 104) 


2.19.4.8 Answer 1 


public static void main(String[] args) 


Back to Question 1 (p. 104) 


2.19.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0180r Review: The main method 
e File: Jb0180r.htm 

e Published: 11/21/12 

e Revised: 12/04/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.20 Jb0190: Java OOP: Using the System and PrintStream Classes” 


2.20.1 Table of Contents 


e Preface (p. 108) 
Viewing tip (p. 108) 
x Listings (p. 108) 
Introduction (p. 108) 
Discussion (p. 108) 
A word about class variables (p. 110) 


Run the program (p. 111) 
Miscellaneous (p. 111) 


2.20.2 Preface 


This module takes a preliminary look at the complexity of OOP by examining some aspects of the System 
and PrintStream classes. 


2.20.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


2.20.2.1.1 Listings 


e Listing 1 (p. 109) . The program named hellol. 
e Listing 2 (p. 110) . Display the string "Hello World". 


2.20.3 Introduction 


This lesson introduces you to the use of the System and PrintStream classes in Java. This is our first 
introduction to the complexity that can accompany the OOP paradigm. It gets a little complicated, so 
you might need to pay special attention to the discussion. 


2.20.4 Discussion 


What does the main method do? 

The main method in the controlling class of a Java application controls the flow of the program. 

The main method can also access other classes along with the variables and methods of those classes 
and of objects instantiated from those classes. 

The hellol Application 

Listing 1 (p. 109) shows a simple Java application named hello1 

(By convention, class definitions should begin with an upper-case character. However, the original 

version of this module was written and published in 1997, before that convention was firmly established.) 


68 This content is available online at <http://cnx.org/content /m45148/1.3/>. 
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Listing 1 . The program named hellol. 


/*File hellol.java Copyright 1997, R.G.Baldwin 
BOSSA EEEE EEE EEEE EEEE EE EEEE EEE EEEE EEE EEE EE EEE EEEE EEEE EEA 
class hello1 { //define the controlling class 
//define main method 
public static void main(String[] args){ 
//display text string 
System.out.println("Hello World"); 
}//end main 
3//End hello1 class. No semicolon at end of Java class. 


Table 2.41 


Does this program Instantiate objects? 

This is a simple example that does not instantiate objects of any other class. 

Does this program access another class? 

However, it does access another class. It accesses the System class that is provided with the Java 
development kit. (The System class will be discussed in more detail in a future module.) 

The variable named out 

The variable named out , referred to in Listing 1 (p. 109) as System.out , is a class variable of 
the System class. (A class variable is a variable that is declared to be static.) 

Recall that a class variable can be accessed without a requirement to instantiate an object of the class. 
As is the case with all variables, the class variable must be of some specific type. 

Primitive variables vs. reference variables 

A class variable may be a primitive variable , which contains a primitive value, or it may bea reference 
variable , which contains a reference to an object. 

(I'll have more to say about the difference between primitive variables and reference variables in a future 
module.) 

The variable named out in this case is a reference variable , which refers to an object of another type. 

Accessing class variables 

You access class variables or class methods in Java by joining the name of the class to the name of the 
variable or method with a period. 


System.out 


accesses the class variable named out in the Java class named System 


The PrintStream class 

Another class that is provided with the Java development kit is the PrintStream class. The 
PrintStream class is in a package of classes that are used to provide stream input/output capability 
for Java. 

What does the out variable refer to? 

The out variable in the System class refers to (points to) an instance of the PrintStream class 
(a PrintStream object), which is automatically instantiated when the System class is loaded into the 
application. 

We will be discussing the PrintStream class along with a number of other classes in detail in a future 
module on input/output streams, so this is not intended to be an exhaustive discussion. 

The printlIn method 

The PrintStream class has an instance method named printIn , which causes its argument to be 
displayed on the standard output device when it is called. 
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(Typically, the standard output device is the command-line window. However, it is possible to redirect 
it to some other device.) 

Accessing an instance method 

The method named println can be accessed by joining a PrintStream object’s reference to the 
name of the method using a period. 

Thus, (assuming that the standard output device has not been redirected) , the statement shown in 
Listing 2 (p. 110) causes the string "Hello World" (without the quotation marks) to be displayed in the 
command-line window. 


Listing 2 . Display the string "Hello World". 


System. out .println("Hello World"); 


Table 2.42 


This statement calls the println method of an object instantiated from the PrintStream class, 
which is referred to (pointed to) by the variable named out , which isa class variable ofthe System 
class. 

Read the previous paragraph very carefully. As I indicated when I started this module, this is our first 
introduction to the complexity that can result from use of the OOP paradigm. (It can get even more 
complicated.) If this is not clear to you, go back over it and think about it until it becomes clear. 


2.20.5 A word about class variables 


How many instances of a class variable exist? 

The runtime system allocates a class variable only once no matter how many instances (objects) of the 
class are instantiated. 

All objects of the class share the same physical memory space for the class variable. 

If a method in one object changes the value stored in the class variable, it is changed insofar as all of the 
objects are concerned. (This is about as close to a global variable as you can get in Java.) 

Accessing a class variable 

You can use the name of the class to access class variables by joining the name of the class to the name 
of the variable using a period. 

You can also access a class variable by joining the name of a reference variable containing an object’s 
reference to the name of the variable using a period as the joining operator. 

Referencing object methods via class variables 

Class variables are either primitive variables or reference variables. (Primitive variables contain primitive 
values and reference variables contain references to objects.) 

A referenced object may provide methods to control the behavior of the object. In Listing 2 (p. 110) , 
we accessed the printlIn method of an object of the PrintStream class referred to by the class variable 
named out 

Instance variables and methods 

As a side note, in addition to class variables, Java provides instance variables and instance methods . 
Every instance of a class has its own set of instance variables. You can only access instance variables and 
instance methods through an object of the class. 
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2.20.6 Run the program 


I encourage you to copy the code from Listing 1 (p. 109) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


2.20.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0190: Java OOP: Using the System and PrintStream Classes 
e File: Jb0190.htm 

e Originally published: 1997 

e Published at cnx.org: 11/18/12 

e Revised: 12/04/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.21 Jb0190r: Review” 


2.21.1 Table of Contents 


e Preface (p. 112) 
e Questions (p. 112) 


1 (p. 112) , 2 (p. 112) , 3 (p. 112) , 4 (p. 112) , 5 (p. 112) , 6 (p. 113) , 7 (p. 113) , 8 (p. 113) , 
9 (p. 113) , 10 (p. 113) , 11 (p. 113) , 12 (p. 116) , 13 (p. 113) , 14 (p. 113) , 15 (p. 114) , 16 
(p. 114) , 17 (p. 114) , 18 (p. 114) 


e Answers (p. 116) 
e Miscellaneous (p. 118) 


2.21.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0190: Java OOP: Using 
the System and PrintStream Classes © . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.21.3 Questions 
2.21.3.1 Question 1 


True or false? The main method in the controlling class of a Java application controls the flow of the 
program. 
Answer 1 (p. 118) 


2.21.3.2 Question 2 


True or false? The main method cannot access the variables and methods of objects instantiated from 
other classes. 
Answer 2 (p. 117) 


2.21.3.3 Question 3 


True or false? The main method must instantiate objects of other classes in order for the program to 
execute. 
Answer 3 (p. 117) 


2.21.3.4 Question 4 


True or false? In order to be useful, the System class must be used to instantiate objects in a Java 
application. 
Answer 4 (p. 117) 


2.21.3.5 Question 5 


True or false? Class variables such as the out variable of the System class must be of some specific 


type. 
Answer 5 (p. 117) 


69This content is available online at <http://cnx.org/content /m45175/1.6/>. 
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2.21.3.6 Question 6 


True or false? Class variables must be of a primitive type such as int or float 
Answer 6 (p. 117) 


2.21.3.7 Question 7 


True or false? The out variable in the System class is of a primitive type. 
Answer 7 (p. 117) 


2.21.3.8 Question 8 


What does the following code fragment access? 


System. out 


Answer 8 (p. 117) 


2.21.3.9 Question 9 
True or false? An object of type PrintStream is automatically instantiated when the System class is 
loaded into an application. 
Answer 9 (p. 117) 
2.21.3.10 Question 10 
True or false? The out variable in the System class refers to an instance of what class? 
Answer 10 (p. 117) 
2.21.3.11 Question 11 
True or false? The println method is an instance method of what class? 
Answer 11 (p. 116) 
2.21.3.12 Question 12 
What is the primary behavior of the printIn method? 
Answer 12 (p. 116) 
2.21.3.13 Question 13 
How can the println method be accessed? 
Answer 13 (p. 116) 
2.21.3.14 Question 14 


Assuming that the standard output device has not been redirected, write a code fragment that will cause 
your name to be displayed on the screen. 
Answer 14 (p. 116) 
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2.21.3.15 Question 15 


Explain how your code fragment in Answer 14 (p. 116) produces the desired result. 
Answer 15 (p. 116) 


2.21.3.16 Question 16 


If you have a class named MyClass that has a class variable named myClassVariable that requires 
four bytes of memory and you instantiate ten objects of type MyClass , how much total memory will 
be allocated to contain the allocated variables (assume that the class definition contains no other class, 
instance, or local variables) . 

Answer 16 (p. 116) 


2.21.3.17 Question 17 


How many actual instances of the variable named out are allocated in memory by the following code 
fragment? 


System.out.println("Dick Baldwin"); 


Answer 17 (p. 116) 


2.21.3.18 Question 18 


If you have a class named MyClass that has an instance variable named myInstanceVariable that 
requires four bytes of memory and you instantiate ten objects of type MyClass , how much total memory 
will be allocated to contain the allocated variables (assume that the class definition contains no other class, 
instance, or local variables) . 

Answer 18 (p. 116) 

What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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2.21.4 Answers 
2.21.4.1 Answer 18 
Every instance of a class has its own set of instance variables. You can only access instance variables and 
instance methods through an object of the class. In this case, forty bytes of memory would be required to 
contain the instance variables of the ten objects. 
Back to Question 18 (p. 114) 
2.21.4.2 Answer 17 
Only one, because out is a class variable of the System class. 
Back to Question 17 (p. 114) 
2.21.4.3 Answer 16 


The runtime system allocates a class variable only once no matter how many instances of the class are 
instantiated. Thus, all objects of the class share the same physical memory space for the class variable, and 
in this case, only four bytes of memory will be allocated to contain the allocated variables. 

Back to Question 16 (p. 114) 
2.21.4.4 Answer 15 


The statement in Answer 14 (p. 116) calls the println method belonging to an object of the PrintStream 
class, which is referenced (pointed to) by the out variable, which is a class variable of the System 
class. 

Back to Question 15 (p. 114) 


2.21.4.5 Answer 14 


System.out.println("Dick Baldwin"); 


Back to Question 14 (p. 113) 


2.21.4.6 Answer 13 


The println method can be accessed by joining the name of a variable that references a PrintStream 
object to the name of the printIn method using a period. 

Back to Question 13 (p. 113) 
2.21.4.7 Answer 12 


The println method causes its argument to be displayed on the standard output device. (The standard 

output device is the screen by default, but can be redirected by the user at the operating system level.) 
Back to Question 12 (p. 113) 

2.21.4.8 Answer 11 


The println method is an instance method of the PrintStream class. 
Back to Question 11 (p. 113) 
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2.21.4.9 Answer 10 


The out variable inthe System class refers to an instance of the PrintStream class (a PrintStream 
object), which is automatically instantiated when the System class is loaded into the application. 
Back to Question 10 (p. 113) 


2.21.4.10 Answer 9 

True. 
Back to Question 9 (p. 113) 

2.21.4.11 Answer 8 

The code fragment accesses the contents of the class variable named out in the class named System . 
Back to Question 8 (p. 113) 

2.21.4.12 Answer 7 


False. the variable named out defined inthe System class is a reference variable that points to an object. 
of another type. 
Back to Question 7 (p. 113) 


2.21.4.13 Answer 6 


False. A class variable can be a primitive type, or it can be a reference variable that points to another 
object. 
Back to Question 6 (p. 113) 


2.21.4.14 Answer 5 


True. 
Back to Question 5 (p. 112) 


2.21.4.15 Answer 4 


False. The System class has several class variables (including out and in ) that are useful 
without the requirement to instantiate an object of the System class. 
Back to Question 4 (p. 112) 


2.21.4.16 Answer 3 


False. While it is probably true that the main method must instantiate objects of other classes in order 
to accomplish much that is of value, this is not a requirement. The main method in the "Hello World" 
program of this module *! does not instantiate objects of any class at. all. 

Back to Question 3 (p. 112) 


2.21.4.17 Answer 2 


False. The main method can access the variables and methods of objects instantiated from other classes. 
Otherwise, the flow of the program would be stuck within the main method itself and wouldn’t be very 
useful. 

Back to Question 2 (p. 112) 


“Vhttp://cnx.org/content /m45148 /latest / 
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2.21.4.18 Answer 1 


True. 
Back to Question 1 (p. 112) 


2.21.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0190r: Review: Using the System and PrintStream Classes 
e File: Jb0190r.htm 

e Published: 11/22/12 

e Revised: 12/04/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.22 Jb0200: Java OOP: Variables” 


2.22.1 Table of Contents 


e Preface (p. 119) 
Viewing tip (p. 119) 
x Images (p. 119) 
x Listings (p. 119) 
e Introduction (p. 119) 
e Sample program named simplel (p. 120) 
Discussion of the simplel program (p. 121) 
e Variables (p. 121) 
Primitive types (p. 123) 
x Object-oriented wrappers for primitive types (p. 124) 
Reference types (p. 125) 
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Variable names (p. 126) 
Scope (p. 127) 
Initialization of variables (p. 130) 
Run the programs (p. 130) 
Miscellaneous (p. 130) 


2.22.2 Preface 


Earlier modules have touched briefly on the topic of variables. This module discusses Java variables in depth. 


2.22.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


2.22.2.1.1 Images 


Image 1 (p. 121) . Screen output from the program named simplel. 
Image 2 (p ) . Information about the primitive types in Java. 
Image 3 (p. 127) . Rules for naming variables. 

Image 4 (p ) . Rules for legal identifiers. 

Image 5 (p ) . Scope categories. 


2.22.2.1.2 Listings 


e Listing 1 (p. 120) . Source code for the program named simplel. 

e Listing 2 (p. 121) . Declaring and initializing two variables named ch1 and ch2. 
e Listing 3 (p. 122) . Display the character. 

e Listing 4 (p. 122) . Beginning of a while loop. 

e Listing 5 (p. 123) . Beginning of the main method. 

e Listing 6 (p. 125) . The program named wrapper1. 

e Listing 7 (p. 126) . Aspects of using a wrapper class. 

e Listing 8 (p. 129) . The program named member1. 

e Listing 9 (p. 130) . Initialization of variables. 


2.22.3 Introduction 


The first step 
The first step in learning to use a new programming language is usually to learn the foundation concepts 
such as 


variables 

types 

expressions 
flow-of-control, etc. 


This and several future modules concentrate on that foundation. 

A sample program 

The module begins with a sample Java program named simplel . The user is asked to enter some text 
and to terminate with the # character. 
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(This program contains a lot of code that you are not yet prepared to understand. For the time being, 
just concentrate on the use of variables in the program. You will learn about the other aspects of the program 


in future modules.) 


The program loops, saving individual characters until encountering the # character. When it encounters 
the # character, it terminates and displays the character entered immediately prior to the # character. 


2.22.4 Sample program named simplel 


A complete listing of the program named simplel1 is provided in Listing 1 (p. 120) . Discussions of selected 


portions of the program are presented later in the module. 


Listing 1 . Source code for the program named simple1. 


/*File simple1.java Copyright 1997, R.G.Baldwin 

This Java application reads bytes from the keyboard until 
encountering the integer representation of ’#’. At 

the end of each iteration, it saves the byte received and 
goes back to get the next byte. 


When the ’#’ is entered, the program terminates input and 
displays the character which was entered before the #. 
3K aK K 3K 3K 3K 3k ak ak ak ak aK aK I 3K ak aK aK ak aK 3K 3K 3K 3K 3K K I I I I I I I I 3K I 3K 3K 3K a a a K A ÞK ÞK ÞK 34 24 24 / 


class simple1 { //define the controlling class 


//It is necessary to declare that this method 

// can throw the exception shown below (or catch it). 

public static void main(String[] args) //define main 
throws java.io.I0Exception { 


//It is necessary to initialize ch2 to avoid a compiler 
// error (possibly unitialized variable) at the 

// statement which displays ch2. 

int chi, ch2 = ’0’; 


System. out .print1n( 
"Enter some text, terminate with #"); 


//Get and save individual bytes 
while( (chi = System.in.read() ) != ’#?) 
ch2 = chi; 


//Display the character immediately before the # 
System. out .print1n( 
"The char before the # was " + (char) ch2); 
}//end main 
}//End simple1 class. 


Table 2.43 
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Program output 
The output produced by compiling and running this program is shown in Image 1 (p. 121) . The second 
line of text in Image 1 (p. 121) ending with the # character was typed by the user. 


Image 1 . Screen output from the program named simple1. 


Enter some text, terminate with # 
abcde# 
The char before the # was e 


Table 2.44 


2.22.4.1 Discussion of the simplel program 


Purpose 

I will use the program shown in Listing 1 (p. 120) to discuss several important aspects of the structure 
of a Java program. I will also provide two additional sample programs that illustrate specific points not 
illustrated in the above program later in this module. 


2.22.5 Variables 


What is a variable? Variables are used in a Java program to contain data that changes during 
the execution of the program. 


Declaring a variable 

To use a variable, you must first notify the compiler of the name and the type of the variable. This 
is known as declaring a variable 

The syntax for declaring a variable is to precede the name of the variable with the name of the type 
of the variable as shown in Listing 2 (p. 121) . It is also possible (but not required) to initialize a variable 
in Java when it is declared as shown in Listing 2 (p. 121) . 


Listing 2 . Declaring and initializing two variables named chi and ch2. 


int chi, ch2 = ’0’; 


Table 2.45 


The statement in Listing 2 (p. 121) declares two variables of type int , initializing the second variable 
(ch2) to the value of the zero character (0). (Note that I didn’t say initialized to the value zero.) 


Difference between zero and ’0’ - Unicode characters The value of the zero character is 
not the same as the numeric value of zero, but hopefully you already knew that. 


As an aside, characters in Java are 16-bit entities called Unicode characters instead of 8-bit entities 
as is the case with many programming languages. The purpose is to provide many more possible 
characters including characters used in alphabets other than the one used in the United States. 
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Initialization of the variable 

Initialization of the variable named ch2 in this case was necessary to prevent a compiler error. Without 
initialization of this variable, the compiler would recognize and balk at the possibility that an attempt might 
be made to execute the statement shown in Listing 3 (p. 122) with a variable named ch2 that had not 
been initialized 


Listing 3 . Display the character. 


System.out.println("The char before the # was " 
+ (char) ch2) ; 


Table 2.46 


Error checking by the compiler 

The strong error-checking capability of the Java compiler would refuse to compile this program until that 
possibility was eliminated by initializing the variable. 

Using the cast operator 

You should also note that the contents of the variable ch2 is being cast as type char in Listing 3 
(p. 122) . 

(A cast is used to change the type of something to a different type.) 

Recall that ch2 is a variable of type int , containing the numeric value that represents a character. 

We want to display the character that the numeric value represents and not the numeric value itself. 
Therefore, we must cast it (purposely change its type for the evaluation of the expression) . Otherwise, 
we would not see the character on the screen. Rather, we would see the numeric value that represents that 
character. 


Initialization of instance variables and local variables: As another aside, member 
variables in Java are automatically initialized to zero or the equivalent of zero. However, local 
variables , of which ch2 is an example, are not automatically initialized. 


Why declare the variables as type int? 
It was necessary to declare these variables as type int becausethe statement in Listing 4 (p. 122) (more 
specifically, the call to the System.in.read method) returns a value of type int 


Listing 4 . Beginning of a while loop. 


while( (chi = System.in.read() ) != °?#?) ch2 = chi; 


Table 2.47 


Java provides very strict type checking and generally refuses to compile statements with type mismatches. 

(There is a lot of complicated code in Listing 4 (p. 122) that I haven’t previously explained. I will 
explain that code later in this and future modules.) 

Another variable declaration 

The program in Listing 1 (p. 120) also makes another variable declaration shown by the statement in 
Listing 5 (p. 123) . 
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Listing 5 . Beginning of the main method. 


public static void main(String[] args) //define main method 


Table 2.48 


An array of String references 

In Listing 5 (p. 123) , the formal argument list of the main method declares an argument named args 
(first cousin to a variable) as a reference to an array object of type String 

Capturing command-line arguments in Java 

As you learned in an earlier module, this is the feature of Java that is used to capture arguments entered 
on the command line, and is required whether arguments are entered or not. In this case, no command-line 
arguments were entered, and the variable named args is simply ignored by the remainder of the program. 

The purpose of the type of a variable 


All variables must have a declared type The type determines the set of values that can be 
stored in the variable and the operations that can be performed on the variable. 


For example, the int type can only contain whole numbers (integers) . A whole host of operations are 
possible with an int variable including add, subtract, divide, etc. 

Signed vs. unsigned variables 

Unlike C++, all variables of type int in Java contain signed values. In fact, with the exception of type 
char , all primitive numeric types in Java contain signed values. 

Platform independence 

At this point in the history of Java, a variable of a specified type is represented exactly the same way 
regardless of the platform on which the application or applet is being executed. 

This is one of the features that causes compiled Java programs to be platform-independent. 


2.22.5.1 Primitive types 


In Java, there are two major categories of data types: 


e primitive types 
e reference (or object) types. 


Primitive variables contain a single value of one of the eight primitive types shown in Listing 2 (p. 121) . 
Reference variables contain references to objects (or null, meaning that they don’t refer to anything) . 
The eight primitive types in Java? 
The table in Image 2 (p. 124) lists all of the primitive types in Java along with their size and format, 
and a brief description of each. 


Image 2 . Information about the primitive types in Java. 


continued on next page 
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Type Size/Format Description 
byte 8-bit two’s complement Byte-length integer 
short 16-bit two’s complement Short integer 
int 32-bit two’s complement Integer 
long 64-bit two’s complement Long Integer 
float 32-bit IEEE 754 format Single-precision 
floating point 
double 64-bit IEEE 754 format Double-precision 
floating point 
char 16-bit Unicode character Single character 
boolean true or false True or False 
Table 2.49 


The char type 

The char type is a 16-bit Unicode character value that has the possibility of representing more than 
65,000 different characters. 

Evaluating a primitive variable 

A reference to the name of a primitive variable in program code evaluates to the value stored in the 
variable. In other words, when you call out the name of a primitive variable in your code, what you get back 
is the value stored in the variable. 


2.22.5.1.1 Object-oriented wrappers for primitive types 


Primitive types are not objects 

Primitive data types in Java (int, double, etc.) are not objects. This has some ramifications as to how 
they can be used (passing to methods, returning from methods, etc.) 

The generic Object type 

Later on in this course of study, you will learn that much of the power of Java derives from the ability 
to deal with objects of any type as the generic type Object . For example, several of the standard classes 
in the API (such as the powerful Vector class) are designed to work only with objects of type Object 

(Note that this document was originally published prior to the introduction of generics in Java. The 
introduction of generics makes it possible to cause the Vector class to deal with objects of types other 
than Object . However, that doesn’t eliminate the need for wrapper classes.) 

Converting primitives to objects 

Because it is sometimes necessary to deal with a primitive value as though it were an object, Java provides 
wrapper classes that support object-oriented functionality for Java’s primitive data types. 

The Double wrapper class 

This is illustrated in the program shown in Listing 6 (p. 125) that deals with a double type as an 
object of the class Double 

(Remember, Java is a case-sensitive language. Note the difference between the primitive double type 
and the class named Double .) 
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Listing 6 . The program named wrapper1. 


/*File wrapper1.java Copyright 1997, R.G.Baldwin 
This Java application illustrates the use of wrappers 
for the primitive types. 


This program produces the following output: 


My wrapped double is 5.5 
My primitive double is 10.5 


FESO OIA IIIA I IOI II IG I I I I I A I aK ak ak ok a 2k a / 
class wrapper! { //define the controlling class 
public static void main(String[] args){//define main 


//The following is the declaration and instantiation of 
// a Double object, or a double value wrapped in an 

// object. Note the use of the upper-case D. 

Double myWrappedData = new Double(5.5); 


//The following is the declaration and initialization 
// of a primitive double variable. Note the use of the 
// lower-case d. 

double myPrimitiveData = 10.5; 


//Note the call to the doubleValue() method to obtain 
// the value of the double wrapped in the Double 
// object. 
System. out. print1n( 
"My wrapped double is " + myWrappedData.doubleValue()); 
System. out .print1n( 
"My primitive double is " + myPrimitiveData ); 
}//end main 
}//End wrapper1 class. 


Table 2.50 


The operation of this program is explained in the comments, and the output from the program is shown 
in the comments at the beginning. 


2.22.5.2 Reference types 


Once again, what is a primitive type? 
Primitive types are types where the name of the variable evaluates to the value stored in the variable. 
What is a reference type? 
Reference types in Java are types where the name of the variable evaluates to the address of the location 
in memory where the object referenced by the variable is stored. 


The above statement may not really be true? However, we can think of it that way. 
Depending on the particular JVM in use, the reference variable may refer to a table in memory 
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where the address of the object is stored. In that case the second level of indirection is handled 
behind the scenes and we don’t have to worry about. it. 


Why would a JVM elect to implement another level of indirection? Wouldn’t that make programs 
run more slowly? 


One reason has to do with the need to compact memory when it becomes highly fragmented. If the 
reference variables all refer directly to memory locations containing the objects, there may be many 
reference variables that refer to the same object. If that object is moved for compaction purposes, 
then the values stored in every one of those reference variables would have to be modified. 


However, if those reference variables all refer to a table that has one entry that specifies where the 
object is stored, then when the object is moved, only the value of that one entry in the table must 
be modified. 


Fortunately, that all takes place behind the scenes and we as programmers don’t need to worry 
about it. 


Primitive vs. reference variables 

We will discuss this in more detail in a future module. For now, suffice it to say that in Java, a variable 
is either a primitive type or a reference type, and cannot be both. 

Declaring, instantiating, initializing, and manipulating a reference variable 

The fragment of code shown in Listing 7 (p. 126) , (which was taken from the program shown in 
Listing 6 (p. 125) that deals with wrappers) does the following. It 


declares, 

instantiates, 

initializes, and 

manipulates a variable of a reference type named my WrappedData 


In Listing 7 (p. 126) , the variable named myWrappedData contains a reference to an object of type 
Double 


Listing 7 . Aspects of using a wrapper class. 


Double myWrappedData = new Double(5.5); 
//Code deleted for brevity 


//Note the use of the doubleValue() method to obtain the 
// value of the double wrapped in the Double object. 
System.out.printin 

("My wrapped double is " + myWrappedData.doubleValue() ); 


Table 2.51 


2.22.5.3 Variable names 


The rules for naming variables are shown in Image 3 (p. 127) . 
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Image 3 . Rules for naming variables. 


e Must be a legal Java identifier (see below) consisting of a series of Unicode characters. Unicode 
characters are stored in sixteen bits, allowing for a very large number of different characters. A 
subset of the possible character values matches the 127 possible characters in the ASCII character 
set, and the extended 8-bit character set, ISO-Latin-1 (The Java Handbook, page 60, by Patrick 
Naughton). 

e Must not be the same as a Java keyword and must not be true or false. 

e Must not be the same as another variable whose declaration appears in the same scope. 


Table 2.52 


The rules for legal identifiers are shown in Image 4 (p. 127) . 


Image 4 . Rules for legal identifiers. 


In Java, a legal identifier is a sequence of Unicode letters and digits of unlimited length. 

The first character must be a letter. 

All subsequent characters must be letters or numerals from any alphabet that Unicode supports. 
In addition, the underscore character (_) and the dollar sign ($) are considered letters and may be 
used as any character including the first one. 


Table 2.53 


2.22.6 Scope 


What is the scope of a Java variable? 
The scope of a Java variable is defined by the block of code within which the variable is accessible. 
(Briefly, a block of code consists of none, one, or more statements enclosed by a pair of matching curly 
brackets.) 

The scope also determines when the variable is created (memory set aside to contain the data stored in 
the variable) and when it possibly becomes a candidate for destruction (memory returned to the operating 
system for recycling and re-use) . 

Scope categories 
The scope of a variable places it in one of the four categories shown in Image 5 (p. 127) . 


Image 5 . Scope categories. 


continued on next page 
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member variable 

local variable 

method parameter 
exception handler parameter 


Table 2.54 


Member variable 

A member variable is a member of a class (class variable) or a member of an object instantiated from 
that class (instance variable) . It must be declared within a class, but not within the body of a method or 
constructor of the class. 

Local variable 

A local variable is a variable declared within the body of a method or constructor or within a block of 
code contained within the body of a method or constructor. 

Method parameters 

Method parameters are the formal arguments of a method. Method parameters are used to pass values 
into and out of methods. The scope of a method parameter is the entire method for which it is a parameter. 

Exception handler parameters 

Exception handler parameters are arguments to exception handlers. Exception handlers will be discussed 
in a future module. 

Illustrating different types of variables in Java 

The Java program shown in Listing 8 (p. 129) illustrates 


e member variables (class and instance) , 
e local variables, and 
e method parameters. 


An illustration of exception handler parameters will be deferred until exception handlers are discussed in a 
future module. 
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Listing 8 . The program named member1. 


/*File member1.java Copyright 1997, R.G.Baldwin 
Illustrates class variables, instance 
variables, local variables, and method parameters. 


Output from this program is: 


Class variable is 5 
Instance variable is 6 
Method parameter is 7 
Local variable is 8 


FACOG OO ICI CII 2K 2K 2K 2K a K K a ÞK ÞK ak ak ak / 
class member1 { //define the controlling class 

//declare and initialize class variable 

static int classVariable = 5; 

//declare and initialize instance variable 

int instanceVariable = 6; 


public static void main(String[] args){ //main method 
System.out.println("Class variable is " 
+ classVariable) ; 


//Instantiate an object of the class to allow for 
// access to instance variable and method. 
member1 obj = new member1(); 
System.out.println("Instance variable is " 

+ obj.instanceVariable) ; 
obj .myMethod(7); //call the method 


//declare and intitialize a local variable 
int localVariable = 8; 
System.out.println("Local variable is " 
+ localVariable) ; 


}//end main 


void myMethod(int methodParameter) { 
System.out.println("Method parameter is " 
+ methodParameter) ; 
}//end myMethod 
}//End member1 class. 


Table 2.55 


Declaration of local variables 
In Java, local variables are declared within the body of a method or within a block of code contained 
within the body of a method. 
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Scope of local variables 
The scope of a local variable extends from the point at which it is declared to the end of the block of 
code in which it is declared. 
What is a "block" of code? 
A block of code is defined by enclosing it within curly brackets as in { ... }. 
Therefore, the scope of a local variable can be the entire method, or can reduced by declaring it within 
a block of code within the method. 


Special case, scope within a for loop Java treats the scope of a variable declared within the 
initialization clause of a for statement to be limited to the total extent of the for statement. 


A future module will explain what is meant by a for statement or a for loop. 


2.22.7 Initialization of variables 


Initializing primitive local variables 
Local variables of primitive types can be initialized when they are declared using statements such the 
one shown in Listing 9 (p. 130) . 


Listing 9 . Initialization of variables. 


int MyVar, UrVar = 6, HisVar; 


Table 2.56 


Initializing member variables 

Member variables can also be initialized when they are declared. 

In both cases, the type of the value used to initialize the variable must match the type of the variable. 

Initializing method parameters and exception handler parameters 

Method parameters and exception handler parameters are initialized by the values passed to the method 
or exception handler by the calling program. 


2.22.8 Run the programs 


I encourage you to copy the code from Listing 1 (p. 120) , Listing 6 (p. 125) , and Listing 8 (p. 129) . 
Compile the code and execute it. Experiment with the code, making changes, and observing the results of 
your changes. Make certain that you can explain why your changes behave as they do. 


2.22.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0200: Java OOP: Variables 
e File: Jb0200.htm 

e Originally published: 1997 

e Published at cnx.org: 11/18/12 

e Revised:12/04/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.23 Jb0200r: Review” 


2.23.1 Table of Contents 
e Preface (p. 132) 
e Questions (p. 132) 


1 (p. 132) , 2 (p. 132) , 3 (p. 132) , 4 (p. 132) , 5 (p. 132) , 6 (p. 133) , 7 (p. 133) , 8 (p. 133) , 
9 (p. 133) , 10 (p. 133) , 11 (p. 133) , 12 (p. 142) , 13 (p. 133) , 14 (p. 133) , 15 (p. 133) , 16 
(p. 134) , 17 (p. 134) , 18 (p. 134) , 19 (p. 134) , 20 (p. 134) , 21 (p. 134) , 22 (p. 134) , 23 (p. 
134) , 24 (p. 134) , 25 (p. 134) , 26 (p. 135) , 27 (p. 135) , 28 (p. 135) , 29 (p. 135) , 30 (p. 135) 
, 31 (p. 135) , 32 (p. 135) , 33 (p. 135) , 34 (p. 135) , 35 (p. 135) , 36 (p. 136) , 37 (p. 136) , 38 
(p. 136) , 39 (p. 136) 

e Listings (p. 136) 

e Answers (p. 138) 

e Miscellaneous (p. 144) 


2.23.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0200: Java OOP: Variables 
74 


The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.23.3 Questions 
2.23.3.1 Question 1 


Write a Java application that reads characters from the keyboard until encountering the # character. Echo 

each character to the screen as it is read. Terminate the program when the user enters the # character. 
Answer 1 (p. 143) 

2.23.3.2 Question 2 


What is the common name for the Java program element that is used to contain data that changes during 
the execution of the program? 
Answer 2 (p. 143) 
2.23.3.3 Question 3 
What must you do to make a variable available for use in a Java program? 
Answer 3 (p. 143) 
2.23.3.4 Question 4 
True or false? In Java, you are required to initialize the value of all variables when they are declared. 
Answer 4 (p. 143) 
2.23.3.5 Question 5 


Show the proper syntax for declaring two variables and initializing one of them using a single Java statement. 
Answer 5 (p. 142) 


“3This content is available online at <http://cnx.org/content/m45173/1.7/>. 
“4http://cnx.org/content /m45150/latest / 
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2.23.3.6 Question 6 
True or false? The Java compiler will accept statements with type mismatches provided that a suitable type 
conversion can be implemented by the compiler at compile time. 
Answer 6 (p. 142) 
2.23.3.7 Question 7 


Show the proper syntax for the declaration of a variable of type String]] in the argument list of the main 
method of a Java program and explain its purpose. 
Answer 7 (p. 142) 
2.23.3.8 Question 8 
Describe the purpose of the type definition in Java. 
Answer 8 (p. 142) 
2.23.3.9 Question 9 
True or false? Variables of type int can contain either signed or unsigned values. 
Answer 9 (p. 142) 
2.23.3.10 Question 10 
What is the important characteristic of type definitions in Java that strongly supports the concept of 
platform independence of compiled Java programs? 
Answer 10 (p. 142) 
2.23.3.11 Question 11 
What are the two major categories of types in Java? 
Answer 11 (p. 142) 
2.23.3.12 Question 12 
What is the maximum number of values that can be stored in a variable of a primitive type in Java? 
Answer 12 (p. 142) 
2.23.3.13 Question 13 
List the primitive types in Java. 
Answer 13 (p. 141) 
2.23.3.14 Question 14 
True or false? Java stores variables of type char according to the 8-bit extended ASCII table. 
Answer 14 (p. 141) 
2.23.3.15 Question 15 


True or false? In Java, the name of a primitive variable evaluates to the value stored in the variable. 
Answer 15 (p. 141) 
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2.23.3.16 Question 16 
True or false? Variables of primitive data types in Java are true objects. 
Answer 16 (p. 141) 
2.23.3.17 Question 17 
Why do we care that variables of primitive types are not true objects? 
Answer 17 (p. 141) 
2.23.3.18 Question 18 
What is the name of the mechanism commonly used to convert variables of primitive types to true objects? 
Answer 18 (p. 141) 
2.23.3.19 Question 19 
How can you tell the difference between a primitive type and a wrapper for the primitive type when the 
two are spelled the same? 
Answer 19 (p. 141) 
2.23.3.20 Question 20 
Show the proper syntax for declaring a variable of type double and initializing its value to 5.5. 
Answer 20 (p. 141) 
2.23.3.21 Question 21 
Show the proper syntax for declaring a variable of type Double and initializing its value to 5.5. 
Answer 21 (p. 140) 
2.23.3.22 Question 22 
Show the proper syntax for extracting the value from a variable of type Double 
Answer 22 (p. 140) 
2.23.3.23 Question 23 
True or false? In Java, the name of a reference variable evaluates to the address of the location in memory 
where the variable is stored. 
Answer 23 (p. 140) 
2.23.3.24 Question 24 
What is a legal identifier in Java? 
Answer 24 (p. 140) 
2.23.3.25 Question 25 


What are the rules for variable names in Java? 
Answer 25 (p. 139) 
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2.23.3.26 Question 26 
What is meant by the scope of a Java variable? 
Answer 26 (p. 139) 
2.23.3.27 Question 27 
What are the four possible scope categories for a Java variable? 
Answer 27 (p. 139) 
2.23.3.28 Question 28 
What is a member variable? 
Answer 28 (p. 139) 
2.23.3.29 Question 29 
Where are local variables declared in Java? 
Answer 29 (p. 139) 
2.23.3.30 Question 30 
What is the scope of a local variable in Java? 
Answer 30 (p. 139) 
2.23.3.31 Question 31 
What defines a block of code in Java? 
Answer 31 (p. 139) 
2.23.3.32 Question 32 
What is the scope of a variable that is declared within a block of code that is defined within a method and 
which is a subset of the statements that make up the method? 
Answer 32 (p. 138) 
2.23.3.33 Question 33 
What is the scope of a variable declared within the initialization clause of a for statement in Java? Provide 
an example code fragment. 
Answer 33 (p. 138) 
2.23.3.34 Question 34 
What are method parameters and what are they used for? 
Answer 34 (p. 138) 
2.23.3.35 Question 35 


What is the scope of a method parameter ? 
Answer 35 (p. 138) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


136 CHAPTER 2. PROGRAMMING FUNDAMENTALS 


2.23.3.36 Question 36 

What are exception handler parameters ? 
Answer 36 (p. 138) 

2.23.3.37 Question 37 


Write a Java application that illustrates member variables (class and instance) , local variables, and method 
parameters. 
Answer 37 (p. 138) 


2.23.3.38 Question 38 
True or false? Member variables in a Java class can be initialized when the class is defined. 
Answer 38 (p. 138) 


2.23.3.39 Question 39 


How are method parameters initialized in Java? 
Answer 39 (p. 138) 


2.23.4 Listings 


e Listing 1 (p. 140) . Listing for Answer 22. 
e Listing 2 (p. 143) . Listing for Answer 1. 


What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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2.23.5 Answers 

2.23.5.1 Answer 39 

Method parameters are initialized by the values passed to the method. 
Back to Question 39 (p. 136) 

2.23.5.2 Answer 38 

True. 
Back to Question 38 (p. 136) 

2.23.5.3 Answer 37 

See the application named member1 in this module ® for an example of such an application. 
Back to Question 37 (p. 136) 

2.23.5.4 Answer 36 


Exception handler parameters are arguments to exception handlers, which will be discussed in a future 
module. 
Back to Question 36 (p. 136) 


2.23.5.5 Answer 35 
The scope of a method parameter is the entire method for which it is a parameter. 
Back to Question 35 (p. 135) 


2.23.5.6 Answer 34 


Method parameters are the formal arguments of a method. Method parameters are used to pass values 
into and out of methods. 
Back to Question 34 (p. 135) 


2.23.5.7 Answer 33 


Java treats the scope of a variable declared within the initialization clause of a for statement to be limited 
to the total extent of the for statement. A sample code fragment follows where cnt is the variable being 
discussed: 


for(int cnt = 0; cnt < max; cnt++){ 
//do something 
}//end of 


Back to Question 33 (p. 135) 


2.23.5.8 Answer 32 


In Java, the scope can be reduced by placing it within a block of code within the method. The scope 
extends from the point at which it is declared to the end of the block of code in which it is declared. 
Back to Question 32 (p. 135) 


“http://cnx.org/content /m45150/latest/#Listing 8 
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2.23.5.9 Answer 31 


A block of code is defined by enclosing it within curly brackets as shown below 


{.. } 


Back to Question 31 (p. 135) 


2.23.5.10 Answer 30 


The scope of a local variable extends from the point at which it is declared to the end of the block of code 
in which it is declared. 
Back to Question 30 (p. 135) 


2.23.5.11 Answer 29 


In Java, local variables are declared within the body of a method or constructor, or within a block of code 
contained within the body of a method or constructor. 
Back to Question 29 (p. 135) 


2.23.5.12 Answer 28 


A member variable is a member of a class ( class variable) or a member of an object instantiated from 
that class ( instance variable). It must be declared within a class, but not within the body of a method or 
constructor of the class. 

Back to Question 28 (p. 135) 


2.23.5.13 Answer 27 


The scope of a variable places it in one of the following four categories: 


member variable 

local variable 

method parameter 
exception handler parameter 


Back to Question 27 (p. 135) 


2.23.5.14 Answer 26 


The scope of a Java variable is the block of code within which the variable is accessible. 
Back to Question 26 (p. 135) 


2.23.5.15 Answer 25 
The rules for Java variable names are as follows: 


e Must be a legal Java identifier consisting of a series of Unicode characters. 
e Must not be the same as a Java keyword and must not be true or false. 
e Must not be the same as another variable whose declaration appears in the same scope. 


Back to Question 25 (p. 134) 
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2.23.5.16 Answer 24 


In Java, a legal identifier is a sequence of Unicode letters and digits of unlimited length. The first character 
must be a letter. All subsequent characters must be letters or numerals from any alphabet that Unicode 
supports. In addition, the underscore character ( _ ) and the dollar sign ( $ ) are considered letters and 
may be used as any character including the first one. 

Back to Question 24 (p. 134) 


2.23.5.17 Answer 23 


False. The name of a reference variable evaluates to either null, or to information that can be used to access 
an object whose reference has been stored in the variable. 

Back to Question 23 (p. 134) 
2.23.5.18 Answer 22 


Later versions of Java support either syntax shown in Listing 1 (p. 140) . 


Listing 1 . Listing for Answer 22. 


class test{ 
public static void main(String[] args){ 
Double vari = 5.5; 
double var2 = vari.doubleValue(); 
System. out.println(var2) ; 


double var3 = vari; 
System. out.println(var3) ; 
}//end main 
}//end class test 


Table 2.57 
Back to Question 22 (p. 134) 


2.23.5.19 Answer 21 


The proper syntax for early versions of Java is shown below. Note the upper-case D . Also note the 
instantiation of a new object of type Double 


Double myWrappedData = new Double(5.5); 


Later versions of Java support the following syntax with the new object of type Double being instantiated 
automatically: 


Double myWrappedData = 5.5; 


Back to Question 21 (p. 134) 
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2.23.5.20 Answer 20 


The proper syntax is shown below. Note the lower-case d . 


double myPrimitiveData = 5.5; 


Back to Question 20 (p. 134) 


2.23.5.21 Answer 19 


The name of the primitive type begins with a lower-case letter and the name of the wrapper type begins 
with an upper-case letter such as double and Double . Note that in some cases, however, that they are 
not spelled the same. For example, the Integer class is the wrapper for type int 

Back to Question 19 (p. 134) 


2.23.5.22 Answer 18 


Wrapper classes 
Back to Question 18 (p. 134) 


2.23.5.23 Answer 17 


This has some ramifications as to how variables can be used (passing to methods, returning from methods, 

etc.) . For example, all variables of primitive types are passed by value to methods meaning that the code 

in the method only has access to a copy of the variable and does not have the ability to modify the variable. 
Back to Question 17 (p. 134) 


2.23.5.24 Answer 16 


False. Primitive data types in Java (int, double, etc.) are not true objects. 
Back to Question 16 (p. 134) 


2.23.5.25 Answer 15 


True. 
Back to Question 15 (p. 133) 


2.23.5.26 Answer 14 


False. The char type in Java is a 16-bit Unicode character. 
Back to Question 14 (p. 133) 


2.23.5.27 Answer 13 


byte 
short 
int 
long 
float 
double 
char 
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e boolean 


Back to Question 13 (p. 133) 


2.23.5.28 Answer 12 


Primitive types contain a single value. 
Back to Question 12 (p. 133) 


2.23.5.29 Answer 11 


Java supports both primitive types and reference (or object) types. 
Back to Question 11 (p. 133) 


2.23.5.30 Answer 10 


In Java, a variable of a specified type is represented exactly the same way regardless of the platform on 
which the application or applet is being executed. 
Back to Question 10 (p. 133) 


2.23.5.31 Answer 9 


False. In Java, all variables of type int contain signed values. 
Back to Question 9 (p. 133) 


2.23.5.32 Answer 8 


All variables in Java must have a defined type . The definition of the type determines the set of values 
that can be stored in the variable and the operations that can be performed on the variable. 
Back to Question 8 (p. 133) 


2.23.5.33 Answer 7 
The syntax is shown in boldface below: 
public static void main( String]] args ) 


In this case, the type of variable declared is an array of type String named args (type String]]) . 
The purpose of the String array variable in the argument list is to make it possible to capture arguments 
entered on the command line. 

Back to Question 7 (p. 133) 


2.23.5.34 Answer 6 


False. Fortunately, Java provides very strict type checking and generally refuses to compile statements with 
type mismatches. 
Back to Question 6 (p. 133) 


2.23.5.35 Answer 5 


int firstVariable, secondVariable = 10; 


Back to Question 5 (p. 132) 
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2.23.5.36 Answer 4 


False: In Java, it is possible to initialize the value of a variable when it is declared, but initialization is not 
required. (Note however that in some situations, the usage of the variable may require that it be purposely 
initialized.) 

Back to Question 4 (p. 132) 


2.23.5.37 Answer 3 


To use a variable, you must notify the compiler of the name and the type of the variable (declare the 
variable). 
Back to Question 3 (p. 132) 
2.23.5.38 Answer 2 
variable 


Back to Question 2 (p. 132) 


2.23.5.39 Answer 1 


Listing 2 . Listing for Answer 1. 


/*File simple4. java 
This application reads characters from the keyboard until 
encountering the # character and echoes each character to 
the screen. The program terminates when the user enters 
the # character. 
FE AG EEE EEEE EEEE E EEEE EE EEEE EEE EE 21 21 21 1 4 2k 2k 2k E EE E ak ak kak / 
class simple4 { //define the controlling class 
public static void main(String[] args) 
throws java.io.I0Exception { 
int chi = 0; 
System. out .print1n( 
"Enter some text, terminate with #"); 
while( (chi = System.in.read() ) != ’#?) 
System.out.print((char)ch1) ; 
System. out.println("Goodbye") ; 
}//end main 
}//End simple4 class. 


Table 2.58 


Back to Question 1 (p. 132) 


2.23.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 
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e File: Jb0200r.htm 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.24 Jb0210: Java OOP: Operators” 


2.24.1 Table of Contents 


e Preface (p. 145) 
Viewing tip (p. 145) 
x Listings (p. 145) 


e Introduction (p. 145) 
e Operators (p. 145) 


Arithmetic operators (p. 148) 

Relational and conditional (logical) operators (p. 149) 
Bitwise operators (p. 151) 

Assignment operators (p. 152) 


e Miscellaneous (p. 152) 


2.24.2 Preface 

Earlier modules have touched briefly on the topic of operators . This module discusses Java operators 
in depth. 

2.24.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


“6This content is available online at <http://cnx.org/content/m45195/1.5/>. 
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2.24.2.1.1 Listings 


e Listing 1 (p. 147) . Illustration of prefix and postfix notation. 
e Listing 2 (p. 150) . Illustration of relational operators. 


2.24.3 Introduction 


The first step in learning to use a new programming language is usually to learn the foundation concepts 
such as 


variables, 
operators, 

types, 

expressions, 
flow-of-control, etc. 


This module concentrates on the operators used in Java. 


2.24.4 Operators 


Unary and binary operators 

Java provides a set of operators that can be used to perform an action on one, two, or three (p. 145) 
operands. An operator that operates on one operand is called a unary operator. An operator that operates 
on two operands is called a binary operator. An operator that operates on three operands is called a 
ternary operator. 

Some operators can behave either as a unary or as a binary operator. The best known such operator s 
probably the minus sign (-) . As a binary operator, the minus sign causes its right operand to be subtracted 
from its left operand. As a unary operator, the minus sign causes the algebraic sign of the right operand to 
be changed. 

A ternary operator 

Java has only one operator that takes three operands. It is a conditional operator, which I sometimes 
refer to as a cheap if statement. 

The first operand is a boolean expression, which is followed by a question mark character (7?) . The 
question mark is followed by a second operand, which is followed by a colon character (:) . The colon 
character is followed by the third operand. 

If the boolean expression evaluates to true, the value of the operand following the ? is returned. 
Otherwise, the value of the operand following the : is returned. 

An example of the syntax follows: 


Ternary operator syntax boolean expression ? valuel : value2 


Overloaded operators 
Unlike C++, Java does not support the creation of overloaded operators in program code. (If you don’t 
know what this means, don’t worry about it.) 
Operators from previous programs 
The statements in the following note box illustrate the use of the following operators from Java programs 
in earlier modules 
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Operators from previous programs 


int chi, ch2 = ’0’; 
while( (chi = System.in.read() ) != °#’) ch2 = chi; 
System.out.println("The char before the # was " 

+ (char) ch2) ; 


The plus and cast operators 

Of particular interest in this list (p. 146) is the plus sign (+) and the cast operator (char) . 

In Java, the plus sign can be used to perform arithmetic addition. It can also be used to concatenate 
strings. When the plus sign is used in the manner shown above (p. 146) , the operand on the right is 
automatically converted to a character string before being concatenated with the operand on the left. 

The cast operator is used in this case (p. 146) to purposely convert the integer value contained in the 
int variable ch2 to a character type suitable for concatenating with the string on the left of the plus sign. 
Otherwise, Java would attempt to convert and display the value of the imt variable as a series of digits 
representing the numeric value of the character because the character is stored in a variable of type int 

The increment operator 

An extremely important unary operator is the increment operator identified by two plus characters 
with no space between them (++) . 

The increment operator causes the value of its operand to be increased by one. 


The decrement operator There is also a decrement operator (—) that causes the value of its 
operand to be decreased by one. 


The increment and decrement operators are used in both prefix and postfix notation. 
Prefix and postfix increment and decrement operators 

With the prefix version, the operand appears to the right of the operator (++X) , while with the 

postfix version, the operand appears to the left of the operator (X++) . 
What’s the difference in prefix and postfix? 

The difference in prefix and postfix has to do with the point in the sequence of operations that the 
increment (or decrement) actually occurs if the operator and its operand appear as part of a larger overall 
expression. 

(There is effectively no difference if the operator and its operand do not appear as part of a larger overall 
expression.) 

Prefix behavior 

With the prefix version, the variable is incremented (or decremented) before it is used to evaluate the 

larger overall expression. 
Postfix behavior 

With the postfix version, the variable is used to evaluate the larger overall expression before it is 
incremented (or decremented) . 

Illustration of prefix and postfix behavior 

The use of both the prefix and postfix versions of the increment operator is illustrated in the Java 
program shown in Listing 1 (p. 147) . The output produced by the program is show in the comments at the 
beginning of the program. 
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Listing 1 . Illustration of prefix and postfix notation. 


/*File incr01.java Copyright 1997, n 
Illustrates the use of the prefix and the postfix increment 
operator. 


The output from the program follows: 


a=5 
b=5 
a + bt+ = 10 
b=6 
c=5 
d=5 
c + ++d = 11 
d=6 


FOSS OOOO OIRO ASIII CII II I ISI I I A ak kk ak ka 4 / 
class incr01 { //define the controlling class 
public static void main(String[] args){ //main method 
int a= 5, b=5, c=5, d= 5; 


System.out.println("a =" +a); 
System.out.println("b =" +b ); 
System.out.printin("a + b++ = " + (a + btt) ); 
System.out.println("b =" +b ); 

System. out.println() ; 

System.out.println("c =" + c ); 
System.out.println("d =" +d); 
System.out.printin("c + ttd = " + (c + ++d) ); 
System.out.println("d =" +d); 


}//end main 
}//End incr01 class. 


Table 2.59 


Binary operators and infix notation 


Binary operators use infix notation, which means that the operator appears between its operands. 


General behavior of an operator 


As a result of performing the specified action, an operator can be said to return a value (or evaluate to 
a value) of a given type. The type of value returned depends on the operator and the type of the operands. 


Evaluating to a value To evaluate to a value means that after the action is performed, the 
operator and its operands are effectively replaced in the expression by the value that is returned. 


Operator categories 


I will divide Java’s operators into the following categories for further discussion: 


e arithmetic operators 
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e relational and conditional (logical) operators 
e bitwise operators 
e assignment operators 


2.24.4.1 Arithmetic operators 


Java supports various arithmetic operators on all floating point and integer numbers. 
The binary arithmetic operators 
The following table lists the binary arithmetic operators supported by Java. 


The binary arithmetic operators 


Operator Description 
+ Adds its operands 
- Subtracts the right operand from the left 
operand 
* Multiplies the operands 
/ Divides the left operand by the right operand 
% Remainder of dividing the left operand by 


the right operand 


String concatenation 


As mentioned earlier, the plus operator (+) is also used to concatenate strings as in the following code 
fragment: 


String concatenation 


"MyVariable has a value of " 
+ MyVariable + " in this program." 


Coercion 
Note that this operation (p. 148) also coerces the value of MyVariable to a string representation for 
use in the expression only. However, the value stored in the variable is not modified in any lasting way. 
Unary arithmetic operators 
Java supports the following unary arithmetic operators. 


Unary arithmetic operators 


Operator Description 
+ Indicates a positive value 
- Negates, or changes algebraic sign 
++ Adds one to the operand, 


both prefix and postfix 
-- Subtracts one from operand, 
both prefix and postfix 


The result of the increment and decrement operators being either prefix or postfix was discussed earlier 
(p. 146) . 
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2.24.4.2 Relational and conditional (logical) operators 


Binary Relational operators 
Java supports the set of binary relational operators shown in the following table. Relational operators 


in Java return either true or false asa boolean type. 


Binary Relational operators 


Operator Returns true if 
> Left operand is greater than right operand 
>= Left operand is greater than or equal to 
right operand 
< Left operand is less than right operand 
<= Left operand is less than or equal to 


right operand 
== Left operand is equal to right operand 
!= Left operand is not equal to right operand 


Conditional expressions 
Relational operators are frequently used in the conditional expressions of control statement such as the 


one in the code fragment shown below. 


Conditional expressions 


if(LeftVariable <= RightVariable). 


Illustration of relational operators 

The program shown in Listing 2 (p. 150) illustrates the result of applying relational operators in Java. 
The output is shown in the comments at the beginning of the program. Note that the program automatically 
displays true and false as a result of applying the relational operators. 


Listing 2 . Illustration of relational operators. 


/*File relat01.java Copyright 1997, R.G.Baldwin 
Illustrates relational operators. 


Output is 


The relational 6<5 is false 
The relational 6>5 is true 


FOSSA AI AS ICI I I I I I I I I I I I I OK 1 2K 21K Ff 2k EEE 2k 2k fk fC 2K aK a ak ak ak ak EN 
class relat01 { //define the controlling class 
public static void main(String[] args){ //main method 
System.out.println("The relational 6<5 is " 
+(6<5)); 
System.out.println("The relational 6>5 is " 
+(6>5)); 
}//end main 
}//End relat01 class. 
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Table 2.60 


Conditional operators 

The relational operators are often combined with another set of operators (referred to as conditional or 
logical operators) to construct more complex expressions. 

Java supports three such operators as shown in the following table. 


Conditional or logical operators 


Operator Typical Use Returns true if 
&& Left && Right Left and Right are both true 
|| Left || Right Either Left or Right is true 
! ! Right Right is false 


The operands shown in the table (p. 150) must be boolean types, or must have been created by the 
evaluation of an expression that returns a boolean type. 

Left to right evaluation 

An important characteristic of the behavior of the logical and and the logical or operators is that 
the expressions are evaluated from left to right, and the evaluation of the expression is terminated as soon 
as the result of evaluating the expression can be determined. 

For example, in the following expression, if the variable a is less than the variable b , there is no 
need to evaluate the right operand of the || to determine that the result of evaluating the entire expression 
would be true . Therefore, evaluation will terminate as soon as the answer can be determined. 


Left to right evaluation 


(a < b) Il (c < d) 


Don’t confuse bitwise and with logical and 
As discussed in the next section, symbols shown below are the bitwise and and the bitwise or 


Bitwise and and bitwise or 


& bitwise and 
| bitwise or 


One author states that in Java, the bitwise and operator can be used as a synonym for the logical and 
and the bitwise or can be used as a synonym for the logical inclusive or if both of the operands are 
boolean . (I recommend that you don’t do that because it could cause confusion for someone reading 
your code.) 
Note however that according to a different author, in this case, the evaluation of the expression is not 
terminated until all operands have been evaluated, thus eliminating the possible advantage of the left-to-right 
evaluation. 


2.24.4.3 Bitwise operators 


Java provides a set of operators that perform actions on their operands one bit at a time as shown in the 
following table. 


Bitwise operators 
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Operator Typical Use Operation 

> OpLeft > Dist Shift bits of OpLeft right 
by Dist bits (signed) 

K OpLeft « Dist Shift bits of OpLeft left 
by Dist bits 

>> OpLeft >> Dist Shift bits of OpLeft right 
by Dist bits (unsigned) 

& OpLeft & OpRight Bitwise and of the 


two operands 
l OpLeft | OpRight Bitwise 


Populating vacated bits for shift operations 

The signed right shift operation populates the vacated bits with the sign bit, while the left shift and 
the unsigned right shift populate the vacated bits with zeros. 

In all cases, bits shifted off the end are lost. 

The rule for bitwise and 

The bitwise and operation operates according to the rule that the bitwise and of two 1 bits is a 1 bit. 

Any other combination results in a 0 bit. 

Bitwise inclusive or 

For the inclusive or , if either bit is a 1, the result is a 1. 

Otherwise, the result is a 0. 

Bitwise exclusive or 

For the exclusive or ,if either but not both bits is a 1, the result is a 1. 

Otherwise, the result is a 0. 

Another way to state this is if the bits are different, the result is a 1. If the two bits are the same, the 
result is a 0. 

The complement operator 

Finally, the complement operator changes each 1 to a 0 and changes each 0 to a 1. 


2.24.4.4 Assignment operators 


Simple assignment operator 

The (=) is a value assigning binary operator in Java. The value stored in memory and represented 
by the right operand is copied into the memory represented by the left operand. 

Using the assignment operator with reference variables 

You need to be careful and think about what you are doing when you use the assignment operator with 
reference variables in Java. If you assign one reference variable to another, you simply end up with two 
reference variables that refer to the same object. You do not end up with two different objects. 

(I£ what you need is another copy of the object, you may be able to use the clone method to 

accomplish that.) 

Shortcut assignment operators 

Java supports the following list of shortcut assignment operators. These operators allow you to perform 
an assignment and another operation with a single operator. 


Shortcut assignment operators 
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X= 
2a 
ae 


For example, the two statements that follow perform the same operation. 


Illustration of shortcut assignment operation 


x += y; 
X=xX+ 3 


2.24.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0210: Java OOP: Operators 
e File: Jb0210 

e Originally published: 1997 

e Published at cnx.org: 11/23/12 

e Revised: 12/04/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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(p. 159) 
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2.25.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0210: Java OOP: Operators 


78 


The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 


question to the answer and back again. 


2.25.3 Questions 
2.25.3.1 Question 1 


An operator performs an action on what? Provide the name. 
Answer 1 (p. 170) 


2.25.3.2 Question 2 


What do we call an operator that operates on only one operand? 
Answer 2 (p. 170) 


2.25.3.3 Question 3 


What do we call an operator that operates on two operands? 
Answer 3 (p. 170) 


2.25.3.4 Question 4 


Is the minus sign a unary ora binary operator, or both? Explain your answer. 


Answer 4 (p. 170) 


2.25.3.5 Question 5 


Describe operator overloading. 
Answer 5 (p. 170) 


“’This content is available online at <http://cnx.org/content/m45186/1.6/>. 
“8http://cnx.org/content /m45195 
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2.25.3.6 Question 6 


True or false? Java programmers may overload operators. 
Answer 6 (p. 170) 


2.25.3.7 Question 7 


Show the symbols used for the following operators in Java: assignment , not equal , addition , cast . 
Answer 7 (p. 170) 


2.25.3.8 Question 8 


Are any operators automatically overloaded in Java? If so, identify one and describe its overloaded behavior. 
Answer 8 (p. 170) 


2.25.3.9 Question 9 


What is the purpose of the cast operator? 
Answer 9 (p. 169) 


2.25.3.10 Question 10 


True or false? The increment operator is a binary operator. 
Answer 10 (p. 169) 


2.25.3.11 Question 11 


Show the symbol for the increment operator. 
Answer 11 (p. 169) 


2.25.3.12 Question 12 


Describe the appearance and the behavior of the increment operator with both prefix and postfix notation. 
Show example, possibly incomplete, code fragments illustrating both notational forms. 
Answer 12 (p. 169) 


2.25.3.13 Question 13 


Show the output that would be produced by the Java application in Listing 1 (p. 156) . 
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Listing 1 . Listing for Question 13. 


class incr01 { //define the controlling class 
public static void main(String[] args){ //define main 
int x = 5, X=5, y=5, Y=5; 


System.out.println("x =" +x ); 
System.out.println("X =" + X ); 
System.out.println("x + X++ = " + (x + X++) ); 
System.out.println("X =" + X ); 

System. out.println() ; 

System.out.println("y =" + y ); 
System.out.println("Y = "+ Y ); 
System.out.printin("y + ++Y = " + (y + ++Y) ); 
System.out.println("Y =" + Y ); 


}//end main 
}//End incr01 class. Note no semicolon required 
//End Java application 


Table 2.61 


Answer 13 (p. 169) 


2.25.3.14 Question 14 

True or false? Binary operators use outfix notation. If your answer is False, explain why. 
Answer 14 (p. 169) 

2.25.3.15 Question 15 


In practice, what does it mean to say that an operator that has performed an action returns a value (or 
evaluates to a value) of a given type? 
Answer 15 (p. 169) 


2.25.3.16 Question 16 


Show and describe at least five of the binary arithmetic operators supported by Java (Clarification: binary 
operators does not mean bitwise operators). 
Answer 16 (p. 168) 


2.25.3.17 Question 17 


In addition to arithmetic addition, what is another use for the plus operator (+) ? Show an example code 
fragment to illustrate your answer. The code fragment need not be a complete statement. 
Answer 17 (p. 168) 


2.25.3.18 Question 18 


When the plus operator (+) is used as a concatenation operator, what is the nature of its behavior if its 
left operand is of type String and its right operand is not of type String ? If the right operand is a 
variable that is not of type String , what is the impact of this behavior on that variable. 

Answer 18 (p. 168) 
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2.25.3.19 Question 19 


Show and describe four unary arithmetic operators supported by Java. 
Answer 19 (p. 168) 


2.25.3.20 Question 20 


What is the type returned by relational operators in Java? 
Answer 20 (p. 167) 


2.25.3.21 Question 21 


Show and describe six different relational operators supported by Java. 
Answer 21 (p. 167) 


2.25.3.22 Question 22 


Show the output that would be produced by the Java application shown in Listing 2 (p. 157) . 


Listing 2 . Listing for Question 22. 


class relatO1 { //define the controlling class 
public static void main(String[] args){ //define main 
System.out.println("The relational 6<5 is "+ (6<5 )); 
System.out.println("The relational 6>5 is "+ (6>5 )); 
}//end main 
}//End relat0O1 class. Note no semicolon required 
//End Java application 


Table 2.62 


Answer 22 (p. 167) 


2.25.3.23 Question 23 


Show and describe three operators (frequently referred to as conditional or logical operators) that are 
often combined with relational operators to construct more complex expressions (often called conditional 
expressions) . Hint: The || operator returns true if either the left operand, the right operand, or both 
operands are true. What are the other two and how do they behave? 

Answer 23 (p. 167) 
2.25.3.24 Question 24 


Describe the special behavior of the || operator in the following expression for the case where the value of 
the variable a is less than the value of the variable b 


(a < b) Il (c < d) 


Answer 24 (p. 166) 
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2.25.3.25 Question 25 


Show the symbols used for the bitwise and operator and the bitwise inclusive or operator. 
Answer 25 (p. 166) 


2.25.3.26 Question 26 


Show and describe seven operators in Java that perform actions on the operands one bit at a time (bitwise 
operators) . 
Answer 26 (p. 166) 


2.25.3.27 Question 27 


True or false? In Java, the signed right shift operation populates the vacated bits with the zeros, while the 
left shift and the unsigned right shift populate the vacated bits with the sign bit. If your answer is False, 
explain why. 

Answer 27 (p. 166) 


2.25.3.28 Question 28 


True or false? Ina signed right-shift operation in Java, the bits shifted off the right end are lost. If your 
answer is False, explain why. 
Answer 28 (p. 166) 


2.25.3.29 Question 29 


Using the symbols 1 and 0, construct a truth table showing the four possible combinations of 1 and 0. Using 
a 1 or a 0, show the result of the bitwise and operation on these four combinations of 1 and 0. 
Answer 29 (p. 165) 


2.25.3.30 Question 30 


Using the symbols 1 and 0 construct a truth table showing the four possible combinations of 1 and 0. Using 
a 1 or a 0, show the result of the bitwise inclusive or operation on these four combinations of 1 and 0. 
Answer 30 (p. 165) 


2.25.3.31 Question 31 


Using the symbols 1 and 0 construct a truth table showing the four possible combinations of 1 and 0. Using 
a 1 or a 0, show the result of the bitwise exclusive or operation on these four combinations of 1 and 0. 
Answer 31 (p. 165) 


2.25.3.32 Question 32 
True or false? For the exclusive or , if the two bits are different, the result is a 1. If the two bits are the 
same, the result is a 0. If your answer is False, explain why. 
Answer 32 (p. 165) 
2.25.3.33 Question 33 


Is the assignment operator a unary operator or a binary operator. Select one or the other. 
Answer 33 (p. 165) 
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2.25.3.34 Question 34 
True or false? In Java, when using the assignment operator, the value stored in memory and represented by 
the right operand is copied into the memory represented by the left operand. If your answer is False, explain 
why. 

Answer 34 (p. 165) 
2.25.3.35 Question 35 


Show two of the shortcut assignment operators and explain how they behave by comparing them with the 
regular (non-shortcut) versions. Hint: the (^=) operator is a shortcut assignment operator. 
Answer 35 (p. 164) 


2.25.3.36 Question 36 


Write a Java application that clearly illustrates the difference between the prefix and the postfix versions of 
the increment operator. Provide a termination message that displays your name. 
Answer 36 (p. 164) 


2.25.3.37 Question 37 


Write a Java application that illustrates the use of the following relational operators: 


Provide appropriate text in the output. Also provide a termination message with your name. 
Answer 37 (p. 162) 


2.25.3.38 Question 38 


write a Java application that illustrates the use of the following logical or conditional operators: 


Logical or conditional operators 


&& 
I | 


Provide appropriate text in the output. Also provide a termination message with your name. 
Answer 38 (p. 162) 
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2.25.4 Listings 


e Listing 1 (p. 156) . Listing for Question 13. 
e Listing 2 (p. 157) . Listing for Question 22. 
e Listing 3 (p. 162) . Listing for Answer 38. 
e Listing 4 (p. 163) . Listing for Answer 37. 
e Listing 5 (p. 164) . Listing for Answer 36. 


What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None 


Display your nami 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 


Put your name here 
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2.25.5 Answers 
2.25.5.1 Answer 38 


Listing 3 . Listing for Answer 38. 


/*File SampProg09. java from module 22 

Copyright 1997, R.G.Baldwin 

Without reviewing the following solution, write a Java 
application that illustrates the use of the following 
logical or conditional operators: 


&& Il o! 


Provide appropriate text in the output. Also provide 
a termination message with your name. 
LEETE EEEE EE EEE EEEE EEEE EEE EE EEE EEEE EEEE EEE EE EE E EEE E EE EE 24 2 E / 
class SampProg09 { //define the controlling class 
public static void main(String[] args){ //define main 
System.out.println("true and true is " 
+ (true && true) ); 
System.out.println("true and false is " 
+ (true && false) ); 


System.out.println("true or true is " 


+ (true || true) ); 
System.out.println("true or false is " 
+ (true || false) ); 


System.out.println("false or false is " 
+ (false || false) ); 


System.out.println("not true is " + (! true) ); 
System.out.println("not false is " + (! false) ); 


System.out.println("Terminating, Dick Baldwin"); 
}//end main 
}//End SampProg09 class. Note no semicolon required 


Table 2.63 


Back to Question 38 (p. 159) 


2.25.5.2 Answer 37 
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Listing 4 . Listing for Answer 37. 


/*File SampProg08. java from module 22 

Copyright 1997, R.G.Baldwin 

Without reviewing the following solution, write a Java 
application that illustrates the use of the following 
relational operators: 


< > <= >= == !5 


Provide appropriate text in the output. Also provide 
a termination message with your name. 


CHAPTER 2. PROGRAMMING FUNDAMENTALS 


Fk kk ak ak ək akak 3k ak 2k 2k ək 2k 2k ək 22k əkək 2k ək 3k 2k 3k ək 3k 2k ək ək 3k 2k ək ək 3k ək 2k 2k ək 2k əkək ak 22k ak 2 2k ÞK ak ak K / 


class SampProg08 { //define the controlling class 

public static void main(String[] args){ //define main 

System. out .println("The relational 6<5 is " 
+ (6<5 ) ); 
System. out .println("The relational 6>5 is " 
+ (6>5 ) ); 
System. out .println("The relational 5>=5 is " 
+ (5>=5 ) ); 
System. out .println("The relational 5<=5 is " 
+ (5<=5 ) ); 
System. out .println("The relational 6==5 is " 


+ (6==5 ) ); 


System. out .println("The relational 6!=5 is " 


+ (6!=5 ) ); 


System.out.println("Terminating, Dick Baldwin"); 
}//end main 
}//End SampProg08 class. Note no semicolon required 


Table 2.64 


Back to Question 37 (p. 159) 
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2.25.5.3 Answer 36 


Listing 5 . Listing for Answer 36. 


/*File SampProg07.java from module 22 

Copyright 1997, R.G.Baldwin 

Without reviewing the following solution, write a Java 
application that clearly illustrates the difference between 
the prefix and the postfix versions of the increment 
operator. 


Provide a termination message that displays your name. 
FE AG EEE EEEE EEE EE EEE EEEE EEEE 21 2k E E 21 21 2 4 24 E 2 a 4 2k 2 E E / 
class SampProg07{ 
static public void main(String[] args){ 
int x = 3; 
int y = 3; 
int z = 10; 
System. out .println("Prefix version gives " 
+ (z + ++x)); 
System.out.println("Postfix version gives " 
+ (z + y++)); 
System.out.println("Terminating, Dick Baldwin"); 
}//end main 
}//end class SampProg07 


Table 2.65 


Back to Question 36 (p. 159) 


2.25.5.4 Answer 35 


Java supports the following list of shortcut assignment operators. These operators allow you to perform 
an assignment and another operation with a single operator. 
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For example, the two statements that follow perform the same operation. 
x += y; 
e x=x+y; 
The behavior of each of the shortcut assignment operators follows this same pattern. 
Back to Question 35 (p. 159) 
2.25.5.5 Answer 34 
True. 
Back to Question 34 (p. 159) 
2.25.5.6 Answer 33 
The assignment operator is a binary operator. 
Back to Question 33 (p. 158) 
2.25.5.7 Answer 32 
True. 
Back to Question 32 (p. 158) 
2.25.5.8 Answer 31 


The answer for the bitwise exclusive or is: 


11 1 xor 1 produces 0 
10 1 xor 0 produces 1 
01 0 xor 1 produces 1 
00 0 xor 0 produces 0 


Back to Question 31 (p. 158) 


2.25.5.9 Answer 30 


The answer for the bitwise inclusive or is: 


11 1 or 1 produces 1 
10 1 or 0 produces 1 
01 0 or 1 produces 1 
00 0 or 0 produces 0 


Back to Question 30 (p. 158) 


2.25.5.10 Answer 29 


The answer for the bitwise and is: 


11 1 and 1 produces 1 
10 1 and 0 produces 0 
01 0 and 1 produces 0 
00 0 and 0 produces 0 


Back to Question 29 (p. 158) 
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2.25.5.11 Answer 28 

True: Bits shifted off the right end are lost. 
Back to Question 28 (p. 158) 

2.25.5.12 Answer 27 


False: In Java, the signed right shift operation populates the vacated bits with the sign bit, while the left 
shift and the unsigned right shift populate the vacated bits with zeros. 
Back to Question 27 (p. 158) 


2.25.5.13 Answer 26 


The following table shows the seven bitwise operators supported by Java. 


Bitwise operators 


Operator Typical Use Operation 

> OpLeft > Dist Shift bits of OpLeft right by 
Dist bits (signed) 

< OpLeft < Dist Shift bits of OpLeft left by 
Dist bits 

>> OpLeft >> Dist Shift bits of OpLeft right 
by Dist bits (unsigned) 

& OpLeft & OpRight Bitwise and of the two 
operands 


l OpLeft | OpRight Bitwise 


Back to Question 26 (p. 158) 


2.25.5.14 Answer 25 


The bitwise and operator and the bitwise inclusive or operator are shown below. 


Two bitwise operators 


& bitwise and 
| bitwise inclusive or 


Back to Question 25 (p. 158) 


2.25.5.15 Answer 24 


An important characteristic of the behavior of the logical and operator andthe logical or operator 
in Java is that the expressions containing them are evaluated from left to right. The evaluation of the 
expression is. terminated as soon as the result of evaluating the expression can be determined. For example, 
in the expression given in Question 24 (p. 157) , if the variable a is less than the variable b , there is 
no need to evaluate the right operand of the || operator to determine the value of the entire expression. 
Therefore, evaluation will terminate as soon as it is determined that a is less than b 

Back to Question 24 (p. 157) 
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2.25.5.16 Answer 23 


The following three logical or conditional operators are supported by Java. 


The logical or conditional operators 


Operator Typical Use Returns true if 
&& Left && Right Left and Right are both true 
E Left || Right Either Left or Right is true 
! ! Right Right is false 


Back to Question 23 (p. 157) 


2.25.5.17 Answer 22 


This program produces the following output: 


The relational 6<5 is false 
The relational 6>5 is true 


Back to Question 22 (p. 157) 


2.25.5.18 Answer 21 


Java supports the following set of relational operators: 


Relational operators 


Operator Returns true if 
> Left operand is greater than right operand 
>= Left operand is greater than or equal 
to right operand 
< Left operand is less than right operand 
<= Left operand is less than or equal 


to right operand 
== Left operand is equal to right operand 
!= Left operand is not equal to right operand 


Back to Question 21 (p. 157) 


2.25.5.19 Answer 20 


Relational operators return the boolean type in Java. 
Back to Question 20 (p. 157) 
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2.25.5.20 Answer 19 


Java supports the following four unary arithmetic operators. 


Unary arithmetic operators 


Operator Description 
+ Indicates a positive value 
- Negates, or changes algebraic sign 
++ Adds one to the operand, 


both prefix and postfix 
os Subtracts one from operand, 
both prefix and postfix 


Back to Question 19 (p. 157) 


2.25.5.21 Answer 18 


The operator coerces the value of the right operand to a string representation for use in the expression only. 
If the right operand is a variable, the value stored in the variable is not modified in any way. 
Back to Question 18 (p. 156) 


2.25.5.22 Answer 17 
The plus operator (+) is also used to concatenate strings as in the following code fragment: 


String concatenation 


"MyVariable has a value of " 
+ MyVariable + " in this program." 


Back to Question 17 (p. 156) 


2.25.5.23 Answer 16 


Java support various arithmetic operators on floating point and integer numbers. The following table lists 
five of the binary arithmetic operators supported by Java. 


Binary arithmetic operators 


Operator Description 

+ Adds its operands 

- Subtracts the right operand from the left 
operand 

* Multiplies the operands 

/ Divides the left operand by the right 
operand 

% Remainder of dividing the left operand by 


the right operand 


Back to Question 16 (p. 156) 
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2.25.5.24 Answer 15 


As a result of performing the specified action, an operator can be said to return a value (or evaluate to a 
value) of a given type. The type depends on the operator and the type of the operands. To evaluate to a 
value means that after the action is performed, the operator and its operands are effectively replaced in the 
expression by the value that is returned. 

Back to Question 15 (p. 156) 


2.25.5.25 Answer 14 


False: Binary operators use infix notation, which means that the operator appears between its operands. 
Back to Question 14 (p. 156) 


2.25.5.26 Answer 13 


The output from this Java application follows: 


e x=5 
e X=5 
e x+ X++ =10 
e X=6 
e y=5 
e Y=5 
e y+ ++Y = 11 
e Y=6 


Back to Question 13 (p. 155) 


2.25.5.27 Answer 12 


The increment operator may be used with both prefix and postfix notation. Basically, the increment 
operator causes the value of the variable to which it is applied to be increased by one. 

With prefix notation, the operand appears to the right of the operator (++X) , while with postfix 
notation, the operand appears to the left of the operator (X++) . 

The difference in behavior has to do with the point in the sequence of operations that the increment 
actually occurs. 

With the prefix version, the variable is incremented before it is used to evaluate the larger overall 
expression in which it appears. With the postfix version, the variable is used to evaluate the larger overall 
expression and then the variable is incremented. 

Back to Question 12 (p. 155) 


2.25.5.28 Answer 11 


The symbol for the increment operator is two plus signs with no space between them (++). 
Back to Question 11 (p. 155) 


2.25.5.29 Answer 10 


False: The increment operator isa unary operator. 
Back to Question 10 (p. 155) 


2.25.5.30 Answer 9 


The cast operator is used to purposely convert from one type to another. 
Back to Question 9 (p. 155) 
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2.25.5.31 Answer 8 


The plus sign (+) is automatically overloaded in Java. The plus sign can be used to perform arithmetic 
addition. It can also be used to concatenate strings. However, the plus sign does more than concatenate 
strings. It also performs a conversion to String type. When the plus sign is used to concatenate strings 
and one operand is a string, the other operand is automatically converted to a character string before being 
concatenated with the existing string. 

Back to Question 8 (p. 155) 


2.25.5.32 Answer 7 


The operators listed in order are: 


where the cast operator is being used to cast to the type char 
Back to Question 7 (p. 155) 

2.25.5.33 Answer 6 

Java does not support operator overloading by programmers. 
Back to Question 6 (p. 155) 

2.25.5.34 Answer 5 


For those languages that support it (such as C++) operator overloading means that the programmer can 
redefine the behavior of an operator with respect to objects of a new type defined by that program. 

Back to Question 5 (p. 154) 
2.25.5.35 Answer 4 


Both. Asa binary operator, the minus sign causes its right operand to be subtracted from its left operand. 
Asa unary operator, the minus sign causes the algebraic sign of the right operand to be changed. 
Back to Question 4 (p. 154) 


2.25.5.36 Answer 3 


An operator that operates on two operands is called a binary operator. 
Back to Question 3 (p. 154) 


2.25.5.37 Answer 2 


An operator that operates on only one operand is called a unary operator. 
Back to Question 2 (p. 154) 


2.25.5.38 Answer 1 


An operator performs an action on one or two operands. 
Back to Question 1 (p. 154) 
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2.25.6 Miscellaneous 


This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Jb0210r Review: Operators 
e File: Jb0210r.htm 

e Originally published: 1997 

e Published at cnx.org: 11/23/12 

e Revised: 12/04/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.26 Jb0220: Java OOP: Statements and Expressions” 


2.26.1 Table of Contents 


Preface (p. 171) 
Introduction (p. 171) 
Expressions (p. 172) 
Statements (p. 172) 
Further reading (p. 172) 
Miscellaneous (p. 172) 


2.26.2 Preface 


Java programs are composed of statements, and statements are constructed from expressions. This module 
takes a very brief look at Java statements and expressions.border width 


2.26.3 Introduction 


The first step 

The first step in learning to use a new programming language is usually to learn the foundation concepts 
such as variables, types, expressions, flow-of-control, etc. This module concentrates on expressions and 
statements. 


“9This content is available online at <http://cnx.org/content/m45192/1.4/>. 
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2.26.4 Expressions 


The hierarchy 

Java programs are composed of statements, and statements are constructed from expressions. 

An expression is a specific combination of operators and operands, that evaluates to a single value. The 
operands can be variables, constants, or method calls. 

A method call evaluates to the value returned by the method. 

Named constants 

Java supports named constants that are implemented through the use of the final keyword. 

The syntax for creating a named constant in Java is as follows: 


Named constants 


final float PI = 3.14159; 


While this is not a constant type, it does produce a value that can be referenced in the program and which 
cannot be modified. 

The final keyword prevents the value of PI from being modified in this case (p. 172) . You will learn 
later that there are some other uses for the final keyword in Java as well. 

Operator precedence 

In some cases, the order in which the operations are performed determines the result. You can control 
the order of evaluation by the use of matching parentheses. 

If you don’t provide such parentheses, the order will be determined by the precedence of the operators 

(you should find and review a table of Java operator precedence) with the operations having higher 

precedence being evaluated first. 


2.26.5 Statements 


According to The Java Tutorials °° , "A statement forms a complete unit of execution." 
A statement is constructed by combining one or more expressions into a compound expression and 
terminating that expression with a semicolon. 


2.26.6 Further reading 


As of November 2012, a good tutorial on this topic is available on the Oracle website titled Expressions, 
Statements, and Blocks ê! . 


2.26.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0220: Java OOP: Statements and Expressions 
e File: Jb0220.htm 

e Originally published: 1997 

e Published at cnx.org: 11/24/12 

e Revised: 12/04/14 


8°http://docs.oracle.com/javase/tutorial/java/nutsandbolts/expressions.html 
81 http://docs.oracle.com/javase/tutorial/java/nutsandbolts/expressions.html 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.27.1 Table of Contents 


e Preface (p. 174) 
e Questions (p. 174) 


173 


1 (p. 174) , 2 (p. 174) , 3 (p. 174) , 4 (p. 174) , 5 (p. 174) , 6 (p. 174) , 7 (p. 175) , 8 (p. 175) , 


9 (p. 175) 


e Answers (p. 176) 
e Miscellaneous (p. 177) 


2.27.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0220: Java OOP: State- 


ments and Expressions °° . 


The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 


question to the answer and back again. 


2.27.3 Questions 
2.27.3.1 Question 1 


A Java program is composed of a series of what? 
Answer 1 (p. 177) 


2.27.3.2 Question 2 


Statements in Java are constructed from what? 
Answer 2 (p. 177) 


2.27.3.3 Question 3 


Describe an expression in Java. 


Answer 3 (p. 177) 


2.27.3.4 Question 4 


What does a method call evaluate to in Java? 
Answer 4 (p. 177) 


2.27.3.5 Question 5 


True or false? Java supports named constants. If false, explain why. 
Answer 5 (p. 177) 


2.27.3.6 Question 6 


Provide a code fragment that illustrates the syntax for creating a named constant in Java. 


Answer 6 (p. 176) 


82This content is available online at <http://cnx.org/content /m45189/1.5/>. 
83http://cnx.org/content /m45192 
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2.27.3.7 Question 7 


True or false? Java supports a constant type. If false, explain why. 
Answer 7 (p. 176) 


2.27.3.8 Question 8 


What is the common method of controlling the order of evaluation of expressions in Java? 
Answer 8 (p. 176) 


2.27.3.9 Question 9 


If you don’t use matching parentheses to control the order of evaluation of expressions, what is it that 
controls the order of evaluation? 

Answer 9 (p. 176) 

What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Put your name here 


ho 


A | 
Cra ai i 


2.27.4 Answers 
2.27.4.1 Answer 9 
If you don’t provide matching parentheses to control the order of evaluation, the order will be determined 
by the precedence of the operators with the operations having higher precedence being evaluated first. For 
example, multiply and divide have higher precedence than add and subtract. 
Back to Question 9 (p. 175) 
2.27.4.2 Answer 8 
You can control the order of evaluation by the use of matching parentheses. 
Back to Question 8 (p. 175) 
2.27.4.3 Answer 7 


False. Java does not support a constant type. However, in Java, it is possible to achieve the same result by 
declaring and initializing a variable and making it final . 
Back to Question 7 (p. 175) 


2.27.4.4 Answer 6 


The syntax for creating a named constant in Java is shown below. 


A named constant in Java 
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final float PI = 3.14159; 


Back to Question 6 (p. 174) 


2.27.4.5 Answer 5 


True. Java supports named constants that are constructed using variable declarations with the final 
keyword. 
Back to Question 5 (p. 174) 


2.27.4.6 Answer 4 


A method call evaluates to the value returned by the method. 
Back to Question 4 (p. 174) 


2.27.4.7 Answer 3 


An expression is a specific combination of operators and operands that evaluates to a particular value. The 
operands can be variables, constants, or method calls. 
Back to Question 3 (p. 174) 


2.27.4.8 Answer 2 


Statements in Java re constructed from expressions. 
Back to Question 2 (p. 174) 


2.27.4.9 Answer 1 


A Java program is composed of a series of statements. 
Back to Question 1 (p. 174) 


2.27.5 Miscellaneous 


This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Jb0220r Review: Statements and Expressions 
e File: Jb0220r.htm 

e Originally published: 1997 

e Published at cnx.org: 11/24/12 

e Revised: 12/04/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


177 


a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.28 Jb0230: Java OOP: Flow of Control“ 


2.28.1 Table of Contents 


e Preface (p. 178) 
Viewing tip (p. 178) 
x Images (p. 178) 
x Listings (p. 179) 
e Introduction (p. 179) 
Flow of control (p. 179) 
The while statement (p. 180) 
The if-else statement (p. 181) 
The switch-case statement (p. 182) 
The for loop (p. 183) 
The for-each loop (p. 186) 
The do-while loop (p. 187) 
The break and continue statements (p. 187) 
Unlabeled break and continue (p. 187) 
Labeled break and continue statements (p. 187) 
* Labeled break statements (p. 188) 
* Labeled continue statements (p. 191) 
The return statement (p. 191) 
Exception handling (p. 192) 
e Looking ahead (p. 192) 
e Miscellaneous (p. 192) 


2.28.2 Preface 


Java supports several different statements designed to alter or control the logical flow of the program. This 
module explores those statements. 


2.28.2.1 Viewing tip 
I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


2.28.2.1.1 Images 


e Image 1 (p. 180) . Statements that support flow of control. 
e Image 2 (p. 180) . Syntax of a while statement. 
e Image 3 (p. 181) . Syntax of an if-else statement. 


84This content is available online at <http://cnx.org/content /m45196/1.5/>. 
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Image 4 (p. 182 
Image 5 (p. 183 
p. 187 


( . Syntax of a switch-case statement. 
( 
( 
Image 7 (p. 188 
( 
( 


. Syntax of a for loop. 

. Syntax of a do-while loop. 

. Syntax of a labeled statement. 

. An empty return statement. 

. Returning a value from a method. 


Image 8 (p. 191 
Image 9 (p. 191 
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2.28.2.1.2 Listings 


e Listing 1 (p. 181) . Sample Java while statement. 

e Listing 2 (p. 184) . A program that won’t compile. 

e Listing 3 (p. 185) . Another program that won’t compile. 
e Listing 4 (p. 185) . A program that will compile. 

e Listing 5 (p. 186) . Another program that will compile. 

e Listing 6 (p. 189) . The program named switch1.java. 

e Listing 7 (p. 190) . The program named switch2.java. 


2.28.3 Introduction 


The first step 
The first step in learning to use a new programming language is usually to learn the foundation concepts 
such as variables, types, expressions, flow-of-control, etc. This module concentrates on flow-of-control . 


2.28.4 Flow of control 


What is flow of control? 
Java supports several different kinds of statements designed to alter or control the logical flow of the 
program. 
The ability to alter the logical flow of the program is often referred to as Flow of Control . 
Statements that support flow of control 
Image 1 (p. 180) lists the statements supported by Java for controlling the logical flow of the program. 
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Image 1 . Statements that support flow of control. 
Statement Type 

if-else selection 

switch-case selection 

for loop 

for-each loop 

while loop 

do-while loop 

try-catch-finally exception handling 

throw exception handling 

break miscellaneous 

continue miscellaneous 

label: miscellaneous 

return miscellaneous 

goto reserved by Java but not supported 


Table 2.66 


2.28.4.1 The while statement 


We’ve seen the while statement in earlier modules. Several of the programs in earlier modules contained 
a while statement designed to control the logical flow of the program. 

Syntax of a while statement 

The general syntax of a while statement is shown in Image 2 (p. 180) . 


Image 2 . Syntax of a while statement. 


while (conditional expression) 
statement or compound statement; 


Table 2.67 


Behavior of a while statement 
The three pillars of procedural programming are 


e sequence 
e selection 
e loop 


The while statement is commonly used to create a loop structure, often referred to as a while loop 
Once the while statement is encountered in the sequence of code, the program will continue to execute 

the statement or compound statement shown in Image 2 (p. 180) for as long as the conditional expression 

evaluates to true. (Note that a compound statement is created by enclosing two or more statements inside 
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a pair of matching curly brackets, thus creating a block of code as the body of the while statement or 
loop.) 

Sample Java while statement 

The while statement shown in Listing 1 (p. 181) was extracted from a Java program in an earlier 
module. 


Listing 1 . Sample Java while statement. 


while( (chi = System.in.read() ) != °#?) 
ch2 = chi; 


Table 2.68 


The in variable of the System class 

The System class defines a class variable named in . Because it is a class variable, it can be 
accessed using the name of the System class without the requirement to instantiate an object of the 
System class. 

What the in variable contains 

The in variable refers to an instance of a class that provides a read method that returns a character 
from the standard input device (typically the keyboard) . 

Therefore, the expression System.in.read() in Listing 1 (p. 181) constitutes a call to the read 
method of the object referred to by the in variable of the System class. 

A while loop is an entry condition loop 

The while statement is used to form an entry condition loop. The significance of an entry condition 
loop is that the conditional expression is tested before the statements in the loop are executed. If it tests 
false initially, the statements in the loop are never executed. 

The while loop shown in Listing 1 (p. 181) will continue reading characters from the keyboard for as 
long as the character entered is not the # character. (Recall the not equal (!=) operator from an earlier 
module.) 


2.28.4.2 The if-else statement 


The general syntax of an if-else statement is shown in Image 3 (p. 181) . 


Image 3 . Syntax of an if-else statement. 


if (conditional expression) 
statement or compound statement; 
else //optional 
statement or compound statement; //optional 


Table 2.69 


The if-else statement is the most basic of the statements used to control the logical flow of a Java 
program. It is used to satisfy the selection pillar mentioned earlier (p. 180) . 
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This statement will execute a specified block of code if some particular condition is true, and optionally, 
will execute a different block of code if the condition is not true. 

The else clause shown in Image 3 (p. 181) is optional. If it is not provided and the condition is not 
true, control simply passes to the next statement following the If statement with none of the code in the 
body of the if statement being executed. If the condition is true, the code in the body of the if statement 
is executed. 

Ifthe else clause is provided and the condition is true, the code in the body of the if clause is executed 
and the code in the body of the else clause is ignored. 

If the else clause is provided and the condition is false, the code in the body of the if clause is ignored 
and the code in the body of the else clause is executed. 

In all cases, control passes to the next statement following the if-else statement when the code in the 
if-else statement has finished executing. In other words, this is not a loop structure. 


2.28.4.3 The switch-case statement 


The switch-case statement is another implementation of the selection pillar mentioned earlier (p. 180) 
. The general syntax of a switch-case statement is shown in Image 4 (p. 182) . 


Image 4 . Syntax of a switch-case statement. 


switch (expression) { 
case constant: 
//sequence of optional statements 
break; //optional 
case constant: 
//sequence of optional statements 
break; //optional 


default //optional 
//sequence of optional statements 


Table 2.70 


The type of the expression 

According to the book, Java Language Reference , by Mark Grand, the expression shown in the first 

line in Image 4 (p. 182) must be of type byte , char , short , or int 
The behavior of the switch-case statement 

The expression is tested against a series of case constants of the same type as the expression. If a match 
is found, the sequence of optional statements associated with that case is executed. 

Execution of statements continues until the optional break is encountered. When break is encoun- 
tered, execution of the switch statement is terminated and control passes to the next statement following 
the switch statement. 

If there is no break statement, all of the statements following the matching case will be executed 
including those in cases further down the page. 

The optional default keyword 
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If no match is found and the optional default keyword along with a sequence of optional statements has 
been provided, those statements will be executed. 

Labeled break 

Java also supports labeled break statements. This capability can be used to cause Java to exhibit different 
behavior when switch statements are nested. This will be explained more fully in a later section on labeled 
break statements. 


2.28.4.4 The for loop 


The for statement is another implementation of the loop pillar mentioned earlier (p. 180) . 

Actions of a for loop 

The operation of a loop normally involves three actions in addition to executing the code in the body of 
the loop: 


e Initialize a control variable. 
e Test the control variable in a conditional expression. 
e Update the control variable. 


Grouping the actions 
Java provides the for loop construct that groups these three actions in one place. 
The syntax of a for loop 
A for loop consists of three clauses separated by semicolons as shown in Image 5 (p. 183) . 


Image 5 . Syntax of a for loop. 


for (first clause; second clause; third clause) 
single or compound statement 


Table 2.71 


Contents of the clauses 
The first and third clauses can contain one or more expressions, separated by the comma operator 
The comma operator 
The comma operator guarantees that its left operand will be executed before its right operand. 
(While the comma operator has other uses in C++, this is the only use of the comma operator in Java.) 
Behavior and purpose of the first clause 
The expressions in the first clause are executed only once, at the beginning of the loop. Any legal 
expression(s) may be contained in the first clause, but typically the first clause is used for initialization. 
Declaring and initializing variables in the first clause 
Variables can be declared and initialized in the first clause, and this has an interesting ramification 
regarding scope that will be discussed later. 
Behavior of the second clause 
The second clause consists of a single expression that must evaluate to a boolean type with a value 
of true or false. The expression in the second clause must eventually evaluate to false to cause the loop to 
terminate. 
Typically relational expressions or relational and conditional expressions are used in the second clause. 
When the test is performed 
The value of the second clause is tested when the statement first begins execution, and at the beginning 
of each iteration thereafter. Therefore, just like the while loop, the for loop is an entry condition loop 
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When the third clause is executed 

Although the third clause appears physically at the top of the loop, it isn’t executed until the statements 
in the body of the loop have completed execution. 

This is an important point since this clause is typically used to update the control variable, and perhaps 
other variables as well. 

What the third clause can contain 

Multiple expressions can appear in the third clause, separated by the comma operator. Again, those 
expressions will be executed from left to right. If variables are updated in the third clause and used in the 
body of the loop, it is important to understand that they do not get updated until the execution of the body 
is completed. 

Declaring a variable ina for loop 

As mentioned earlier, it is allowable to declare variables in the first clause of a for loop. 

You can declare a variable with a given name outside (prior to) the for loop, or you can declare it 
inside the for loop, but not both. 

If you declare it outside the for loop, you can access it either outside or inside the loop. 

If you declare it inside the loop, you can access it only inside the loop. In other words, the scope of 
variables declared inside a for loop is limited to the loop. 

This is illustrated in following sequence of four simple programs. 

This program won’t compile 

The Java program shown in Listing 2 (p. 184) refuses to compile with a complaint that a variable named 
cnt has already been declared in the method when the attempt is made to declare it in the for loop. 


Listing 2 . A program that won’t compile. 


/*File for1.java Copyright 1997, R.G.Baldwin 

This program will not compile because the variable 

named cnt is declared twice. 

FE AG EEE EEEE EEEE E EEEE EEEE CI IK ak I A 1 21 21 1 4 2 2k 2k a EE 2k 2k a / 

class fori { //define the controlling class 

public static void main(String[] args){ //main method 
int cnt = 5; //declare local method variable 
System. out .print1n( 
"Value of method var named cnt is " + cnt); 


for(int cnt = 0; cnt < 2; cnt++) 
System.out .print1n( 
"Value of loop var named cnt is " + cnt); 


System. out .print1n( 
"Value of method var named cnt is " + cnt); 
}//end main 
}//End controlling class. Note no semicolon required 


Table 2.72 


The program shown in Listing 3 (p. 185) also won’t compile, but for a different reason. 
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Listing 3 . Another program that won’t compile. 


/*File for2.java Copyright 1997, R.G.Baldwin 
This program will not compile because the variable 
declared inside the for loop is not accessible 
outside the loop. 
FE A AG EEE EEEE EEEE E EEEE EEEE I I Kk I A 1 21 21 2 4 24 2k 2k a fk 2k 2k a / 
class for2 { //define the controlling class 

public static void main(String[] args){ //main method 


for(int cnt = 0; cnt < 2; cnt++) 
System.out .print1n( 
"Value of loop var named cnt is " + cnt); 


System. out .print1n( 
"Value of method var named cnt is " + cnt); 
}//end main 
}//End controlling class. Note no semicolon required 


Table 2.73 


The declaration of the variable named cnt , outside the for loop, was removed from Listing 3 (p. 
185) and the declaration inside the loop was allowed to remain. This eliminated the problem of attempting 
to declare the variable twice. 

However, this program refused to compile because an attempt was made to access the variable named 
cnt outside the for loop. This was not allowed because the variable was declared inside the for loop and 
the scope of the variable was limited to the loop. 

This program will compile 

The Java program shown in Listing 4 (p. 185) will compile and run because the variable named cnt 
that is declared inside the for loop is accessed only inside the for loop. No reference to a variable with 
the same name appears outside the loop. 


Listing 4 . A program that will compile. 


/*File for3.java Copyright 1997, R.G.Baldwin 
This program will compile because the variable declared 
inside the for loop is accessed only inside the loop. 
FE A AG EEE EEEE EEEE E EEEE EE EEEE 21 21 1 EE 21 21 EE 4 2k 2k ak E EE 2 a ak kak // 
class for3 { //define the controlling class 

public static void main(String[] args){ //main method 


for(int cnt = 0; cnt < 2; cnt++) 
System.out .print1n( 
"Value of loop var named cnt is " + cnt); 
}//end main 
}//End controlling class. 
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Table 2.74 


This program will also compile 

Similarly, the program shown in Listing 5 (p. 186) will compile and run because the variable named 
cnt was declared outside the for loop and was not declared inside the for loop. This made it possible 
to access that variable both inside and outside the loop. 


Listing 5 . Another program that will compile. 


/*File for4.java Copyright 1997, R.G.Baldwin 
This program will compile and run because the variable 
named cnt is declared outside the for loop and is not 
declared inside the for loop. 
FA AAG EEE EEEE EEEE E EEEE EE AI I I I I kK EE 1 21 EE 4 21 2k 2k af 2k 2 ak ak kak // 
class for4 { //define the controlling class 
public static void main(String[] args){ //main method 
int cnt = 5; //declare local method variable 
System. out .print1n( 
"Value of method var named cnt is " + cnt); 


for(cnt = 0; cnt < 2; cnt++) 
System.out .print1n( 
"Value of loop var named cnt is " + cnt); 


System. out .print1n( 
"Value of method var named cnt is " + cnt); 
}//end main 
}//End controlling class. Note no semicolon required 


Table 2.75 


Empty clauses ina for loop 

The first and third clauses in a for loop can be left empty but the semicolons must be there as 
placeholders. 

One author suggests that even the middle clause can be empty, but it isn’t obvious to this author how 
the loop would ever terminate if there is no conditional expression to be evaluated. Perhaps the loop could 
be terminated by using a break inside the loop, but in that case, you might just as well use a while loop. 


2.28.4.5 The for-each loop 


There is another form of loop structure that is often referred to as a for-each loop. In order to appreciate 
the benefits of this loop structure, you need to be familiar with Java collections and iterators, both of which 
are beyond the scope of this module. 

As near as I can tell, there is nothing that you can do with the for-each loop that you cannot also do 
with the conventional for loop described above. Therefore, I rarely use it. You can find a description of 
the for-each loop on this Oracle website ®° . 

I don’t plan to discuss it further in this module. However, before you go for a job interview, you should 
probably do some online research and learn about it because an interviewer could use a question about the 
for-each loop to trip you up in the Q and A portion of the interview. 


85http://docs.oracle.com/javase/1.5.0/docs/guide/language/foreach.html 
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2.28.4.6 The do-while loop 


The do-while loop is another implementation of the loop pillar mentioned earlier (p. 180) . However, it 
differs from the while loop and the for loop in one important respect; it is an exit-condition loop. 
An exit-condition loop 
Java provides an exit-condition loop having the syntax shown in Image 6 (p. 187) . 


Image 6 . Syntax of a do-while loop. 


do { 
statements 
} while (conditional expression); 


Table 2.76 


Behavior 

The statements in the body of the loop continue to be executed for as long as the conditional expression 
evaluates to true. An exit-condition loop guarantees that the body of the loop will be executed at least one 
time, even if the conditional expression evaluates to false the first time it is tested. 


2.28.4.7 The break and continue statements 


General behavior 

Although some authors suggest that the break and continue statements provide an alternative to the 
infamous goto statement of earlier programming languages, it appears that the behaviors of the labeled 
break and labeled continue statements are much more restrictive than a general goto 


2.28.4.8 Unlabeled break and continue 


The break and continue statements are supported in both labeled and unlabeled form. 

First consider the behavior of break and continue in their unlabeled configuration. 

Use of a break statement 

The break statement can be used in a switch statement or in a loop. When encountered in a switch 
statement, break causes control to be passed to the next statement outside the innermost enclosing switch 
statement. 

When break is encountered in a loop, it causes control to be passed to the next statement outside the 
innermost enclosing loop. 

As you will see later, labeled break statements can be used to pass control to the next statement following 
switch or loop statements beyond the innermost switch or loop statement when those statements are nested. 

Use of a continue statement 

The continue statement cannot be used in a switch statement, but can be used inside a loop. 

When an unlabeled continue statement is encountered, it causes the current iteration of the current loop 
to be terminated and the next iteration to begin. 

A labeled continue statement can cause control to be passed to the next iteration of an outer enclosing 
loop in a nested loop situation. 

An example of the use of an unlabeled switch statement is given in the next section. 


2.28.4.9 Labeled break and continue statements 


This section discusses the use of labeled break and continue statements. 
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2.28.4.9.1 Labeled break Statements 


One way to describe the behavior of a labeled break in Java is to say: "Break all the way out of the labeled 
statement." 

Syntax of a labeled statement 

To begin with, the syntax of a labeled statement is a label followed by a colon ahead of the statement as 
shown in Image 7 (p. 188) . 


Image 7 . Syntax of a labeled statement. 


myLabel: myStatement; 


Table 2.77 


The label can be any legal Java identifier. 

Behavior of labeled break 

The behavior of a labeled break can best be illustrated using nested switch statements. For a comparison 
of labeled and unlabeled switch statements, consider the program shown in Listing 6 (p. 189) named 
switch1 , which does not use a labeled break. Even though this program has a labeled statement, that 
statement is not referenced by a break . Therefore, the label is of no consequence. 
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Listing 6 . The program named switch1.java. 


/*File switch1.java 

This is a Java application which serves as a baseline 
comparison for switch2.java which uses a labeled break. 
Note that the program uses nested switch statements. 


The program displays the following output: 


Match and break from here 
Case 6 in outer switch 
Default in outer switch 
Beyond switch statements 


FOCUS IOS IIIS III II II I A I A I Ak A EEEE EEEN 
class switchi { //define the controlling class 
public static void main(String[] args){ //main method 


//Note that the following labeled switch statement is 
// not referenced by a labeled break in this program. 
// It will be referenced in the next program. 
outerSwitch: switch(5){//labeled outer switch statement 
case 5: //execute the following switch statement 
//Note that the code for this case is not followed 
// by break. Therefore, execution will fall through 
// the case 6 and the default. 
switch(1){ //inner switch statement 
case 1: System.out.println( 
"Match and break from here"); 
break; //break with no label 
case 2: System.out.println( 
"No match for this constant"); 
break; 
}//end inner switch statement 


case 6: System.out.println("Case 6 in outer switch"); 
default: System. out.println( 
"Default in outer switch"); 
}//end outer switch statement 


System.out.println("Beyond switch statements"); 
}//end main 
}//End switch1 class. 


Table 2.78 


After reviewing switchl.java , consider the same program named switch2.java shown in Listing 7 
(p. 190) , which was modified to use a labeled break. 

The outputs from both programs are shown in the comments at the beginning of the program. By 
examining the second program, and comparing the output from the second program with the first program, 
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you should be able to see how the use of the labeled break statement causes control to break all the way out 
of the labeled switch statement. 


Listing 7 . The program named switch2.java. 


/*File switch2.java 
This is a Java application which uses a labeled break. 
Note that the program uses nested switch statements. 


See switchi.java for a comparison program which does not 
use a labeled break. 


The program displays the following output: 


Match and break from here 
Beyond switch statements 
BOSSA OAS I I II AI II I II I ICI IAI I I IK I fA IK 1 4 2K 2k EEEE EEE EEEN 
class switch2 { //define the controlling class 
public static void main(String[] args){ //main method 


outerSwitch: switch(5){//labeled outer switch statement 
case 5: //execute the following switch statement 
//Note that the code for this case is not followed by 
// break. Therefore, except for the labeled break at 
// case 1, execution would fall through the case 6 and 
// the default as demonstrated in the program named 
// switchi. However, the use of the labeled break 
// causes control to break all the way out of the 
// labeled switch bypassing case 6 and the default. 
switch(1){ //inner switch statement 
case 1: System. out.println( 
"Match and break from here"); 
break outerSwitch; //break with label 
case 2: System.out.println( 
"No match for this constant"); 
break; 
}//end inner switch statement 


case 6: System.out.printl1n( 
"Case 6 in outer switch"); 
default: System.out.println("Default in outer switch"); 
}//end outer switch statement 


System.out.println("Beyond switch statements"); 
}//end main 
}//End switchi class. 


Table 2.79 
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The modified program in Listing 7 (p. 190) uses a labeled break statement in the code group for case 1 
whereas the original program in Listing 6 (p. 189) has an unlabeled break in that position. 

By comparing the output from this program with the output from the previous program, you can see 
that execution of the labeled break statement caused control to break all the way out of the labeled switch 
statement completely bypassing case 6 and default. 

As you can see from examining the output, the labeled break statement causes the program to break all 
the way out of the switch statement which bears a matching label. 

A similar situation exists when a labeled break is used in nested loops with one of the enclosing outer 
loops being labeled. Control will break out of the enclosing loop to which the labeled break refers. It will 
be left as an exercise for the student to demonstrate this behavior to his or her satisfaction. 


2.28.4.9.2 Labeled continue statements 


Now consider use of the labeled continue statement. A continue statement can only be used in a loop; 
it cannot be used in a switch. The behavior of a labeled continue statement can be described as follows: 
"Terminate the current iteration and continue with the next iteration of the loop to which the label refers." 

Again, it will be left as an exercise for the student to demonstrate this behavior to his or her satisfaction. 


2.28.4.10 The return statement 


Use of the return statement 

Java supports the use of the return statement to terminate a method and (optionally) return a value 
to the calling method. 

The return type 

The type of value returned must match the type of the declared return value for the method. 

The void return type 

If the return value is declared as void , you can use the syntax shown in Image 8 (p. 191) to terminate 
the method. (You can also simply allow the method to run out of statements to execute.) 


Image 8 . An empty return statement. 


return; 


Table 2.80 


Returning a value 
If the method returns a value, follow the word return with an expression (or constant) that evaluates 
to the value being returned as shown in Image 9 (p. 191) . 


Image 9 . Returning a value from a method. 


return x+y; 


Table 2.81 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


191 


Return by value only 

You are allowed to return only by value . In the case of primitive types, this returns a copy of the 
returned item. In the case of objects, returning by value returns a copy of the object’s reference. 

What you can do with a copy the object’s reference 

Having a copy of the reference is just as good as having the original reference. A copy of the reference 
gives you access to the object. 

When Java objects are destroyed 

All objects in Java are stored in dynamic memory and that memory is not overwritten until all references 
to that memory cease to exist. 

Java uses a garbage collector running on a background thread to reclaim memory from objects that have 
become eligible for garbage collection . 

An object becomes eligible for garbage collection when there are no longer any variables, array elements, 
or similar storage locations containing a reference to the object. In other words, it becomes eligible when 
there is no way for the program code to find a reference to the object. 


2.28.4.11 Exception handling 


Exception handling is a process that modifies the flow of control of a program, so it merits being mentioned 
in this module. However, it is a fairly complex topic, which will be discussed in detail in future modules. 

Suffice it at this point to say that whenever an exception is detected, control is transferred to exception 
handler code if such code has been provided. Otherwise, the program will terminate. Thus, the exception 
handling system merits being mentioned in discussions regarding flow of control. 


2.28.5 Looking ahead 


As you approach the end of this group of Programming Fundamentals modules, you should be preparing 
yourself for the more challenging ITSE 2321 OOP tracks identified below: 


e Java OOP: The Guzdial-Ericson Multimedia Class Library *¢ 
e Java OOP: Objects and Encapsulation °” 


2.28.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0230: Java OOP: Flow of Control 
e File: Jb0230.htm 

e Originally published: 1997 

e Published at cnx.org: 11/24/12 

e Revised: 12/04/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


8http://cnx.org/content /m44148 
87http://cnx.org/content /m44153 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.29 Jb0230r Review™ 


2.29.1 Table of Contents 


e Preface (p. 194) 
e Questions (p. 194) 


1 (p. 194) , 2 (p. 194) , 3 (p. 194) , 4 (p. 194) , 5 (p. 194) , 6 (p. 195) , 7 (p. 195) , 8 (p. 195) , 
9 (p. 195) , 10 (p. 195) , 11 (p. 195) , 12 (p. 199) , 13 (p. 195) , 14 (p. 195) , 15 (p. 195) , 16 
(p. 196) , 17 (p. 196) , 18 (p. 196) , 19 (p. 196) , 20 (p. 196) , 21 (p. 196) 


e Answers (p. 198) 
e Miscellaneous (p. 201) 


2.29.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0230: Java OOP: Flow of 
Control 8° . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.29.3 Questions 
2.29.3.1 Question 1 
List. and describe eight of the statements used in Java programs to alter or control the logical flow of the 
program. 
Answer 1 (p. 201) 
2.29.3.2 Question 2 
Provide pseudo-code that illustrates the general syntax of a while statement. 
Answer 2 (p. 201) 
2.29.3.3 Question 3 


True or false? During the execution of a while statement, the program will continue to execute the 
statement or compound statement for as long as the conditional expression evaluates to true, or until a 
break , continue ,or return statement is encountered. If false, explain why. 

Answer 3 (p. 201) 


2.29.3.4 Question 4 

True or false? A while loop is an entry condition loop. If false, explain why. 
Answer 4 (p. 200) 

2.29.3.5 Question 5 


What is the significance of an entry condition loop? 
Answer 5 (p. 200) 


88This content is available online at <http://cnx.org/content /m45218/1.6/>. 
89http://cnx.org/content /m45196 
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2.29.3.6 Question 6 

Provide pseudo-code illustrating the general syntax of the if-else statement. 
Answer 6 (p. 200) 

2.29.3.7 Question 7 

Provide pseudo-code illustrating the general syntax of the switch-case statement. 
Answer 7 (p. 200) 

2.29.3.8 Question 8 

Describe the behavior of a switch-case statement. Provide a pseudo-code fragment that illustrates your 

description of the behavior. Do not include a description of labeled break statements. 
Answer 8 (p. 199) 

2.29.3.9 Question 9 


What are the three actions normally involved in the operation of a loop (in addition to executing the code 
in the body of the loop) ? 
Answer 9 (p. 199) 
2.29.3.10 Question 10 
True or false? A for loop header consists of three clauses separated by colons. If false, explain why. 
Answer 10 (p. 199) 
2.29.3.11 Question 11 
Provide pseudo-code illustrating the general syntax of a for loop 
Answer 11 (p. 199) 
2.29.3.12 Question 12 
True or false? In a for loop, the first and third clauses within the parentheses can contain one or more 
expressions, separated by the comma operator. If False, explain why. 
Answer 12 (p. 199) 
2.29.3.13 Question 13 
What is the guarantee made by the comma operator ? 
Answer 13 (p. 198) 
2.29.3.14 Question 14 


True or false? The expressions within the first clause in the parentheses in a for loop are executed only 
once during each iteration of the loop. If false, explain why. 
Answer 14 (p. 198) 


2.29.3.15 Question 15 


While any legal expression(s) may be contained in the first clause within the parentheses of a for loop, the 
first clause has a specific purpose. What is that purpose? 
Answer 15 (p. 198) 
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2.29.3.16 Question 16 


True or false? Variables can be declared and initialized within the first clause in the parentheses of a for 
loop. If false, explain why. 
Answer 16 (p. 198) 


2.29.3.17 Question 17 


True or false? The second clause in the parentheses of a for loop consists of a single expression which must 
eventually evaluate to true to cause the loop to terminate. If false, explain why. 
Answer 17 (p. 198) 


2.29.3.18 Question 18 


True or false? A for loop is an exit condition loop. If false, explain why. 
Answer 18 (p. 198) 


2.29.3.19 Question 19 


True or false? Because a for loop is an entry condition loop, the third clause inside the parentheses is 
executed at the beginning of each iteration. If false, explain why. 
Answer 19 (p. 198) 


2.29.3.20 Question 20 


True or false? A return statement is used to terminate a method and (optionally) return a value to the 
calling method. If False, explain why. 
Answer 20 (p. 198) 


2.29.3.21 Question 21 


True or false? Exception handling modifies the flow of control of a Java program. If false, explain why. 

Answer 21 (p. 198) 

What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 
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None KEX] 


Display your namet 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


197 


2.29.4 Answers 
2.29.4.1 Answer 21 
True. 

Back to Question 21 (p. 196) 
2.29.4.2 Answer 20 
True. 

Back to Question 20 (p. 196) 
2.29.4.3 Answer 19 


False. Although the third clause appears physically at the top of the loop, it isn’t executed until the 
statements in the body of the loop have completed execution. This is an important point since this clause is 
typically used to update the control variable, and perhaps other variables as well. If variables are updated 
in the third clause and used in the body of the loop, it is important to understand that they do not get 
updated until the execution of the body is completed. 

Back to Question 19 (p. 196) 


2.29.4.4 Answer 18 


False. The value of the second clause is tested when the statement first begins execution, and at the beginning 
of each iteration thereafter. Therefore, the for loop is an entry condition loop. 

Back to Question 18 (p. 196) 
2.29.4.5 Answer 17 


False. The second clause consists of a single expression which must eventually evaluate to false (not true) 
to cause the loop to terminate. 
Back to Question 17 (p. 196) 
2.29.4.6 Answer 16 
True. 
Back to Question 16 (p. 196) 
2.29.4.7 Answer 15 
Typically the first clause is used for initialization. The intended purpose of the first clause is initialization. 
Back to Question 15 (p. 195) 
2.29.4.8 Answer 14 


False. The expressions in the first clause are executed only once, at the beginning of the loop, regardless of 
the number of iterations. 

Back to Question 14 (p. 195) 
2.29.4.9 Answer 13 


The comma operator guarantees that its left operand will be executed before its right operand. 
Back to Question 13 (p. 195) 
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2.29.4.10 Answer 12 
True. 

Back to Question 12 (p. 195) 
2.29.4.11 Answer 11 


The general syntax of a for loop follows: 


Syntax of a for loop 


for (first clause; second clause; third clause) 
single or compound statement 


Back to Question 11 (p. 195) 


2.29.4.12 Answer 10 

False: A for loop header consists of three clauses separated by semicolons, not colons. 
Back to Question 10 (p. 195) 

2.29.4.13 Answer 9 


The operation of a loop normally involves the following three actions in addition to executing the code in 
the body of the loop: 


e Initialize a control variable. 
e Test the control variable in a conditional expression. 
e Update the control variable. 


Back to Question 9 (p. 195) 


2.29.4.14 Answer 8 


The pseudo-code fragment follows: 


Syntax of a switch-case statement 


switch (expression) { 
case constant: 
sequence of optional statements 
break; //optional 
case constant: 
sequence of optional statements 
break; //optional 


default //optional 
sequence of optional statements 
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An expression is tested against a series of unique integer constants. If a match is found, the sequence of 
optional statements associated with the matching constant is executed. Execution of statements continues 
until an optional break is encountered. When break is encountered, execution of the switch statement 
is terminated and control is passed to the next statement following the switch statement. 

If no match is found and the optional default keyword along with a sequence of optional statements 
has been provided, those statements will be executed. 

Back to Question 8 (p. 195) 


2.29.4.15 Answer 7 


The general syntax of the switch-case statement follows: 


Syntax of a switch-case statement 


switch (expression) { 
case constant: 
sequence of optional statements 
break; //optional 
case constant: 
sequence of optional statements 
break; //optional 


default //optional 
sequence of optional statements 


} 


Back to Question 7 (p. 195) 


2.29.4.16 Answer 6 
The general syntax of the if-else statement is: 


Syntax of an if-else statement 


if (conditional expression) 
statement or compound statement; 
else //optional 
statement or compound statement; //optional 


Back to Question 6 (p. 195) 


2.29.4.17 Answer 5 


The significance of an entry condition loop is that the conditional expression is tested before the statements 
in the loop are executed. If it tests false initially, the statements in the loop will not be executed. 
Back to Question 5 (p. 194) 
2.29.4.18 Answer 4 
True. 
Back to Question 4 (p. 194) 
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2.29.4.19 Answer 3 


True. Note however that including a return statement inside a while statement is probably considered 
poor programming practice. 
Back to Question 3 (p. 194) 


2.29.4.20 Answer 2 
The general syntax of a while statement follows : 


Syntax of a while statement 
while (conditional expression) 
statement or compound statement; 


Back to Question 2 (p. 194) 


2.29.4.21 Answer 1 


The following table lists the statements supported by Java for controlling the logical flow of the program. 


Flow of control statements 


Statement Typeif-else selection 
switch-case selection 

for loop 

for-each loop 

while loop 

do-while loop 

try-catch-finally exception handling 

throw exception handling 

break miscellaneous 

continue miscellaneous 

label: miscellaneous 

return miscellaneous 

goto reserved by Java but not supported 


Back to Question 1 (p. 194) 


2.29.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0230r Review: Flow of Control 
e File: Jb0230r.htm 

e Originally published: 1997 

e Published at cnx.org: 11/25/12 

e Revised: 12/05/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.30 Jb0240: Java OOP: Arrays and Strings” 


2.30.1 Table of Contents 


e Preface (p. 202) 
Viewing tip (p. 203) 
x Images (p. 203) 
x Listings (p. 203) 
Introduction (p. 203) 
Arrays (p. 203) 
Arrays of Objects (p. 210) 
Strings (p. 212) 
String Concatenation (p. 212) 
Arrays of String References (p. 212) 


Run the programs (p. 213) 
Looking ahead (p. 213) 
Miscellaneous (p. 214) 


2.30.2 Preface 


This module takes a preliminary look at arrays and strings. More in-depth discussions will be provided in 
future modules. For example, you will find a more in-depth discussions of array objects in the following 
modules: 


e Java OOP: Array Objects, Part 1 °! 
e Java OOP: Array Objects, Part 2 °? 
e Java OOP: Array Objects, Part 3 °° 


°°This content is available online at <http://cnx.org/content /m45214/1.5/>. 
®lhttp://cnx.org/content /m44198 
°*2http://cnx.org/content /m44199 
®*3http://cnx.org/content /m44200 
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2.30.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


2.30.2.1.1 Images 


e Image 1 (p. 204) . Formats for declaring a reference variable for an array object. 

e Image 2 (p. 204) . Allocating memory for the array object. 

e Image 3 (p. 204) . Declaration and instantiation can be separated. 

e Image 4 (p. 205) . General syntax for combining declaration and instantiation. 

e Image 5 (p. 205) . An example of array indexing syntax. 

e Image 6 (p. 205) . The use of the length property in the conditional clause of a for loop. 
e Image 7 (p. 212) . A string literal. 

e Image 8 (p. 212) . String concatenation. 

e Image 9 (p. 213) . Declaring and instantiating a String array. 

e Image 10 (p. 213) . Allocating memory to contain the String objects. 


2.30.2.1.2 Listings 


e Listing 1 (p. 207) . The program named array01. 
e Listing 2 (p. 209) . The program named array02. 
e Listing 3 (p. 211) . The program named array03. 


2.30.3 Introduction 


The first step 

The first step in learning to use a new programming language is usually to learn the foundation concepts 
such as variables, types, expressions, flow-of-control, arrays, strings, etc. This module concentrates on arrays 
and strings. 

Array and String types 

Java provides a type for both arrays and strings from which objects of the specific type can be instantiated. 
Once instantiated, the methods belonging to those types can be called by way of the object. 


2.30.4 Arrays 


Arrays and Strings 

Java has a true array type and a true String type with protective features to prevent your program 
from writing outside the memory bounds of the array object or the String object. Arrays and strings are 
true objects. 

Declaring an array 

You must declare an array before you can use it. (More properly, you must declare a reference variable 
to hold a reference to the array object.) In declaring the array, you must provide two important pieces of 
information: 


e the name of a variable to hold a reference to the array object 
e the type of data to be stored in the elements of the array object 


Different declaration formats 
A reference variable capable of holding a reference to an array object can be declared using either format 
shown in Image 1 (p. 204) . 
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Image 1 . Formats for declaring a reference variable for an array object. 


int[] myArray; 
int myArray[]; 


Table 2.82 


Declaration does not allocate memory 

As with other objects, the declaration of the reference variable does not allocate memory to contain the 
array data. Rather it simply allocates memory to contain a reference to the array. 

Allocating memory for the array object 

Memory to contain the array object must be allocated from dynamic memory using statements such as 
those shown in Image 2 (p. 204) . 


Image 2 . Allocating memory for the array object. 


int[] myArrayX = new int[15]; 
int myArrayY[] = new int[25]; 


int[] myArrayZ = {3,4,5}; 


Table 2.83 


The statements in Image 2 (p. 204) simultaneously declare the reference variable and cause memory to 
be allocated to contain the array. 

Also note that the last statement in Image 2 (p. 204) is different from the first two statements. This 
syntax not only sets aside the memory for the array object, the elements in the array are initialized by 
evaluating the expressions shown in the coma-separated list inside the curly brackets. 

On the other hand, the array elements in the first two statements in Image 2 (p. 204) are automatically 
initialized with the default value for the type. 

Declaration and allocation can be separated 

It is not necessary to combine these two processes. You can execute one statement to declare the reference 
variable and another statement to cause the array object to be instantiated some time later in the program 
as shown in Image 3 (p. 204) . 


Image 3 . Declaration and instantiation can be separated. 


int[] myArray; 


myArray = new int[25]; 


Table 2.84 
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Causing memory to be set aside to contain the array object is commonly referred to as instantiating the 
array object (creating an instance of the array object) . 

If you prefer to declare the reference variable and instantiate the array object at different points in your 
program, you can use the syntax shown in Image 3 (p. 204) . This pattern is very similar to the declaration 
and instantiation of all objects. 

General syntax for combining declaration and instantiation 
The general syntax for declaring and instantiating an array object is shown in Image 4 (p. 205) . 


Image 4 . General syntax for combining declaration and instantiation. 


typeOfElements[] nameOfRefVariable = 
new typeOfElements[sizeOfArray] 


Table 2.85 


Accessing array elements 
Having instantiated an array object, you can access the elements of the array using indexing syntax that 


is similar to many other programming languages. An example is shown in Image 5 (p. 205) . 


Image 5 . An example of array indexing syntax. 


myArray[5] = 6; 


myVar = myArray[5]; 


Table 2.86 


The value of the first index 

Array indices always begin with 0. 

The length property of an array 

The code fragment in Image 6 (p. 205) illustrates another interesting aspect of arrays. (Note the use of 
length in the conditional clause of the for loop.) 


Image 6 . The use of the length property in the conditional clause of a for loop. 


for(int cnt = 0; cnt < myArray.length; cnt++) 
myArray[cnt] = cnt; 


Table 2.87 


All array objects have a length property that can be accessed to determine the number of elements in 
the array. (The number of elements cannot change once the array object is instantiated. ) 
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Types of data that you can store in an array object 
Array elements can contain any Java data type including primitive values and references to ordinary 
objects or other array objects. 
Constructing multi-dimensional arrays 
All array objects contains a one-dimensional array structure. You can create multi-dimensional arrays 
by causing the elements in one array object to contain references to other array objects. In effect, you can 
create a tree structure of array objects that behaves like a multi-dimensional array. 
Odd-shaped multi-dimensional arrays 
The program array01 shown in Listing 1 (p. 207) illustrates an interesting aspect of the Java arrays. 
Java can produce multi-dimensional arrays that can be thought of as an array of arrays. However, the 
secondary arrays need not all be of the same size. 
In the program shown in Listing 1 (p. 207) , a two-dimensional array of integers is declared and instanti- 
ated with the primary size (size of the first dimension) being three. The sizes of the secondary dimensions 
(sizes of each of the sub-arrays) is 2, 3, and 4 respectively. 
Can declare the size of secondary dimension later 
When declaring a two-dimensional array, it is not necessary to declare the size of the secondary dimension 
when the primary array is instantiated. Declaration of the size of each sub-array can be deferred until later 
as illustrated in this program. 
Accessing an array out-of-bounds 
This program also illustrates the result of attempting to access an element that is out-of-bounds. Java 
protects you from such programming errors. 
ArrayIndexOutOfBoundsException 
An exception occurs if you attempt to access out-of-bounds, as shown in the program in in Listing 1 (p. 
207) . 
In this case, the exception was simply allowed to cause the program to terminate. The exception could 
have been caught and processed by an exception handler, a concept that will be explored in a future module. 
The program named array01 
The entire program is shown in Listing 1 (p. 207) . The output from the program is shown in the 
comments at the top of the listing. 
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Listing 1 . The program named array01. 


/*File array01.java Copyright 1997, R.G.Baldwin 
Illustrates creation and manipulation of two-dimensional 
array with the sub arrays being of different lengths. 


Also illustrates detection of exception when an attempt is 
made to store a value out of the array bounds. 


This program produces the following output: 


00 

012 

0246 

Attempt to access array out of bounds 

java.lang.ArrayIndexOutOfBoundsException: 
at arrayO1.main(array01.java: 47) 


BOSSA ORAS IOI I II I II AI ICI IRI I I IK I Fk IK 1 4 21 2k 24 21 2K EEEE EEEN 
class array01 { //define the controlling class 
public static void main(String[] args){ //main method 

//Declare a two-dimensional array with a size of 3 on 
// the primary dimension but with different sizes on 
// the secondary dimension. 
//Secondary size not specified initially 
int[][] myArray = new int[3][]; 
myArray[0] = new int[2];//secondary size is 2 
myArray[1] = new int[3];//secondary size is 3 
myArray[2] = new int[4];//secondary size is 4 


//Fill the array with data 
for(int i = 0; i < 3; i++){ 
for(int j = 0; j < myArray[i].length; j++){ 
myArray[i] [j] = i * j; 
}//end inner loop 
}//end outer loop 


//Display data in the array 
for(int i = 0; i < 3; i++){ 
for(int j = 0; j < myArray[i].length; j++){ 
System. out . print (myArray [i] [j]); 
}//end inner loop 
System.out.println(); 
}//end outer loop 


//Attempt to access an out-of-bounds array element 
System. out .print1n( 

"Attempt to access array out of bounds"); 
myArray[4] [0] = 7; 
//The above statement produces an ArrayIndex0utO0fBounds 
// exception. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


}//end main 
}//End array01 class. 


207 


Table 2.88 


Assigning one array to another array — be careful 

Java allows you to assign one array to another. You must be aware, however, that when you do this, you 
are simply making another copy of the reference to the same data in memory. 

Then you simply have two references to the same data in memory, which is often not a good idea. This 
is illustrated in the program named array02 shown in Listing 2 (p. 209) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


208 CHAPTER 2. PROGRAMMING FUNDAMENTALS 


Listing 2 . The program named array02. 


/*File array02.java Copyright 1997, R.G.Baldwin 
Illustrates that when you assign one array to another 
array, you end up with two references to the same array. 


The output from running this program is: 


firstArray contents 

012 

secondArray contents 

012 

Change a value in firstArray and display both again 

firstArray contents 

0 10 2 

secondArray contents 

0 10 2 

FA AG EEE EEEE EEEE E EEEE EE aI I I I EE EEE 21 21 21 1 4 21 2k 2k E EE E ak ak kak // 

class array02 { //define the controlling class 
int[] firstArray; 
int[] secondArray; 


array02() {//constructor 
firstArray = new int[3]; 
for(int cnt = 0; cnt < 3; cnt++) firstArray[cnt] = cnt; 


secondArray = new int[3]; 
secondArray = firstArray; 
3//end constructor 


public static void main(String[] args){//main method 
array02 obj = new array02(); 
System.out.println( "firstArray contents" ); 
for(int cnt = 0; cnt < 3; cnt++) 
System.out.print(obj.firstArray[cnt] + " " ); 
System. out.println() ; 


System.out.println( "secondArray contents" ); 
for(int cnt = 0; cnt < 3; cnt++) 
System.out.print(obj.secondArray[cnt] +" " ); 


System. out.println(); 
System. out .print1n( 

"Change value in firstArray and display both again"); 
obj.firstArray[1] = 10; 


System.out.println( "firstArray contents" ); 
for(int cnt = 0; cnt < 3; cnt++) 

System.out.print(obj.firstArray[cnt] + " " ); 
System. out.println() ; 


System. out .printihpe second amnayxican temps)! ch%.org/content /coll1441/1.181> 
for(int cnt = 0; cnt < 3; cnt++) 
System.out.print(obj.secondArray[cnt] +" " ); 


Svstem.out.printin(); 
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Table 2.89 


2.30.5 Arrays of Objects 


An array of objects really isn’t an array of objects 

There is another subtle issue that you need to come to grips with before we leave our discussion of arrays. 
In particular, when you create an array of objects, it really isn’t an array of objects. 

Rather, it is an array of object references (or null) . When you assign primitive values to the elements 
in an array object, the actual primitive values are stored in the elements of the array. 

However, when you assign objects to the elements in an array , the actual objects aren’t actually stored 
in the array elements. Rather, the objects are stored somewhere else in memory. The elements in the array 
contain references to those objects. 

All the elements in an array of objects need not be of the same actual type 

The fact that the array is simply an array of reference variables has some interesting ramifications. For 
example, it isn’t necessary that all the elements in the array be of the same type, provided the reference 
variables are of a type that will allow them to refer to all the different types of objects. 

For example, if you declare the array to contain references of type Object , those references can refer 
to any type of object (including array objects) because a reference of type Object can be used to refer 
to any object. 

You can do similar things using interface types. I will discuss interface types in a future module. 

Often need to downcast to use an Object reference 

If you store all of your references as type Object , you will often need to downcast the references to 
the true type before you can use them to access the instance variables and instance methods of the objects. 

Doing the downcast no great challenge as long as you can decide what type to downcast them to. 

The Vector class 

There is a class named Vector that takes advantage of this capability. An object of type Vector is 
a self-expanding array of reference variables of type Object . You can use an object of type Vector to 
manage a group of objects of any type, either all of the same type, or mixed. 

(Note that you cannot store primitive values in elements of a non-primitive or reference type. If you 
need to do that, you will need to wrap your primitive values in an object of a wrapper class as discussed in 
an earlier module.) 

A sample program using the Date class 

The sample program, named array03 and shown in Listing 3 (p. 211) isn’t quite that complicated. 
This program behaves as follows: 


Declare a reference variable to an array of type Date . (The actual type of the variable is Datel].) 
Instantiate a three-element array of reference variables of type Date 
Display the contents of the array elements and confirm that they are all null as they should be. 
(When created using this syntax, new array elements contain the default value, which is null for 
reference types.) 

e Instantiate three objects of type Date and store the references to those objects in the three elements 
of the array. 

e Access the references from the array and use them to display the contents of the individual Date 
objects. 


As you might expect from the name of the class, each object contains information about the date. 
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Listing 3 . The program named Array03. 


/*File array03.java Copyright 1997, R.G.Baldwin 
Illustrates use of arrays with objects. 


Illustrates that "an array of objects" is not really an 
array of objects, but rather is an array of references 
to objects. The objects are not stored in the array, 
but rather are stored somewhere else in memory and the 
references in the array elements refer to them. 


The output from running this program is: 


myArrayOfRefs contains 
null 
null 
null 


myArrayOfRefs contains 

Sat Dec 20 16:56:34 CST 1997 

Sat Dec 20 16:56:34 CST 1997 

Sat Dec 20 16:56:34 CST 1997 

FEA EEEE EEE EEEE EEEE E EEEE EE I I I I EEE EE 21 21 21 1 4 21 21 2k a 4 2k E ak EE EA 
import java.util.*; 


class array03 { //define the controlling class 
Date[] myArrayOfRefs; //Declare reference to the array 


array03() {//constructor 
//Instantiate the array of three reference variables 
// of type Date. They will be initialized to null. 
myArrayOfRefs = new Date[3]; 


//Display the contents of the array. 
System.out.println( "myArrayOfRefs contains" ); 
for(int cnt = 0; cnt < 3; cnt++) 

System.out.println(this.myArray0fRefs[cnt]) ; 
System. out.println(); 


//Instantiate three objects and assign references to 
// those three objects to the three reference 
// variables in the array. 
for(int cnt = 0; cnt < 3; cnt++) 
myArrayOfRefs[cnt] = new Date(); 


}//end constructor 


public static void main(String[] args){//main method 
array03 obj = new array03(); 
System. out .printipe imyAcnayQiRefions emtee dig /content /coll1441/1.181> 
for(int cnt = 0; cnt < 3; cnt++) 
System.out.println(obj.myArrayOfRefs[cnt]); 
System. out.println() ; 
}//end main 
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Table 2.90 


2.30.6 Strings 


What is a string? 

A string is commonly considered to be a sequence of characters stored in memory and accessible as a 
unit. 

Java implements strings using the String class and the StringBuffer class. 

What is a string literal? 

Java considers a series of characters surrounded by quotation marks as shown in Image 7 (p. 212) to be 
a string literal. 


Image 7 . A string literal. 


"This is a string literal in Java." 


Table 2.91 


This is just an introduction to strings 
A major section of a future module will be devoted to the topic of strings, so this discussion will be brief. 
String objects cannot be modified 
String objects cannot be changed once they have been created. If you have that need, use the 
StringBuffer class instead. 
StringBuffer objects can be used to create and manipulate character data as the program executes. 


2.30.6.1 String Concatenation 


Java supports string concatenation using the overloaded + operator as shown in Image 8 (p. 212) . 


Image 8 . String concatenation. 


"My variable has a value of " + myVar 
+ " at this point in the program." 


Table 2.92 


Coercion of an operand to type String 

The overloaded + operator is used to concatenate strings. If either operand is type String , the other 
operand is coerced into type String and the two strings are concatenated. 

Therefore, in addition to concatenating the strings, Java also converts values of other types, such as 
myVar in Image 8 (p. 212) , to character-string format in the process. 


2.30.6.2 Arrays of String References 


Declaring and instantiating a String array 
The statement in Image 9 (p. 213) declares and instantiates an array of references to five String objects. 
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Image 9 . Declaring and instantiating a String array. 


String[] myArrayOfStringReferences = new String[5]; 


Table 2.93 


No string data at this point 

Note however, that this array doesn’t contain the actual String objects. Rather, it simply sets aside 
memory for storage of five references of type String . (The array elements are automatically initialized to 
null.) No memory has been set aside to store the characters that make up the individual String objects. 
You must allocate the memory for the actual String objects separately using code similar to the code 
shown in Image 10 (p. 213) . 


Image 10 . Allocating memory to contain the String objects. 


myArrayOfStringReferences[0] = new String( 
"This is the first string."); 

myArrayOfStringReferences[1] = new String( 
"This is the second string."); 


Table 2.94 


The new operator is not required for String class 

Although it was used in Image 10 (p. 213) , the new operator is not required to instantiate an object 
of type String . I will discuss the ability of Java to instantiate objects of type String without the 
requirement to use the new operator in a future module. 


2.30.7 Run the programs 


I encourage you to copy the code from Listing 1 (p. 207) , Listing 2 (p. 209) , and Listing 3 (p. 211) . 
Compile the code and execute it. Experiment with the code, making changes, and observing the results of 
your changes. Make certain that you can explain why your changes behave as they do. 


2.30.8 Looking ahead 


As you approach the end of this group of Programming Fundamentals modules, you should be preparing 
yourself for the more challenging ITSE 2321 OOP tracks identified below: 


e Java OOP: The Guzdial-Ericson Multimedia Class Library 4 
e Java OOP: Objects and Encapsulation °° 


*4http://cnx.org/content /m44148 
*Shttp://cnx.org/content /m44153 
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2.30.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0240: Java OOP: Arrays and Strings 
e File: Jb0240.htm 

e Originally published: 1997 

e Published at cnx.org: 11/25/12 

e Revised: 12/05/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.31 Jb0240r Review” 


2.31.1 Table of Contents 
e Preface (p. 215) 
e Questions (p. 215) 


1 (p. 215) , 2 (p. 215) , 3 (p. 215) , 4 (p. 215) , 5 (p. 215) , 6 (p. 216) , 7 (p. 216) , 8 (p. 216) , 
9 (p. 216) , 10 (p. 216) , 11 (p. 216) , 12 (p. 221) , 13 (p. 216) , 14 (p. 217) , 15 (p. 217) , 16 
(p. 217) , 17 (p. 217) , 18 (p. 217) 

e Listings (p. 217) 

e Answers (p. 219) 

e Miscellaneous (p. 223) 


2.31.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0240: Java OOP: Arrays 
and Strings °” . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.31.3 Questions 

2.31.3.1 Question 1 

True or false? Arrays and Strings are true objects. If false, explain why. 
Answer 1 (p. 223) 

2.31.3.2 Question 2 


True or false? It is easy to write outsides the bounds of a String or an array. If false, explain why. 
Answer 2 (p. 223) 


2.31.3.3 Question 3 


You must declare a variable capable of holding a reference to an array object before you can use it. In 
declaring the variable, you must provide two important pieces of information. What are they? 
Answer 3 (p. 222) 


2.31.3.4 Question 4 


Provide code fragments that illustrate the two different syntaxes that can be used to declare a variable 
capable of holding a reference to an array object that will store data of type int. 
Answer 4 (p. 222) 


2.31.3.5 Question 5 


True or false? When you declare a variable capable of holding a reference to an array object, the memory 
required to contain the array object is automatically allocated. If false, explain why and show how memory 
can be allocated. 

Answer 5 (p. 222) 


96This content is available online at <http://cnx.org/content /m45208/1.5/>. 
®°“http://cnx.org/content /m45214 
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2.31.3.6 Question 6 


True or false? It is required that you simultaneously declare the name of the variable and cause memory to 
be allocated to contain the array object in a single statement. If false, explain why and show code fragments 
to illustrate your answer. 

Answer 6 (p. 222) 


2.31.3.7 Question 7 


True or false? Array indices always begin with 1. If false, explain why. 
Answer 7 (p. 221) 


2.31.3.8 Question 8 


What is the name of the property of arrays that can be accessed to determine the number of elements in the 
array? Provide a sample code fragment that illustrates the use of this property. 
Answer 8 (p. 221) 


2.31.3.9 Question 9 


What types of data can be stored in array objects? 
Answer 9 (p. 221) 


2.31.3.10 Question 10 


True or false? Just as in other languages, when you create a multi-dimensional array, the secondary arrays 
must all be of the same size. If false, explain your answer. Then provide a code fragment that illustrates 
your answer or refer to a sample program in Jb0240: Java OOP: Arrays and Strings °° that illustrates your 
answer. 

Answer 10 (p. 221) 


2.31.3.11 Question 11 


True or false? Just as in other languages, when declaring a two-dimensional array, it is necessary to declare 
the size of the secondary dimension when the array is declared. If false, explain your answer. Then provide 
a code fragment that illustrates your answer or refer to a sample program in Jb0240: Java OOP: Arrays and 
Strings °° that illustrates your answer. 

Answer 11 (p. 221) 


2.31.3.12 Question 12 


True or false? Java allows you to assign one array to another. Explain what happens when you do this. 
Then provide a code fragment that illustrates your answer or refer to a sample program in Jb0240: Java 
OOP: Arrays and Strings 10° that illustrates your answer. 

Answer 12 (p. 221) 


2.31.3.13 Question 13 


Give a brief description of the concept of a string and list the names of two classes used to implement strings? 
Answer 13 (p. 221) 


°*Shttp://cnx.org/content /m45214 
°°http://cnx.org/content /m45214 
100http://cnx.org/content /m45214 
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2.31.3.14 Question 14 


What is the syntax that is used to create a literal string? Provide a code fragment to illustrate your answer. 
Answer 14 (p. 220) 


2.31.3.15 Question 15 


Explain the difference between objects of types String and StringBuffer . 
Answer 15 (p. 220) 


2.31.3.16 Question 16 


Provide a code fragment that illustrates how to concatenate strings. 
Answer 16 (p. 220) 


2.31.3.17 Question 17 


Provide a code fragment that declares and instantiates an array object capable of storing references to two 
String objects. Explain what happens when this code fragment is executed. Then show a code fragment 
that will allocate memory for the actual String objects. 

Answer 17 (p. 220) 


2.31.3.18 Question 18 


Write a Java application that illustrates the creation and manipulation of a two-dimensional array with the 
sub arrays being of different lengths. Also cause your application to illustrate that an attempt to access an 
array element out of bounds results in an exception being thrown. Catch and process the exception. Display 
a termination message with your name. 

Answer 18 (p. 219) 


2.31.4 Listings 
e Listing 1 (p. 219) . Listing for Answer 18. 


What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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CHAPTER 2. PROGRAMMING FUNDAMENTALS 


2.31.5 Answers 
2.31.5.1 Answer 18 


Listing 1 . Listing for Answer 18. 


class SampProgi0 { //define the controlling class 


public static void main(String[] args){ //define main 


//Declare a two-dimensional array with a size of 3 on 
// the primary dimension but with different sizes on 
// the secondary dimension. 

//Secondary size not specified 

int(][] myArray = new int[3][]; 

myArray[0] = new int[2];//secondary size is 2 
myArray[1] = new int[3];//secondary size is 3 
myArray[2] = new int[4];//secondary size is 4 


//Fill the array with data 
for(int i = 0; i < 3; i++){ 
for(int j = 0; j < myArray[i].length; j++){ 
myArray[i] [j] = i * j; 
}//end inner loop 
}//end outer loop 


//Display data in the array 
for(int i = 0; i < 3; i++){ 
for(int j = 0; j < myArray[i].length; j++){ 
System. out . print (myArray[i][j]); 
}//end inner loop 
System.out.println(); 
}//end outer loop 


//Attempt to access an out-of-bounds array element 
try{ 
System.out.println( 
"Attempt to access array out of bounds"); 
myArray[4] [0] = 7; 
}catch(ArrayIndex0ut0fBoundsException e){ 
System.out.println(e); 
}//end catch 


System.out.println("Terminating, Dick Baldwin"); 


}//end main 


}//End SampProgi0 class. Note no semicolon required 


Table 2.95 


Back to Question 18 (p. 217) 
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2.31.5.2 Answer 17 


The following statement declares and instantiates an array object capable of storing references to two String 
objects. 


String[] myArrayOfStringReferences = new String[2]; 


Note however, that this array object doesn’t contain the actual string data. Rather, it simply sets aside 
memory for storage of two references to String objects. No memory has been set aside to store the 
characters that make up the individual strings. You must allocate the memory for the actual String 
objects separately using code similar to the following. 


myArrayOfStringReferences[0] = new String( 
"This is the first string."); 

myArrayOfStringReferences[1] = new String( 
"This is the second string."); 


Back to Question 17 (p. 217) 


2.31.5.3 Answer 16 


Java supports string concatenation using the overloaded + operator as shown in the following code fragment: 


"My variable has a value of " + myVar + 
" at this point in the program." 


Back to Question 16 (p. 217) 


2.31.5.4 Answer 15 


String objects cannot be modified once they have been created. StringBuffer objects can be modified 
Back to Question 15 (p. 217) 


2.31.5.5 Answer 14 


The Java compiler considers a series of characters surrounded by quotation marks to be a literal string, as 
in the following code fragment: 


"This is a literal string in Java." 


Back to Question 14 (p. 217) 
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2.31.5.6 Answer 13 


A string is commonly considered to be a sequence of characters stored in memory and accessible as a unit. 
Java implements strings using the String class and the StringBuffer class. 
Back to Question 13 (p. 216) 


2.31.5.7 Answer 12 


Java allows you to assign one array to another. When you do this, you are simply making another copy of 
the reference to the same data in memory. Then you have two references to the same data in memory. This 
is illustrated in the program named array02.java in Jb0240: Java OOP: Arrays and Strings 1°! . 

Back to Question 12 (p. 216) 


2.31.5.8 Answer 11 


False. When declaring a two-dimensional array, it is not necessary to declare the size of the secondary 
dimension when the array is declared. Declaration of the size of each sub-array can be deferred until later 
as illustrated in the program named arrayO1.java in Jb0240: Java OOP: Arrays and Strings 1°? . 

Back to Question 11 (p. 216) 


2.31.5.9 Answer 10 


False. Java can be used to produce multi-dimensional arrays that can be viewed as an array of arrays. 
However, the secondary arrays need not all be of the same size. See the program named arrayO01.java in 
Jb0240: Java OOP: Arrays and Strings 1° . 

Back to Question 10 (p. 216) 
2.31.5.10 Answer 9 


Array objects can contain any Java data type including primitive values, references to ordinary objects, and 
references to other array objects. 

Back to Question 9 (p. 216) 
2.31.5.11 Answer 8 


All array objects have a length property that can be accessed to determine the number of elements in the 
array as shown below. 


for(int cnt = 0; cnt < myArray.length; cnt++) 
myArray[cnt] = cnt; 


Back to Question 8 (p. 216) 


2.31.5.12 Answer 7 


False. Array indices always begin with 0. 
Back to Question 7 (p. 216) 


10lhttp://cnx.org/content /m45214 
102http://cnx.org/content /m45214 
103http://cnx.org/content /m45214 
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2.31.5.13 Answer 6 


False. While it is possible to simultaneously declare the name of the variable and cause memory to be 
allocated to contain the array object, it is not necessary to combine these two processes. You can execute 
one statement to declare the variable and another statement to cause the memory for the array object to be 
allocated as shown below. 


int[] myArray; 


myArray = new int[25]; 
Back to Question 6 (p. 216) 


2.31.5.14 Answer 5 


False. As with other objects. the declaration of the variable does not allocate memory to contain the array 
object. Rather it simply allocates memory to contain a reference to the array object. Memory to contain 
the array object must be allocated from dynamic memory using statements such as the following. 


int[] myArray = new int[15]; 
int myArray[] = new int[25]; 
int[] myArray = {1,2,3,4,5} 


Back to Question 5 (p. 215) 


2.31.5.15 Answer 4 


int[] myArray; 
int myArray[]; 


Back to Question 4 (p. 215) 
2.31.5.16 Answer 3 
In declaring the variable, you must provide two important pieces of information: 


e the name of the variable 
e the type of the variable, which indicates the type of data to be stored in the array 


Back to Question 3 (p. 215) 
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2.31.5.17 Answer 2 


False. Java has a true array type and atrue String type with protective features to prevent your program 
from writing outside the memory bounds of the array or the String . 
Back to Question 2 (p. 215) 


2.31.5.18 Answer 1 


True. 
Back to Question 1 (p. 215) 


2.31.6 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Jb0240r Review: Arrays and Strings 
e File: Jb0240r.htm 

e Originally published: 1997 

e Published at cnx.org: 11/26/12 

e Revised: 12/05/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 


if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 

Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.32 Jb0250: Java OOP: Brief Introduction to Exceptions™ 


2.32.1 Table of Contents 


e Preface (p. 224) 
Viewing tip (p. 224) 
x Listings (p. 224) 
Discussion (p. 224) 
Run the program (p. 225) 


Looking ahead (p. 225) 
Miscellaneous (p. 226) 


104This content is available online at <http://cnx.org/content /m45211/1.4/>. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


223 


2.32.2 Preface 


This module provides a very brief treatment of exception handling. The topic is discussed in detail in the 
module titled Java OOP: Exception Handling !°° . The topic is included in this Programming Fundamentals 
section simply to introduce you to the concept. 


2.32.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
link to easily find and view the listing while you are reading about it. 


2.32.2.1.1 Listings 


e Listing 1 (p. 225) . The program named simplel. 


2.32.3 Discussion 


What is an exception? 

According to The Java Tutorials 1°° , "An exception is an event that occurs during the execution of a 
program that disrupts the normal flow of instructions." 

A very common example of an exception given in textbooks is code that attempts to divide by zero (this 
is easy to demonstrate) . 

Throwing an exception 

Common terminology states that when this happens, the system throws an exception . If a thrown 
exception is not caught , a runtime error may occur. 

Purpose of exception handling 

The purpose of exception handling is to make it possible for the program to either attempt to recover 
from the problem, or at worst shut down the program in a graceful manner, whenever an exception occurs. 

Java supports exception handling 

Java, C++, and some other programming languages support exception handling in similar ways. 

In Java, the exception can be thrown either by the system or by code created by the programmer. There 
is a fairly long list of exceptions that will be thrown automatically by the Java runtime system. 

Checked exceptions cannot be ignored 

Included in that long list of automatic exceptions is a subset known as "checked" exceptions. Checked 
exceptions cannot be ignored by the programmer. A method must either specify (declare) or catch all 
"checked" exceptions that can be thrown in order for the program to compile. 

An example of specifying an exception 

I explain the difference between specifying and catching an exception in Java OOP: Exception Handling 
107 For now, suffice it to say that the code that begins with the word "throws" in Listing 1 (p. 225) 
specifies (declares) an exception that can be thrown by the code inside the main method. 

If this specification is not made, the program will not compile. 


105http://cnx.org/content /m44202 
106 http://docs.oracle.com/javase/tutorial/essential/exceptions/ 
l07http://cnx.org/content /m44202 
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Listing 1 . The program named simplel1. 


/*File simple1.java Copyright 1997, R.G.Baldwin 
BOSSA EEE EEEE EEEE EEEE I I II I ICI IAI CK EEE EEEE EEE 2k EEEE EE EEEE 
class simple1 { //define the controlling class 
public static void main(String[] args) 
throws java.io.I0Exception { 
int chi, ch2 = ’0’; 


System. out. print1n( 
"Enter some text, terminate with #"); 


//Get and save individual bytes 
while( (chi = System.in.read() ) != °?#?) ch2 = chi; 


//Display the character immediately before the # 
System.out.println("The char before the # was " 
+ (char) ch2) ; 
}//end main 
}//End simple1 class. 


Table 2.96 


The program in Listing 1 (p. 225) does not throw any exceptions directly nor does it attempt to catch 
any exceptions. However, it can throw exceptions indirectly through its call to System.in.read 

Because IOException is a checked exception, the main method must either specify it or catch it . 
Otherwise the program won’t compile. In this case, the main method specifies the exception as opposed 
to catching it. 

Very brief treatment 

As mentioned earlier, this is a very brief treatment of a fairly complex topic that is discussed in much 
more detail in the module titled Java OOP: Exception Handling 1°08 . The topic was included at this point 
simply to introduce you to the concept of exceptions. 


2.32.4 Run the program 


II encourage you to copy the code from Listing 1 (p. 225) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


2.32.5 Looking ahead 


As you approach the end of this group of Programming Fundamentals modules, you should be preparing 
yourself for the more challenging ITSE 2321 OOP tracks identified below: 


e Java OOP: The Guzdial-Ericson Multimedia Class Library 109 
e Java OOP: Objects and Encapsulation 11° 


108http://cnx.org/content /m44202 
109http://cnx.org/content /m44148 
10h¢ttp://cnx.org/content /m44153 
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2.32.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0250: Java OOP: Brief Introduction to Exceptions 
e File: Jb0250.htm 

e Originally published: 1997 

e Published at cnx.org: 11/26/12 

e Revised: 12/05/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation :: Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.33 Jb0260: Java OOP: Command-Line Arguments" 


2.33.1 Table of Contents 


Preface (p. 226) 
Viewing tip (p. 226) 
x Listings (p. 227) 
Discussion (p. 227) 
Run the program (p. 228) 


Looking ahead (p. 228) 
Miscellaneous (p. 228) 


2.33.2 Preface 


Although the use of command-line arguments is rare is this time of Graphical User Interfaces (GUI) , they 
are still useful for testing and debugging code. This module explains the use of command-line arguments in 
Java. 


2.33.2.1 Viewing tip 
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I recommend that you open another copy of this module in a separate browser window and use the following 
link to easily find and view the listing while you are reading about it. 


111 This content is available online at <http://cnx.org/content /m45246/1.5/>. 
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2.33.2.1.1 Listings 


e Listing 1 (p. 228) . Illustration of command-line arguments. 


2.33.3 Discussion 


Familiar example from DOS 
Java programs can be written to accept command-line-arguments. 
DOS users will be familiar with commands such as the following: 


Familiar DOS command 


copy fileA fileB 


In this case, copy is the name of the program to be executed, while fileA and fileB are command-line 
arguments. 

Java syntax for command-line arguments 

The Java syntax for supporting command-line arguments is shown below (note the formal argument list 
for the main method) . 


Java syntax for command-line arguments 


public static void main(String[] args) { 
}//end main method 


In Java, the formal argument list for the main method must appear in the method signature whether or 
not the program is written to support the use of command-line arguments. If the argument isn’t used, it is 
simply ignored. 

Where the arguments are stored 

The parameter args contains a reference to a one-dimensional array object of type String 

Each of the elements in the array (including the element at index zero) contains a reference to an object 
of type String . Each object of type String encapsulates one command-line argument. 

The number of arguments entered by the user 

Recall from an earlier module on arrays that the number of elements in a Java array can be obtained 
from the length property of the array. Therefore, the number of arguments entered by the user is equal 
to the value of the length property. If the user didn’t enter any arguments, the value will be zero. 

Command-line arguments are separated by the space character. If you need to enter an argument that 
contains a space, surround the entire argument with quotation mark characters as in "My command line 
argument" . 

The first command-line argument is encapsulated in the String object referred to by the contents of 
the array element at index 0, the second argument is referred to by the element at index 1, etc. 

Sample Java program 

The sample program in Listing 1 (p. 228) illustrates the use of command-line arguments. 
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Listing 1 . Illustration of command-line arguments. 


/*File cmdlin01.java Copyright 1997, R.G.Baldwin 
This Java application illustrates the use of Java 
command-line arguments. 


When this program is run from the command line as follows: 


java cmdlin01 My command line arguments 


the program produces the following output: 


My 
command 
line 
arguments 
FOSSA IOS IRIS II IAI II I I A I A a AK A AK ak ok EEEN 
class cmdlin01 { //define the controlling class 
public static void main(String[] args){ //main method 
for(int i=0; i < args.length; i++) 
System.out.println( args[i] ); 
}//end main 
}//End cmdlin01 class. 


Table 2.97 


The output from running this program for a specific input is shown in the comments at the beginning of 


the program. 


2.33.4 Run the program 


I encourage you to copy the code Listing 1 (p. 228) . Compile the code and execute it. Experiment with the 
code, making changes, and observing the results of your changes. Make certain that you can explain why 


your changes behave as they do. 


2.33.5 Looking ahead 


As you approach the end of this group of Programming Fundamentals modules, you should be preparing 


yourself for the more challenging ITSE 2321 OOP tracks identified below: 


e Java OOP: The Guzdial-Ericson Multimedia Class Library 1? 
e Java OOP: Objects and Encapsulation 113 


2.33.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


112http://cnx.org/content /m44148 
113h¢tp://cnx.org/content /m44153 
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Housekeeping material 


e Module name: Jb0260: Java OOP: Command-Line Arguments 
e File: Jb0260.htm 

e Originally published: 1997 

e Published at cnx.org: 11/27/12 

e Revised: 12/05/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.34 Jb0260r Review'” 


2.34.1 Table of Contents 


Preface (p. 230) 
Questions (p. 230) 
1 (p. 230) , 2 (p. 230) , 3 (p. 230) , 4 (p. 230) , 5 (p. 230) , 6 (p. 231) 


Listings (p. 231) 
Answers (p. 232) 
Miscellaneous (p. 234) 


2.34.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0260: Java OOP: Command- 
Line Arguments 115 . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.34.3 Questions 
2.34.3.1 Question 1 


Provide a common example of a command-line statement that illustrates the use of command-line-arguments. 
Answer 1 (p. 233) 


2.34.3.2 Question 2 


Describe the purpose of command-line-arguments. 
Answer 2 (p. 233) 


2.34.3.3 Question 3 


True or false? In Java, syntax provisions must be made in the method signature for the main method to 
accommodate command-line-arguments even if the remainder of the program is not designed to make use of 
them. If False, explain why. 

Answer 3 (p. 233) 


2.34.3.4 Question 4 


Provide the method signature for the main method in a Java application that is designed to accommodate 
the use of command-line-arguments. Identify the part of the method signature that applies to command- 
line-arguments and explain how it works. 

Answer 4 (p. 233) 


2.34.3.5 Question 5 


Explain how a Java application can determine the number of command-line-arguments actually entered by 
the user. 
Answer 5 (p. 233) 


'l4This content is available online at <http://cnx.org/content /m45244/1.6/>. 
115http://cnx.org/content /m45246 
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2.34.3.6 Question 6 


Write a program that illustrates the handling of command-line arguments in Java. 
Answer 6 (p. 232) 


2.34.4 Listings 


e Listing 1 (p. 232) . Handling command-line arguments in Java. 


What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Put your name here 


2.34.5 Answers 
2.34.5.1 Answer 6 
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Listing 1 . Handling command-line arguments in Java. 


/*File SampProgi1.java from module 32 

Copyright 1997, R.G.Baldwin 

Without reviewing the following solution, write a Java 
application that illustrates the handling of command-line 
arguments in Java. 


Provide a termination message that displays your name. 
FIO I ICICI ACI I ACI A Kf EEEE EEEE EEE EEEE EEEE 2A OK fA OK EEE EEE EEEE EEE EEEN 
class SampProgii { //define the controlling class 
public static void main(String[] args){ //define main 
for(int i=0; i < args.length; i++) 
System.out.println( args[i] ); 
System.out.println("Terminating, Dick Baldwin"); 
}//end main 
}//End SampProgi1 class. 
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Table 2.98 


Back to Question 6 (p. 231) 


2.34.5.2 Answer 5 


The number of command-line arguments is equal to the number of elements in the array of references to 
String objects referred to by args . The number of elements is indicated by the value of the length 
property of the array. If the value is zero, the user didn’t enter any command-line arguments. 

Back to Question 5 (p. 230) 


2.34.5.3 Answer 4 
The Java syntax for command-line arguments is shown below. 


Java syntax for command-line arguments. 


public static void main(String[] args){ 
}//end main method 


Each of the elements in the array object referred to by args (including the element at position zero) 
contains a reference to a String object that encapsulates one of the command-line arguments. 
Back to Question 4 (p. 230) 
2.34.5.4 Answer 3 
True. 
Back to Question 3 (p. 230) 
2.34.5.5 Answer 2 


Command-line-arguments are used in many programming and computing environments to provide informa- 
tion to the program at startup that it will need to fulfill its mission during that particular invocation. 
Back to Question 2 (p. 230) 


2.34.5.6 Answer 1 


DOS users will be familiar with commands such as the following: 


Command-line arguments in DOS 


copy fileA fileB 
In this case, copy is the name of the program to be executed, while fileA and fileB are command-line 


arguments. 
Back to Question 1 (p. 230) 
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2.34.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0260r Review: Command-Line Arguments 
e File: Jb0260r.htm 

e Originally published: 1997 

e Published at cnx.org: 11/25/12 

e Revised: 12/05/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 

In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.35 Jb0270: Java OOP: Packages'” 


2.35.1 Table of Contents 


e Preface (p. 235) 
Viewing tip (p. 235) 
x Listings (p. 235) 
e Introduction (p. 235) 
e Classpath environment variable (p. 235) 
e Developing your own packages (p. 236) 
The package directive (p. 237) 
The import directive (p. 238) 
Compiling programs with the package directive (p. 238) 
Sample program (p. 239) 
e Run the program (p. 242) 


e Looking ahead (p. 242) 
e Miscellaneous (p. 243) 


116This content is available online at <http://cnx.org/content /m45229/1.5/>. 
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2.35.2 Preface 


This module explains the concept of packages and provides a sample program that illustrates the concept. 


2.35.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


2.35.2.1.1 Listings 


Listing 1 (p. 240) . File: Package00.java. 
Listing 2 (p. 241) . File Package01.java. 
Listing 3 (p. 241) . File Package02.java. 
Listing 4 (p. 242) . File: CompileAndRun.bat. 


2.35.3 Introduction 


Before you can understand much about packages, you will need to understand the classpath environment 
variable , so that is where I will begin the discussion. 
After learning about the classpath environment variable, you will learn how to create your own packages. 


2.35.4 Classpath environment variable 


The purpose of the classpath environment variable is to tell the JVM and other Java applications (such as 
the javac compiler) where to find class files and class libraries. This includes those class files that are part 
of the JDK and class files that you may create yourself. 
I am assuming that you already have some familiarity with the use of environment variables in your 
operating system. All of the discussion in this module will be based on the use of a generic form of Windows. 
(By generic, I mean not tied to any particular version of Windows.) Hopefully you will be able to translate 
the information to your operating system if you are using a different operating system. 


In a nutshell Environment variables provide information that the operating system uses to do 
its job. 


There are usually a fairly large number of environment variables installed on a machine at any give time. If 
you would like to see what kind of environment variables are currently installed on your machine, bring up 
a command-line prompt and enter the command set . This should cause the names of several environment 
variables, along with their settings to be displayed on your screen. 

While you are at it, see if any of those items begin with CLASSPATH=— . If so, you already have a 
classpath environment variable set on your machine, but it may not contain everything that you need. 

I am currently using a Windows 7 operating system and no classpath environment variable is set on it. I 
tend to use the -cp switch option (see Listing 4 (p. 242) ) in the JDK to set the classpath on a temporary 
basis when I need it to be set. 

Rather than trying to explain all of the ramifications regarding the classpath, I will simply refer you to 
an Oracle document on the topic titled Setting the class path 1!" . 

I will also refer you to Java OOP: The Guzdial-Ericson Multimedia Class Library 118 where I discuss the 
use of the classpath environment variable with a Java multimedia class library. 

Some rules 


'l7http://docs.oracle.com/javase/7/docs/technotes/tools/windows/classpath.html 
'18h¢tp://cnx.org/content /m44148 
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There are some rules that you must follow when working with the classpath variable, and if you fail to 
do so, things simply won’t work. 

For example, if your class files are in a jar file, the classpath must end with the name of that jar file. 

On the other hand, if the class files are not in a jar file, the classpath must end with the name of the 
folder that contains the class files. 

Your classpath must contain a fully-qualified path name for every folder that contains class files of interest, 
or for every jar file of interest. The paths should begin with the letter specifying the drive and end either 
with the name of the jar file or the name of the folder that contains the class files. . 

If you followed the default JDK installation procedure and are simply compiling and executing Java 
programs in the current directory you probably won’t need to set the classpath. By default, the system 
already knows (or can figure out) how to allow you to compile and execute programs in the current 
directory and how to use the JDK classes that come as part of the JDK. 

However, if you are using class libraries other than the standard Java library, are saving your class files 
in one or more different folders, or are ready to start creating your own packages, you will need to set the 
classpath so that the system can find the class files in your packages. 


2.35.5 Developing your own packages 


One of the problems with storing all of your class files in one or two folders is that you will likely experience 
name conflicts between class files. 

Every Java program can consist of a large number of separate classes. A class file is created for each class 
that is defined in your program, even if they are all combined into a single source file. 

It doesn’t take very many programs to create a lot of class files, and it isn’t long before you find yourself 
using the same class names over again. If you do, you will end up overwriting class files that were previously 
stored in the folder. 

For me, it only takes two GUI programs to get in trouble because I tend to use the same class names in 
every program for certain standard operations such as closing a Frame or processing an ActionEvent 
. For the case of the ActionEvent , the body of the class varies from one application to the next so it 
doesn’t make sense to turn it into a library class. 

So we need a better way to organize our class files, and the Java package provides that better way. 

The Java package approach allows us to store our class files in a hierarchy of folders (or a jar file 
that represents that hierarchy) while only requiring that the classpath variable point to the top of the 
hierarchy. The remaining hierarchy structure is encoded into our programs using package directives and 
import directives. 

Now here is a little jewel of information that cost me about seven hours of effort to discover when I 
needed it badly. 

When I first started developing my own packages, I spent about seven hours trying to determine why the 
compiler wouldn’t recognize the top-level folder in my hierarchy of package folders. 

I consulted numerous books by respected authors and none of them was any help at all. I finally found the 
following statement in the Java documentation (when all else fails, read the documentation) . By the way, 
a good portion of that wasted seven hours was spent trying to find this information in the documentation 
which is voluminous. 


The following text was extracted directly from the JDK 1.1 documentation If you 
want the CLASSPATH to point to class files that belong to a package, you should specify a path 
name that includes the path to the directory one level above the directory having the name of your 
package. 


For example, suppose you want the Java interpreter to be able to find classes in the package 
mypackage. If the path to the mypackage directory is C:\java\MyClasses\mypackage, you would 
set the CLASSPATH variable as follows: 


set CLASSPATH=C:\java\MyClasses 
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If you didn’t catch the significance of this, read it again. When you are creating a classpath variable to 
point to a folder containing classes, it must point to the folder. However, when you are creating a classpath 
variable to point to your package, it must point to the folder that is one level above the directory that is the 
top-level folder in your package. 

Once I learned that I had to cause the classpath to point to the folder immediately above the first folder 
in the hierarchy that I was including in my package directives, everything started working. 


2.35.5.1 The package directive 


So, what is the purpose of a package directive, and what does it look like? 


Purpose of a package directive The purpose of the package directive is to identify a particular 
class (or group of classes contained in a single source file (compilation unit)) as belonging to a 
specific package. 


This is very important information for a variety of reasons, not the least of which is the fact that the entire 
access control system is wrapped around the concept of a class belonging to a specific package. For example, 
code in one package can only access public classes in a different package. 

Stated in the simplest possible terms, a package is a group of class files contained in a single folder on 
your hard drive. 

At compile time, a class can be identified as being part of a particular package by providing a package 
directive at the beginning of the source code.. 

A package directive, if it exists, must occur at the beginning of the source code (ignoring comments and 
white space) . No text other than comments and whitespace is allowed ahead of the package directive. 

If your source code file does not contain a package directive, the classes in the source code file become 
part of the default package . With the exception of the default package, all packages have names, and 
those names are the same as the names of the folders that contain the packages. There is a one-to-one 
correspondence between folder names and package names. The default package doesn’t have a name. 

Some examples of package directives that you will see in upcoming sample programs follow: 


Example package directives 


package Combined. Java.p1; 
package Combined. Java.p2; 


Given the following as the classpath on my hypothetical machine, 

CLASSPATH=.;c:\Baldwin\JavaProg 

these two package directives indicate that the class files being governed by the package directives are 
contained in the following folders: 


c: \Baldwin\JavaProg\Combined\Java\p1 
c: \Baldwin\JavaProg\Combined\Java\p2 


Notice how I concatenated the package directive to the classpath setting and substituted the backslash 
character for the period when converting from the package directive to the fully-qualified path name. 

Code in one package can refer to a class in another package (if it is otherwise accessible) by qualifying 
the class name with its package name as follows 
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Combined. Java.p2.Access02 obj02 = 
new Combined. Java.p2.Access02(); 


Obviously, if we had to do very much of that, it would become very burdensome due to the large amount of 
typing required. As you already know, the import directive is available to allow us to specify the package 
containing the class just once at the beginning of the source file and then refer only to the class name for 
the remainder of that source file. 


2.35.5.2 The import directive 


This discussion will be very brief because you have been using import directives since the very first module. 
Therefore, you already know what they look like and how to use them. 

If you are interested in the nitty-gritty details (such as what happens when you provide two import 
directives that point to two different packages containing the same class file name) , you can consult the 
Java Language Reference by Mark Grand, or you can download the Java language specification from Oracle’s 
Java website. 

The purpose of the import directive is to help us avoid the burdensome typing requirement (p. 237) 
described in the previous section when referring to classes in a different package. 

An import directive makes the definitions of classes from other packages available on the basis of their 
file names alone. 

You can have any number of import directives in a source file. However, they must occur after the 
package directive (if there is one) and before any class or interface declarations. 

There are essentially two different forms of the import directive, one with and the other without a wild 
card character (*) . These two forms are illustrated in the following box. 


Two forms of import directives 


import java.awt.* 
import java.awt.event.ActionEvent 


The first import directive makes all of the class files in the java.awt package available for use in the code 
in a different package by referring only to their file names. 

The second import directive makes only the class file named ActionEvent in the java.awt.event 
package available by referring only to the file name. 


2.35.5.3 Compiling programs with package directives 


So, how do you compile programs containing package directives? There are probably several ways. I am 
going to describe one way that I have found to be successful. 

First, you must create your folder hierarchy to match the package directive that you intend to use. 
Remember to construct this hierarchy downward relative to the folder specified at the end of your classpath 
setting. If you have forgotten the critical rule (p. 236) in this respect, go back and review it. 

Next, place source code files in each of the folders where you intend for the class files associated with 
those source code files to reside. (After you have compiled and tested the program, you can remove the 
source code files if you wish.) 

You can compile the source code files individually if you want to, but that isn’t necessary. 

One of the source code files will contain the controlling class . The controlling class is the class that 
contains the main method that will be executed when you run the program from the command line using 
the JVM. 

Make the directory containing that source code file be the current directory. (If you don’t know what 
the current directory is, go out and get yourself a DOS For Dummies book and read it.) 
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Each of the source code files must contain a package directive that specifies the package that will contain 
the compiled versions of all the class definitions in that source code file. Using the instructions that I am 
giving you, that package directive will also describe the folder that contains the source code file. 

Any of the source code files containing code that refers to classes in a different package must also contain 
the appropriate import directives, or you must use fully-qualified package names to refer to those classes. 

Then use the javac program with your favorite options to compile the source code file containing the 
controlling class. This will cause all of the other source code files containing classes that are linked to the 
code in the controlling class, either directly or indirectly, to be compiled also. At least an attempt will be 
made to compile them all. You may experience a few compiler errors if your first attempt at compilation is 
anything like mine. 

Once you eliminate all of the compiler errors, you can test the application by using the java program 
with your favorite options to execute the controlling class. 

Once you are satisfied that everything works properly, you can copy the source code files over to an 
archive folder and remove them from the package folders if you want to do so. 

Finally, you can also convert the entire hierarchy of package folders to a jar file if you want to, and 
distribute it to your client. If you don’t remember how to install it relative to the classpath variable, go back 
and review that part of the module. 

Once you have reached this point, how do you execute the program. I will show you how to execute the 
program from the command line in the sample program in the next section. (Actually I will encapsulate 
command-line commands in a batch file and execute the batch file. That is a good way to guard against 
typing errors.) 


2.35.5.4 Sample program 


The concept of packages can get very tedious in a hurry. Let’s take a look at a sample program that is 
designed to pull all of this together. 

This application consists of three separate source files located in three different packages. Together they 
illustrates the use of package and import directives, along with javac to build a standalone Java application 
consisting of classes in three separate packages. 

(If you want to confirm that they are really in different packages, just make one of the classes referred 
to by the controlling class non-public and try to compile the program.) 

In other words, in this sample program, we create our own package structure and populate it with a set 
of cooperating class files. 

A folder named jnk is a child of the root folder on the M-drive. 

A folder named SampleCode is a child of the folder named jnk 

A folder named Combined is a child of the folder named SampleCode 

A folder named Java is a child of the folder named Combined 

Folders named pl and p2 are children of the folder named Java 

The file named Package00.java_, shown in Listing 1 (p. 240) is stored in the folder named Java 
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Listing 1 . File: Package00.java. 


/*File PackageOO.java Copyright 1997, R.G.Baldwin 
Illustrates use of package and import directives to 
build an application consisting of classes in three 
separate packages. 


The output from running the program follows: 


Starting Package0O 

Instantiate obj of public classes in different packages 
Constructing Package01 object in folder pl 

Constructing Package02 object in folder p2 

Back in main of Package0O 

FEA EEEE EEE EEEE EEEE E EEEE IOI AI I I I EE aK A 21 21 21 1 4 21 2k ak a 4 2k E 2k ak kak // 
package Combined.Java; //package directive 


//Two import directives 
import Combined. Java.p1.Package01;//specific form 
import Combined. Java.p2.*; //wildcard form 


class Package00{ 
public static void main(String[] args){ //main method 
System. out .println("Starting Package00") ; 


System.out.println("Instantiate obj of public " + 

"classes in different packages"); 
new Package01();//Instantiate objects of two classes 
new Package02();// in different packages. 


System. out .println("Back in main of Package00"); 


}//end main method 
}//End Package00 class definition. 


Table 2.99 


The file named Package01.java , shown in Listing 2 (p. 241) is stored in the folder named p1 
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Listing 2 . File Package01.java. 


/*File PackageO1l.java Copyright 1997, R.G.Baldwin 
See discussion in file Package0OO. java 
FE A EEEE EEE EE I IOI AI I I IOI AI I A EE EEEE 21 21 1 EE 21 21 1 EEE ak E A 2k a ak kak / 
package Combined. Java.p1; 
public class PackageO1 { 

public Package01() {//constructor 

System. out .print1n( 
"Constructing Package01 object in folder p1"); 

}//end constructor 

}//End PackageO1 class definition. 


Table 2.100 


The file named Package02.java_ , shown in Listing 3 (p. 241) is stored in the folder named p2 


Listing 3 . File Package02.java. 


/*File PackageO2.java Copyright 1997, R.G.Baldwin 
See discussion in file Package00. java 
FEA EEEE EEE EEEE EEEE E GIGI I I ACK I I I I EEE EE 21 21 21 1 4 21 2k E af 2k 2 ak ak ak ak // 
package Combined. Java.p2; 
public class Package02 { 

public Package02() {//constructor 

System. out .print1n( 
"Constructing Package02 object in folder p2"); 

}//end constructor 

}//End PackageO2 class definition. 


Table 2.101 


The file named CompileAndRun_ .bat, shown in Listing 4 (p. 242) is stored in the folder named 
SampleCode 
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Listing 4 . File: CompileAndRun.bat. 


echo off 

rem This file is located in folder named M:\SampleCode, 
rem which is Parent of folder Combined. 

del Combined\Java\*.class 

del Combined\Java\p1\*.class 

del Combined\Java\p2\*.class 

javac -cp M:\jnk\SampleCode Combined\Java\Package00. java 
java -cp M:\jnk\SampleCode Combined. Java.Package00 


pause 


Table 2.102 


The controlling class named Package00 is stored in the package named Combined.Java _ , as declared 
in Listing 1 (p. 240) . 

The class named PackageO1 is stored in the package named Combined.Java.p1_, as declared in 
Listing 2 (p. 241) . 

The class named PackageO2 is stored in the package named Combined.Java.p2_, as declared in 
Listing 3 (p. 241) . 

The controlling class named Package00 imports Combined.Java.p1.Package01 and Com- 
bined.Java.p2.* , as declared in Listing 1 (p. 240) . 

Code in the main method of the controlling class in Listing 1 (p. 240) instantiates objects of the 
other two classes in different packages. The constructors for those two classes announce that they are being 
constructed. 

The two classes being instantiated are public . Otherwise, it would not be possible to instantiate them 
from outside their respective packages. 

This program was tested using JDK 7 under Windows by executing the batch file named CompileAn- 
dRun.bat 

The classpath is set to the parent folder of the folder named Combined (M:\jnk\SampleCode) by 
the -cp switch in the file named CompileAndRun.bat 

The output from running the program is shown in the comments at the beginning of Listing 1 (p. 240) . 


2.35.6 Run the program 


I encourage you to copy the code from Listing1 (p. 240) through Listing 4 (p. 242) into a properly constructed 
tree of folders. Compile the code and execute it. Experiment with the code, making changes, and observing 
the results of your changes. Make certain that you can explain why your changes behave as they do. 


2.35.7 Looking ahead 


As you approach the end of this group of Programming Fundamentals modules, you should be preparing 
yourself for the more challenging ITSE 2321 OOP tracks identified below: 


e Java OOP: The Guzdial-Ericson Multimedia Class Library 119 


119h¢ttp://cnx.org/content /m44148 
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e Java OOP: Objects and Encapsulation !7° 


2.35.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0270: Java OOP: Packages 
e File: Jb0270.htm 

e Originally published: 1997 

e Published at cnx.org: 11/25/12 

e Revised: 12/05/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.36 Jb0280: Java OOP: String and StringBuffer™ 


2.36.1 Table of Contents 


e Preface (p. 244) 
Viewing tip (p. 244) 
x Listings (p. 244) 
Introduction (p. 244) 
You can’t modify a String object, but you can replace it (p. 244) 


Why are there two string classes? (p. 246) 
Creating String and StringBuffer objects (p. 246) 


The sample program named String02 (p. 246) 

Alternative String instantiation constructs (p. 248) 
Instantiating StringBuffer objects (p. 248) 

Declaration, memory allocation, and initialization (p. 249) 
Instantiating an empty StringBuffer object (p. 249) 


120h¢tp://cnx.org/content /m44153 
121This content is available online at <http://cnx.org/content /m45237/1.4/>. 
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e Accessor methods (p. 250) 


Constructors and methods of the String class (p. 250) 
String objects encapsulate data (p. 250) 
Creating String objects without calling the constructor (p. 250) 


Memory management by the StringBuffer class (p. 251) 
The toString method (p. 251) 

Strings and the Java compiler (p. 251) 

Concatenation and the + operator (p. 252) 

Run the programs (p. 252) 

Looking ahead (p. 252) 

Miscellaneous (p. 253) 


2.36.2 Preface 


This module discusses the String and StringBuffer classes in detail. 


2.36.2.1 Viewing tip 

I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 

2.36.2.1.1 Listings 


e Listing 1 (p. 245) . File String01.java 
e Listing 2 (p. 247) . File String02.java. 


2.36.3 Introduction 


A string in Java is an object. Java provides two different string classes from which objects that encapsulate 
string data can be instantiated: 


e String 
e StringBuffer 


The String class is used for strings that are not allowed to change once an object has been instantiated 
(an immutable object) . The StringBuffer class is used for strings that may be modified by the program. 


2.36.4 You can’t modify a String object, but you can replace it 


While the contents of a String object cannot be modified, a reference to a String object can be caused 
to point to a different String object as illustrated in the sample program shown in Listing 1 (p. 245) . 
Sometimes this makes it appear that the original String object is being modified. 


Listing 1 . File String01.java. 


continued on next page 
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/*File String01.java Copyright 1997, R.G.Baldwin 

This application illustrates the fact that while a String 
object cannot be modified, the reference variable can be 
modified to point to a new String object which can have 
the appearance of modifying the original String object. 


The program was tested using JDK 1.1.3 under Win95. 
The output from this program is 


Display original string values 

THIS STRING IS NAMED stri 

This string is named str2 

Replace stri with another string 

Display new string named stri 

THIS STRING IS NAMED stri This string is named str2 
Terminating program 


kkk ak A k akak I ak 2k ak ak 2k k ak ək 2k ək ək 3k ək ək 2k 3k ək ək 3k 2k ək 3k 2k əkək 2k k ək 2k 2k ək 2k ək 2k 2K əkək af 2k afk ak 2K k // 


class String01{ 
String stri = "THIS STRING IS NAMED str1"; 
String str2 = "This string is named str2"; 


public static void main(String[] args){ 
String01 thisObj = new String01(); 
System. out .println("Display original string values"); 
System. out .println(this0bj.str1); 
System. out .println(this0bj.str2); 
System.out.println("Replace stri with another string"); 
thisObj.stri = thisObj.stri + " " + thisObj.str2; 
System. out .println("Display new string named stri"); 
System. out .println(this0bj.str1); 
System. out .println("Terminating program") ; 

}//end main() 

}//end class String01 


Table 2.103 


It is important to note that the following statement does not modify the original object pointed to by 
the reference variable named str1 


thisObj.stri = thisObj.stri + " " + thisObj.str2; 


Rather, this statement creates a new object, which is concatenation of two existing objects and causes the 
reference variable named strl to point to the new object instead of the original object. 
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The original object then becomes eligible for garbage collection (unless there is another reference to the 
object hanging around somewhere) . 

Many aspects of string manipulation can be accomplished in this manner, particularly when the methods 
of the String class are brought into play. 


2.36.5 Why are there two string classes? 
According to The Java Tutorial by Campione and Walrath: 


"Because they are constants, Strings are typically cheaper than StringBuffers and they can be 
shared. So it’s important to use Strings when they’re appropriate." 


2.36.6 Creating String and StringBuffer objects 


The String and StringBuffer classes have numerous overloaded constructors and many different. 
methods. I will attempt to provide a sampling of constructors and methods that will prepare you to explore 
other constructors and methods on your own. 

The next sample program touches on some of the possibilities provided by the wealth of constructors and 
methods inthe String and StringBuffer classes. 

At this point, I will refer you to Java OOP: Java Documentation !?? where you will find a link to 
online Java documentation. Among other things, the online documentation provides a list of the overloaded 
constructors and methods for the String and StringBuffer classes. 

As of Java version 7, there are four overloaded constructors in the StringBuffer class and about 
thirteen different overloaded versions of the append method. There are many additional methods in the 
StringBuffer class including about twelve overloaded versions of the insert method. 

As you can see, there are lots of constructors and lots of methods from which to choose. One of your 
challenges as a Java programmer will be to find the right methods of the right classes to accomplish what 
you want your program to accomplish. 


2.36.6.1 The sample program named String02 


The sample program shown in Listing 2 (p. 247) illustrates a variety of ways to create and initialize String 
and StringBuffer objects. 


122h¢tp://cnx.org/content /m45117 
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Listing 2 . File String02.java. 


/*File String02.java Copyright 1997, R.G.Baldwin 
Illustrates different ways to create String objects and 
StringBuffer objects. 


The program was tested using JDK 1.1.3 under Win95. 


The output from this program is as follows. In some cases, 
manual line breaks were inserted to make the material fin 
this presentation format. 


Create a String the long way and display it 
String named str2 


Create a String the short way and display it 
String named str1 


Create, initialize, and display a StringBuffer using new 
StringBuffer named str3 


Try to create/initialize StringBuffer without 
using new - not allowed 


Create an empty StringBuffer of default length 
Now put some data in it and display it 
StringBuffer named str5 


Create an empty StringBuffer and specify length 
when it is created 

Now put some data in it and display it 
StringBuffer named str6 


Try to create and append to StringBuffer without 
using new -- not allowed 


2A A k akak I ak OK ak 2k 2k ək 2k ək ək 2k ək ək 2k 3k ək 3k 3k 2k ək 3k 2k ək ək 3k 2k 2k ək ək 2k ək 2k 2K əkək ək 2k afk ak 2K k // 


class String02{ 
void d(String displayString){//method to display strings 
System. out .println(displayString); 
}//end method d() 


public static void main(String[] args){ 
String02 o = new String02();//obj of controlling class 


o.d("Create a String the long way and display it"); 
String stri = new String("String named str2"); 
o.d(stri + "\n"); 


o.d("Create a String the short way and display it"); 


String str2 =AvAbbingr mawed Gobhaxions <http://cnx.org/content /coll1441/1.181> 
o.d(str2 + "\n"); 


o.d("Create, initialize, and display a StringBuffer " + 
"using new"): 


247 


Table 2.104 


2.36.6.2 Alternative String instantiation constructs 


The first thing to notice is that a String object can be created using either of the following constructs: 


Alternative String instantiation constructs 


String stri = new String("String named str2"); 


String str2 "String named stri"; 
The first approach uses the new operator to instantiate an object while the shorter version doesn’t use 
the new operator. 

Later I will discuss the fact that 


e the second approach is not simply a shorthand version of the first construct, but that 
e they involve two different compilation scenarios with the second construct being more efficient than 
the first. 


2.36.6.3 Instantiating StringBuffer objects 


The next thing to notice is that a similar alternative strategy does not hold for the StringBuffer class. 
For example, it is not possible to create a StringBuffer object without use of the new operator. 
(It is possible to create a reference toa StringBuffer object but it is later necessary to use the new 
operator to actually instantiate an object.) 
Note the following code fragments that illustrate allowable and non-allowable instantiation scenarios for 
StringBuffer objects. 


Instantiating StringBuffer objects 


//allowed 
StringBuffer str3 = new StringBuffer ( 
"StringBuffer named str3"); 


//not allowed 
//StringBuffer str4 = "StringBuffer named str4"; 


o.d("Try to create and append to StringBuffer " + 
"without using new -- not allowed"); 

//StringBuffer str7; 

//str7.append("StringBuffer named str7"); 
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2.36.6.4 Declaration, memory allocation, and initialization 


To review what you learned in an earlier module, three steps are normally involved in creating an object 
(but the third step may be omitted) . 


e declaration 
e memory allocation 
e initialization 
The following code fragment performs all three steps: 


Declaration, memory allocation, and initialization 


StringBuffer str3 = 
new StringBuffer ("StringBuffer named str3"); 


The code 
StringBuffer str3 
declares the type and name of a reference variable of the correct type for the benefit of the compiler. 
The new operator allocates memory for the new object. 
The constructor call 
StringBuffer("StringBuffer named str3") 
constructs and initializes the object. 


2.36.6.5 Instantiating an empty StringBuffer object 


The instantiation of the StringBuffer object shown above (p. 249) uses a version of the constructor that 
accepts a String object and initializes the StringBuffer object when it is created. 

The following code fragment instantiates an empty StringBuffer object of a default capacity and then 
uses a version of the append method to put some data into the object. (Note that the data is actually a 
String object — a sequence of characters surrounded by quotation marks.) 


Instantiating an empty StringBuffer object 


//default initial length 
StringBuffer str5 = new StringBuffer(); 


//modify length as needed 
str5.append("StringBuffer named str5"); 


It is also possible to specify the capacity when you instantiate a StringBuffer object. 

Some authors suggest that if you know the final length of such an object, it is more efficient to specify 
that length when the object is instantiated than to start with the default length and then require the system 
to increase the length "on the fly" as you manipulate the object. 

This is illustrated in the following code fragment. This fragment also illustrates the use of the length 
method of the String class just to make things interesting. (A simple integer value for the capacity of 
the StringBuffer object would have worked just as well.) 


Instantiating a StringBuffer object of a non-default length 


StringBuffer str6 = new StringBuffer ( 
"StringBuffer named str6".length()) ; 
str6.append("StringBuffer named str6"); 
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2.36.7 Accessor methods 


The following quotation is taken directly from The Java Tutorial by Campione and Walrath. 


"An object’s instance variables are encapsulated within the object, hidden inside, safe from inspec- 
tion or manipulation by other objects. With certain well-defined exceptions, the object’s methods 
are the only means by which other objects can inspect or alter an object’s instance variables. En- 
capsulation of an object’s data protects the object from corruption by other objects and conceals 
an object’s implementation details from outsiders. This encapsulation of data behind an object’s 
methods is one of the cornerstones of object-oriented programming." 


The above statement lays out an important consideration in good object-oriented programming. 
The methods used to obtain information about an object are often referred to as accessor methods 


2.36.7.1 Constructors and methods of the String class 


I told you in an earlier section (p. 246) that the StringBuffer class provides a large number of overloaded 
constructors and methods. The same holds true for the String class. 

Once again, I will refer you to Java OOP: Java Documentation !23 where you will find a link to online 
Java documentation. Among other things, the documentation provides a list of the overloaded constructors 
and methods for the String class 


2.36.7.2 String objects encapsulate data 


The characters in a String object are not directly available to other objects. However, as you can see from 
the documentation, there are a large number of methods that can be used to access and manipulate those 
characters. For example, in an earlier sample program ( Listing 2 (p. 247) ) , 1 used the length method 
to access the number of characters stored in a String object as shown in the following code fragment. 


StringBuffer str6 = new StringBuffer ( 
"StringBuffer named str6".length()); 


In this case, I applied the length method to a literal string, but it can be applied to any valid representation 
of an object of type String 
I then passed the value returned by the length method to the constructor for a StringBuffer object. 
As you can determine by examining the argument lists for the various methods of the String class, 


e some methods return data stored in the string while 
e other methods return information about that data. 


For example, the length method returns information about the data stored in the String object. 
Methods such as charAt and substring return portions of the actual data. 
Methods such toUpperCase can be thought of as returning the data, but returning it in a different 
format. 


2.36.7.3 Creating String objects without calling the constructor 


Methods in other classes and objects may create String objects without an explicit call to the constructor 
by the programmer. For example the toString method of the Float class receives a float value as an 
incoming parameter and returns a reference toa String object that represents the float argument. 
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2.36.8 Memory management by the StringBuffer class 


If the additional characters cause the size of the StringBuffer to grow beyond its current capacity when 
characters are added, additional memory is automatically allocated. 

However, memory allocation is a relatively expensive operation and you can make your code more efficient, 
by initializing StringBuffer capacity to a reasonable first guess. This will minimize the number of times 
memory must be allocated for it. 

When using the insert methods of the StringBuffer class, you specify the index before which you 
want the data inserted. 


2.36.9 The toString method 


Frequently you will need to convert an object toa String object because you need to pass it to a method 
that accepts only String values (or perhaps for some other reason) . 

All classes inherit the toString method from the Object class. Many of the classes override this 
method to provide an implementation that is meaningful for objects of that class. 

In addition, you may sometimes need to override the toString method for classes that you define to 
provide a meaningful toString behavior for objects of that class. 

I explain the concept of overriding the toString method in detail in the module titled Java OOP: 
Polymorphism and the Object Class !*4 . 


2.36.10 Strings and the Java compiler 
In Java, you specify literal strings between double quotes as in: 


Literal strings 


"T ama literal string of the String type." 


You can use literal strings anywhere you would use a String object. 
You can also apply String methods directly to a literal string as in an earlier program (p. 247) that 
calls the length method on a literal string as shown below. 


Using String methods with literal strings 
StringBuffer str6 = new StringBuffer ( 
StringBuffer named str6".length()); 
Because the compiler automatically creates a new String object for every literal string, you can use a 


literal string to initialize a String object (without use of the new operator) as in the following code 
fragment from a previous program (p. 245) : 


String stri = "THIS STRING IS NAMED stri"; 


The above construct is equivalent to, but more efficient than the following, which, according to The Java 
Tutorial by Campione and Walrath, ends up creating two String objects instead of one: 
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String stri = new String("THIS STRING IS NAMED stri"); 


In this case, the compiler creates the first String object when it encounters the literal string, and the 
second one when it encounters new String() . 


2.36.11 Concatenation and the + operator 


The plus (+) operator is overloaded so that in addition to performing the normal arithmetic operations, it 
can also be used to concatenate strings. 

This will come as no surprise to you because we have been using code such as the following since the 
beginning of this group of Programming Fundamentals modules: 


String cat = "cat"; 


System.out.println("con" + cat + “enation"); 


According to Campione and Walrath, Java uses StringBuffer objects behind the scenes to implement 
concatenation. They indicate that the above code fragment compiles to: 


String cat = "cat"; 
System.out.println(new StringBuffer() .append("con"). 
append (cat) .append("enation") ); 


Fortunately, that takes place behind the scenes and we don’t have to deal directly with the syntax. 


2.36.12 Run the programs 


I encourage you to copy the code from Listing 1 (p. 245) and Listing 2 (p. 247) . Compile the code and 
execute it. Experiment with the code, making changes, and observing the results of your changes. Make 
certain that you can explain why your changes behave as they do. 


2.36.13 Looking ahead 


As you approach the end of this group of Programming Fundamentals modules, you should be preparing 
yourself for the more challenging ITSE 2321 OOP !”° tracks identified below: 


e Java OOP: The Guzdial-Ericson Multimedia Class Library !76 
e Java OOP: Objects and Encapsulation 1?" 
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2.36.14 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0280: Java OOP: String and StringBuffer 
e File: Jb0280.htm 

e Originally published: 1997 

e Published at cnx.org: 11/25/12 

e Revised: 12/05/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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2.37 Jb0280r Review'” 


2.37.1 Table of Contents 
e Preface (p. 254) 
e Questions (p. 254) 


1 (p. 254) , 2 (p. 254) , 3 (p. 254) , 4 (p. 254) , 5 (p. 254) , 6 (p. 255) , 7 (p. 255) , 8 (p. 255) , 
9 (p. 255) , 10 (p. 255) , 11 (p. 255) , 12 (p. 255) , 13 (p. 256) , 14 (p. 256) 

e Listings (p. 256) 

e Answers (p. 258) 

e Miscellaneous (p. 262) 


2.37.2 Preface 


This module contains review questions and answers keyed to the module titled Jb0280: Java OOP: String 
and StringBuffer 17° . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


2.37.3 Questions 
2.37.3.1 Question 1 


Java provides two different string classes from which string objects can be instantiated. What are they? 
Answer 1 (p. 262) 


2.37.3.2 Question 2 


True or false? The StringBuffer class is used for strings that are not allowed to change. The String 
class is used for strings that are modified by the program. If false, explain why. 
Answer 2 (p. 262) 


2.37.3.3 Question 3 


True or false? While the contents of a String object cannot be modified, a reference to a String object 
can be caused to point to a different String object. If false, explain why. 
Answer 3 (p. 262) 


2.37.3.4 Question 4 


True or false? The use of the new operator is required for instantiation of objects of type String . If 
false, explain your answer. 
Answer 4 (p. 262) 


2.37.3.5 Question 5 


True or false? The use of the new operator is required for instantiation of objects of type StringBuffer 
. If false, explain your answer 
Answer 5 (p. 261) 
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2.37.3.6 Question 6 
Provide a code fragment that illustrates how to instantiate an empty StringBuffer object of a default 
length and then use a version of the append method to put some data into the object. 
Answer 6 (p. 261) 
2.37.3.7 Question 7 


Without specifying any explicit numeric values, provide a code fragment that will instantiate an empty 
StringBuffer object of the correct initial length to contain the string "StringBuffer named str6" and then 
store that string in the object. 

Answer 7 (p. 261) 
2.37.3.8 Question 8 


Provide a code fragment consisting of a single statement showing how to use the Integer wrapper class to 
convert a string containing digits to an integer and store it in a variable of type int 
Answer 8 (p. 261) 


2.37.3.9 Question 9 


Explain the difference between the capacity method and the length method of the StringBuffer 
class. 
Answer 9 (p. 261) 


2.37.3.10 Question 10 


True or false? The following is a valid code fragment. If false, explain why. 


StringBuffer str6 = 
new StringBuffer ("StringBuffer named str6".length()); 


Answer 10 (p. 261) 


2.37.3.11 Question 11 


Which of the following code fragments is the most efficient, first or second? 


String stri "THIS STRING IS NAMED stri"; 


String stri = new String("THIS STRING IS NAMED stri"); 


Answer 11 (p. 261) 


2.37.3.12 Question 12 


Write a Java application that illustrates the fact that while a String object cannot be modified, the 
reference variable can be modified to point to a new String object, which can have the appearance of 
modifying the original String object. 

Answer 12 (p. 260) 
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2.37.3.13 Question 13 


Write a Java application that illustrates different ways to create String objects and StringBuffer objects. 
Answer 13 (p. 259) 


2.37.3.14 Question 14 


Write a Java application that illustrates conversion from string to numeric. 
Answer 14 (p. 258) 


2.37.4 Listings 


e Listing 1 (p. 258) . File SampProg26.java. 
e Listing 2 (p. 259) . File SampProg25.java. 
e Listing 3 (p. 260) . File SampProg24.java. 


What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None 


Display your nami 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 


Put your name here 
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2.37.5 Answers 
2.37.5.1 Answer 14 


Listing 1 . File SampProg26.java. 


/*File SampProg26. java from module 50 

Copyright 1997, R.G.Baldwin 

Without viewing the solution that follows, write a Java 
application that illustrates conversion from string to 
numeric, similar to the atoi() function in C. 


The output from the program should be: 
The value of the int variable num is 3625 


class SampProg26{ 
public static void main(String[] args){ 
int num = new Integer("3625") .intValue() ; 
System. out .print1n( 
"The value of the int variable num is " + num); 
}//end main() 
}//end class SampProg26 


Table 2.105 


Back to Question 14 (p. 256) 
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2.37.5.2 Answer 13 


Listing 2 . File SampProg25.java. 


/*File SampProg25. java from module 50 

Copyright 1997, R.G.Baldwin 

Write a Java application that illustrates different ways to 
create String objects and StringBuffer objects. 


The output from this program should be (line breaks 
manually inserted to make it fit the format): 


Create a String using new and display it 
String named str2 


Create a String without using new and display it 
String named str1 


Create, initialize, and display a StringBuffer using new 
StringBuffer named str3 


Try to create/initialize StringBuffer without using new 


Create an empty StringBuffer of default length 
Now put some data in it and display it 
StringBuffer named str5 


Create an empty StringBuffer and specify length when 
created 

Now put some data in it and display it 

StringBuffer named str6 


Try to create and append to StringBuffer without using new 
FE A EEEE EEE EEEE EEEE E EEEE EE AI I I I EEE EE 21 21 21 1 4 21 2k 2k a 4 2k 2 ak ak feof / 


class SampProg25{ 
void d(String displayString){//method to display strings 
System. out.println(displayString) ; 
}//end method d() 


public static void main(String[] args){ 
//instantiate an object to display methods 
SampProg25 o = new SampProg25() ; 


o.d("Create a String using new and display it"); 
String stri = new String("String named str2"); 
o.d(stri + "\n"); 


o.d( 
"Create a String without using new and display it"); 
String str2 = "String named stri"; 


o.d(str2 + n fiWajlable or free at Connexions <http://cnx.org/content /col11441/1.181> 


o.d("Create, initialize, and display a StringBuffer " 
+ "using new"); 
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Table 2.106 


Back to Question 13 (p. 256) 


2.37.5.3 Answer 12 


Listing 3 . File SampProg24.java. 


/*File SampProg24. java from module 50 

Copyright 1997, R.G.Baldwin 

Without viewing the solution that follows, Write a Java 
application that illustrates the fact that while a String 
object cannot be modified, the reference variable can be 
modified to point to a new String object which can have the 
appearance of modifying the original String object. 


The output from this program should be 


Display original string values 

THIS STRING IS NAMED stri 

This string is named str2 

Replace stri with another string 

Display new string named stri 

THIS STRING IS NAMED stri This string is named str2 
Terminating program 

FE AGO I IO I IGA I IOI AICI I I I KK 1 EE 21 EEE E a 4 2k E 2k ak ak ak / 


class SampProg24{ 
String stri "THIS STRING IS NAMED stri"; 
String str2 = "This string is named str2"; 


public static void main(String[] args){ 
SampProg24 thisObj = new SampProg24(); 
System.out.println("Display original string values"); 
System. out.println(thisObj.str1); 
System. out.println(thisObj.str2); 
System. out .print1n( 
"Replace stri with another string"); 
thisObj.stri = thisObj.stri + " " + thisObj.str2; 
System. out .println("Display new string named stri"); 
System. out .println(this0bj.str1); 
System.out.println("Terminating program") ; 
}//end main() 
}//end class SampProg24 


Table 2.107 


Back to Question 12 (p. 255) 
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2.37.5.4 Answer 11 


The first code fragment is the most efficient. 
Back to Question 11 (p. 255) 


2.37.5.5 Answer 10 


True. 
Back to Question 10 (p. 255) 


2.37.5.6 Answer 9 


The capacity method returns the amount of space currently allocated for the StringBuffer object. The 
length method returns the amount of space used. 
Back to Question 9 (p. 255) 


2.37.5.7 Answer 8 


int num = new Integer("3625") .intValue() ; 


Back to Question 8 (p. 255) 


2.37.5.8 Answer 7 


StringBuffer str6 = 
new StringBuffer ("StringBuffer named str6".length()); 
str6.append("StringBuffer named str6"); 


Back to Question 7 (p. 255) 


2.37.5.9 Answer 6 


StringBuffer str5 = 
new StringBuffer();//accept default initial length 
str5.append ( 
"StringBuffer named str5");//modify length as needed 


Back to Question 6 (p. 255) 


2.37.5.10 Answer 5 


True. 
Back to Question 5 (p. 254) 
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2.37.5.11 Answer 4 


False. A String object can be instantiated using either of the following statements: 


String stri = new String("String named str2"); 


String str2 "String named stri"; 


Back to Question 4 (p. 254) 


2.37.5.12 Answer 3 


True. 
Back to Question 3 (p. 254) 


2.37.5.13 Answer 2 


False. This statement is backwards. The String class is used for strings that are not allowed to change. 
The StringBuffer class is used for strings that are modified by the program. 
Back to Question 2 (p. 254) 


2.37.5.14 Answer 1 


The two classes are: 


e String 
e StringBuffer 


Back to Question 1 (p. 254) 


2.37.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0280r Review: String and StringBuffer 
e File: Jb0280r.htm 

e Originally published: 1997 

e Published at cnx.org: 11/29/12 

e Revised: 12/05/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
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compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


2.38 Jb0290: The end of Programming Fundamentals” 
2.38.1 Looking ahead 


You have now reached the end of this group of Programming Fundamentals 131 modules. 
The next stop along your journey to become a Java/OOP programmer should be either the OOP Self- 
Assessment 18? , or the course material for the ITSE 2321 OOP !*? tracks identified below: 


e Java OOP: The Guzdial-Ericson Multimedia Class Library 1°34 
e Java OOP: Objects and Encapsulation 135 


2.38.2 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jb0290: Java OOP: The end of Programming Fundamentals 
e File: Jb0290.htm 

e Published: 11/29/12 

e Revised: 12/05/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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ITSE 2321 Object-Oriented 
Programming (Java) 


3.1 Preface 


3.1.1 Jy0020: Java OOP: Preface to ITSE 2321' 
3.1.1.1 Table of Contents 


e Welcome (p. 265) 
e Course description (p. 265) 
e Course prerequisites (p. 266) 


Prerequisite waiver (p. 266) 


e Prior to enrolling (p. 266) 
e Course material (p. 267) 
Essence of OOP (p. 267) 
Multimedia (p. 267) 
The Java Collections Framework (p. 267) 
e Classroom schedule 
e Downloads (p. 267) 
e Miscellaneous (p. 267) 


3.1.1.2 Welcome 


Welcome to the course material for ITSE 2321 - Object-Oriented Programming (Java) , which I 
teach at Austin Community College ? in Austin, TX. 
The college website for this course is: http://www-.austincc.edu/baldwin/ 3 


3.1.1.3 Course description 


As of November 2012, the description for this course reads: 
"ITSE 2321 - Object-Oriented Programming (Java) 


1This content is available online at <http://cnx.org/content /m45222/1.10/>. 
*http://www.austincc.edu/ 
Shttp://www.austincc.edu/baldwin/ 
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Introduction to object-oriented programming. Emphasis on the fundamentals of structured design 
with classes, including development, testing, implementation, and documentation. Includes object-oriented 
programming techniques, classes, and objects." 


3.1.1.4 Course prerequisite 


The prerequisite for the course is COSC 1336 or department approval. 

As of November 2012, the description for the prerequisite course reads: 

"COSC 1336 - Programming Fundamentals I 

Introduces the fundamental concepts of structured programming. Topics include software development 
methodology, data types, control structures, functions, arrays, and the mechanics of running, testing, and 
debugging. This course assumes computer literacy. This course requires the same math skills necessary for 
College Algebra. Students should either have taken or be currently enrolled in College Algebra or a course 
that requires College Algebra." 


3.1.1.4.1 Prerequisite waiver 


Beginning in August of 2013, you might want to petition the department head for a waiver of the prerequisite 
course if you meet the following requirements: 


e You understand and can answer at least 80-percent of the questions in modules Ap0005 4 through 
Ap0060 Ž in the section titled OOP Self-Assessment © in a "closed-book" setting. 

e You understand and can write at least 80-percent of the programs in the Challenge program questions 
in modules Ap0005 7” through Ap0060 8 in the section titled OOP Self-Assessment ° in a "closed-book" 
setting. 

e You understand and can answer at least 80-percent of the questions posed on the Review pages in 
the section titled Programming Fundamentals !° in a "closed-book" setting 


3.1.1.5 Prior to enrolling 


I recommend that you understand and be able to answer at least 80-percent of the questions in modules 
AP010 !! through AP0060 !” in the self-assessment test 1° in a "closed-book" setting. 

Talso recommend that you understand and can write at least 80-percent of the programs in the Challenge 
program questions in modules Ap0005 ‘4 through Ap0060 !5 in the section titled OOP Self-Assessment 1° 
ina "closed-book" setting. 

I also recommend that you read and/or study all of the modules in the Programming Fundamentals 1” 
section in whatever depth is necessary to ensure that you can answer at least 80-percent of the questions 
posed on the Review pages of that section in a "closed-book" setting. 


“http://cnx.org/content /m45252 
*http://cnx.org/content /m45264 
Shttp://cnx.org/content /m45252 
“http://cnx.org/content /m45252 
Shttp://cnx.org/content /m45264 
°http://cnx.org/content /m45252 
http://cnx.org/content /m45179 
'lhttp://cnx.org/content /m45284 
'http://cnx.org/content /m45264 
13http://cnx.org/content /m45252 
4http://cnx.org/content /m45252 
1http://cnx.org/content /m45264 
16http://cnx.org/content /m45252 
'Thttp://cnx.org/content /m45179 
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3.1.1.6 Course material 


This course material consists of a more than 30 different modules arranged in the following major sections: 


e Essence of OOP 

e Multimedia 

e The Java Collections Framework 
e Practice Programs 


3.1.1.6.1 Essence of OOP 


The modules in the Essence of OOP section are more or less theoretical in nature. Sample programs in this 
section are intended to illustrate the OOP concepts being discussed with no effort being made to cause those 
programs to have any relation to real-world applications. 


3.1.1.6.2 Multimedia 


The modules in the Multimedia section are intended to illustrate OOP concepts using sample programs that 
clearly represent real-world applications. In particular, most of the sample programs in this section use OOP 
concepts to manipulate digital images of the sort that are produced by your digital camera. (See some 
examples here !* .) 


3.1.1.6.3 The Java Collections Framework 


The modules in this section are intended to help you learn about the Java Collections Framework. Once 
you learn how to use the framework, it is unlikely that you will need to reinvent common data structures, 
search algorithms, or sorting algorithms again, because those capabilities are neatly packaged within the 
framework. 


3.1.1.7 Downloads 


I encourage you to take advantage of all of the download options that cnx.org has to offer in order to 
customize this material for use in your organized courses or for personal self study. 
And if you find the material useful, I would like to hear more about how you are using it. 


3.1.1.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jy0020: Java OOP: Preface to ITSE 2321 
e File: Jy0020.htm 

e Published: 11/25/12 

e Revised: 12/05/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


18http://cnx.org/content /m44148 
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I also want you to know that I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.2 Essence of OOP 


3.2.1 Javal600: Objects and Encapsulation” 
3.2.1.1 Table of Contents 


e Preface (p. 268) 

The essence of OOP (p. 268) 

Viewing tip (p. 269) 

x Listings (p. 269) 

Preview (p. 269) 
Discussion and sample code (p. 269) 
Summary (p. 275) 
What’s next? (p. 276) 
Miscellaneous (p. 276) 


3.2.1.2 Preface 


This module is the first in a series of modules designed to teach you about the essence of Object-Oriented 
Programming (OOP) using Java. 


3.2.1.2.1 The essence of OOP 


My dictionary provides several definitions for the word essence. Among those definitions are the following: 


e The property necessary to the nature of a thing 
e The most significant property of a thing 


Thus, this miniseries will describe and discuss the necessary and most significant aspects of OOP using Java. 
In other words, I will discuss the essence of OOP using Java. For the first few modules, I will provide that 
information in a high-level format, devoid of any requirement to understand detailed Java syntax. In those 
cases where an understanding of Java syntax is required, I will provide the necessary syntax information in 
the form of supplementary notes. 

Therefore, if you have a general understanding of computer programming, you should be able to read 
and understand the modules in this miniseries, even if you don’t have a strong background in the Java 
programming language. 


19This content is available online at <http://cnx.org/content /m44153/1.4/>. 
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3.2.1.2.2 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


3.2.1.2.2.1 Listings 


e Listing 1 (p. 274) . Instantiating a new Radio object. 
e Listing 2 (p. 275) . Calling the playStation method. 


3.2.1.3 Preview 


In order to understand OOP, you need to understand the following three concepts: 


e Encapsulation 
e Inheritance 
e Polymorphism 


This module will concentrate on encapsulation. Encapsulation will be used as a springboard for a discussion 
of objects. 

A description of an object-oriented program will be provided, along with a description of an object, and 
how it relates to encapsulation. 

In order to relate object-oriented programming to the real world, a car radio will be used to illustrate and 
discuss several aspects of software objects. For example, you will learn that car radios, as well as software 
objects, have the ability to store data, along with the ability to modify or manipulate that data. 

You will learn that car radios, as well as software objects, have the ability to accept messages and to 
perform an action, modify their state, return a value, or some combination of the above. 

You will learn some of the jargon used in OOP, including persistence, state, messages, methods, and 
behaviors. 

You will learn where objects come from, and you will learn that a class is a set of plans that can be used 
to construct objects. You will learn that a Java object is an instance of a class. 

You will see a little bit of Java code, used to create an object, and then to send a message to that object 
(invoke a method on the object). 

You will learn about Java references and reference variables. You will also learn a little about memory 
allocation for objects and variables in Java. 


3.2.1.4 Discussion and sample code 


Purpose of the miniseries 

As mentioned earlier, I will describe and discuss the necessary and most significant aspects of OOP using 
Java. 

The three pillars 

Most books on OOP will tell you that in order to understand OOP, you need to understand the following 
three concepts: 


e Encapsulation 
e Inheritance 
e Polymorphism 


I agree with that assessment. 

(Some books will also add abstraction and/or late binding to the list. I tend to think of these two topics 
as being included in one or more of the three concepts listed above.) 

Begin with encapsulation 
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Generally, speaking, these three concepts increase in difficulty going down the list from top to bottom. 
Therefore, I will begin with Encapsulation and work my way down the list in successive modules. 

What is an Object-Oriented Program? 

Many authors would answer this question something like the following: 

An Object-Oriented Program consists of a group of cooperating objects, exchanging messages, for the 
purpose of achieving a common objective. 

What is an object? 

An object is a software construct that encapsulates data, along with the ability to use or modify that 
data, into a software entity. 

What is encapsulation? 

An interesting description of encapsulation was provided in an article by Rocky Lhotka regarding 
VB.NET. That description reads as follows: 

"Encapsulation is the concept that an object should totally separate its interface from its implementation. 
All the data and implementation code for an object should be entirely hidden behind its interface. 

The idea is that we can create an interface (Public methods in a class) and, as long as that interface 
remains consistent, the application can interact with our objects. This remains true even if we entirely 
rewrite the code within a given method thus the interface is independent of the implementation." 

I like this description, so I won’t try to improve on it. However, I will try to illustrate it in the paragraphs 
that follow. 

A real-world analogy 

Abstract concepts, such as the concept of an object or encapsulation, can often be best understood by 
comparing them to real-world analogies. One imperfect, but fairly good analogy to a software object is the 
radio in your car. 

The ability to store data 

Your car radio probably has the ability to store data, and to allow you to use and modify that data at 
will. (However, you can only use and modify that data through use of the human interface that is provided 
by the manufacturer of the radio.) 

The data that can be stored in your car radio probably includes a list of five or more frequencies that, 
correspond to your favorite radio stations. 

Using the stored data 

The radio provides a mechanism (human interface) that allows you to use the data stored therein. 

When you press one of the frequency-selector buttons on the front of the radio, the radio automatically 
tunes itself to the frequency corresponding to that button. (In this case, you, the user, are sending a 
message to the radio object asking it to perform a particular action.) 

If you have previously stored a favorite frequency in the storage location corresponding to that button, 
pressing the button (sending the message) will cause the radio station transmitting at that frequency to 
be heard through the radio’s speakers. 

If you have not previously stored a favorite frequency in the storage location corresponding to that button, 
you will probably only hear static. (That doesn’t mean that the radio object failed to respond correctly to 
the message. It simply means that its response was based on bad data.) 

Modifying the stored data 

The human interface also makes it possible for you to store or modify those five or more frequency values. 
This is done in different ways for different radios. On my car radio, the procedure is: 


e Manually tune the radio to the desired frequency 
e Press one of the buttons and hold it down for several seconds. 


When the radio beeps, I know that the new frequency value has been stored in a storage location that 
corresponds to that particular button. 
Please change your state 
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What I have done here is to send a message to the radio object asking it to change its state. The beep 
that I hear could be interpreted as the radio object returning a value back to me indicating that the mission 
has been accomplished. (Alternately, we might say that the radio object sent a message back to me.) 

We say that an object has changed its state when one or more data values stored in the object have been 
modified. 

We also say that when an object responds to a message, it will usually perform an action, change its 
state, return a value, or some combination of the above. 

Please perform an action 

Following this, when I press that button (send a message) , the radio object will be automatically tuned 

to that frequency. 


Historical note: While the ability to cause your car radio to remember your list of favorite 
stations may seem like a miracle of modern digital electronics, the truth is that radios had this 
capability long before they contained digital electronics. My first car had a radio that accomplished 
this feat using strings, pulleys, and levers. 


As I recall, in order to set the frequency for a button, I had to manually tune the radio to a station 
by turning a knob, pull one of the buttons out about a quarter of an inch, and then push it in again. 
From that point until I did the same thing again, whenever I pressed that button, some kind of a 
mechanical contraption caused a big rotary capacitor to turn just the right amount to tune for a 
particular radio station. 


Also, I remember my grandfather having a table-model radio in the early 1940’s that had radio 
buttons. He used them to select his favorite stations, as he surfed the airwaves. 


(Interestingly, the term radio button has now become a part of programming jargon, signifying 
certain visual components used in graphical user interfaces. ) 


Enough of that, now back to my modern car radio 

If I drive to Dallas and press a button that I have associated with a particular radio station in Austin, 
I will probably hear static. In that case, I may want to change the frequency value associated with that 
button. I can follow the same procedure described earlier to set the frequency value associated with that 
button to correspond to one of the radio stations in Dallas. (Again, I would be sending a message to the 
radio object asking it to change its state.) 

Jargon 

As you can see from the above discussion, the world of OOP is awash with jargon, and the ability to 
translate the jargon is essential to an understanding of the published material on OOP. Therefore, as we 
progress through this series of modules, I will introduce you to some of that jargon and try to help you 
understand the meaning of the jargon. 

Persistence 

The ability of your car radio to remember your list. of favorite stations is often referred to as persistence. 
An object that has the ability to store and remember values is often said to have persistence. 

State 

It is often said that the state of an object at a particular point in time is determined by the values 
stored in the object. In our analogy, even if we own identical radios, unless the two of us have the same list 
of favorite radio stations, associated with the same combination of buttons, the state of your radio object at 
any particular point in time will be different from the state of my radio object. 


Identical objects with identical states: It is perfectly OK for the two of us to own identical 
radios and to cause the two radio objects to contain the same list of frequencies. Even if two 
objects have the same state at the same time, they are still separate and distinct objects. While 
this is obvious in the real world of car radios, it may not be quite as obvious in the virtual world 
of computer programming. 
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Sending a message 

A person who speaks in OOP-speak might say that pressing one of the frequency-selector buttons on the 
front of the radio sends a message to the radio object, asking it to perform an action (tune to a particular 
station) . That person might also say that storing a new frequency that corresponds to a particular button 
entails sending a message to the radio object asking it to change its state. 

Invoking or calling a method 

Java-speak is a little more specific than general OOP-speak. In Java-speak, we might say that pressing 
one of the selector buttons on the front of the radio invokes or calls a method on the radio object. The 
behavior of the method is to cause the object to perform an action. 

As a practical matter, the physical manifestation of sending a message to an object in Java is to cause 
that object to execute one of its methods. 

Similarly, we might say that storing a new frequency that corresponds to a particular button invokes a 
setter method on the radio object. 

(In an earlier paragraph, I said that I could follow a specific procedure to set the frequency value 
associated with a button to correspond to one of the radio stations in Dallas. Note the use of the words set 
and setter in this jargon.) 

Behavior 

In addition to state, objects are often also said to have behavior . The overall behavior of an object is 
determined by the combined behaviors of its individual methods. 

For example, one of the behaviors exhibited by our radio object is the ability to play the radio station 
at a particular frequency. When a frequency is selected by pressing a selector button, the radio knows how 
to translate the radio waves at that frequency into audio waves compatible with our range of hearing, and 
to send those audio waves out through the speakers. 

Thus, the radio object behaves in a specific way in response to a message asking it to tune to a particular 
frequency. 

Where do objects come from? 

In order to mass-produce car radios, someone must first create a set of plans, (drawings, or blueprints) 
for the radio. Once the plans are available, the manufacturing people can produce millions of nearly identical 
radios. 

A class definition is a set of plans 

The same is true for software objects. In order to create a software object in Java, it is necessary for 
someone to first create a plan. 

In Java, we refer to that plan asa class . 

The class is defined by a Java programmer. Once the class definition is available, that programmer, (or 
other programmers) , can use it to produce millions of nearly identical objects. 

(While millions may sound like a lot of objects, I'm confident that since Java was released into the 
programming world around 1997, Java programmers around the world have created millions of objects using 
the standard Java class named Button .) 

An instance of a class 

If we were standing at the output end of the factory that produces car radios, we might pick up a 
brand new radio and say that it is an instance of the plans used to produce the radio. (Unless they were 
object-oriented programmers, the people around us might think we were a little odd when they hear us say 
that.) 

However, it is common jargon to refer to a software object as an instance of a class. 

To instantiate an object 

Furthermore, somewhere along the way, someone turned the word instance into a verb, and it is also 
common jargon to say that when creating a new object, we are instantiating an object. 

A little bit of code 

It is time to view a little bit of Java code. 

Assuming that you have access to a class definition, there are several different ways that you can create 
an object in Java. The most common way is using syntax similar to that shown in Listing 1 (p. 274) below. 
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Listing 1 . Instantiating a new Radio object. 


Radio myObjRef = new Radio(); 


Table 3.1 


What does this mean? 

Technically, the expression on the right-hand side of the equal sign in Listing 1 (p. 274) applies the new 
operator to a constructor for the class named Radio in order to cause the new object to come into being 
and to occupy memory. 

(Suffice it at this point to say that a constructor is code that assists in the creation of an object according 
to the plans contained in a class definition. The primary purpose of a constructor is to provide initial values 
for the new object, but the constructor is not restricted to that behavior alone.) 

A reference to the object 

The right-hand expression in Listing 1 (p. 274) returns a reference to the new object. 

What can you do with a reference? 

The reference can later be used to send messages to the new object (call methods belonging to the new 
object) . 

Saving the reference 

In order to use the reference later, it is necessary to save it for later use. 

The expression on the left-hand side of the equal sign in Listing 1 (p. 274) declares a variable of the type 

Radio named myObjRef 

(Because this type of variable will ultimately be used to store a reference to an object, we often refer to 
it by the term reference variable .) 

What does this mean? 

Declaring a variable causes memory to be set aside for use by the variable. Values can then be stored in 
that memory space and accessed later by calling up the name given to the variable when it was declared. 

Assignment of values 

The equal sign in Listing 1 (p. 274) causes the object’s reference returned by the right-hand expression to 
be assigned to, or saved as a value in, the reference variable named myObjRef (created by the left-hand 
expression) . 

Memory allocation 

Once the code in Listing 1 (p. 274) has finished execution, two distinct and different chunks of memory 
have been allocated and populated. 

One (potentially large) chunk of memory has been allocated (by the right-hand expression) to contain 
the object itself. This chunk of memory has been populated according to the plans contained in the definition 
of the class named Radio 

The other chunk of memory is a relatively small chunk allocated (by the left-hand expression) for the 
reference variable containing the reference to the object. 

Calling a method on the object 

Assume that the definition of the Radio class defines a method with the following format (also assume 
that this method is intended to simulate pressing a frequency-selector button on the front of the radio) : 

public void playStation(int stationNumber) 

What does this mean? 

Generally, in our radio-object context, this format implies that the behavior of the method named 
playStation will cause the specific station identified by an integer value passed as stationNumber to 
be selected for play. 

Public and void 

The void return type means that the method doesn’t return a value. 

The public modifier means that the button can be pressed by anyone in the car who can reach it. 
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(Car radios don’t have frequency-selector buttons corresponding to the private modifier in Java.) 

The method signature 

Continuing with our exposure of jargon, some authors would say that the following constitutes the 
method signature for the method identified above: 

playStation(int stationNumber) 

A little more Java code 

Listing 2 (p. 275) shows the code from the earlier listing, expanded to cause the method named 
playStation to be called. 


Listing 2 . Calling the playStation method. 


Radio myObjRef = new Radio(); 


myObjRef .playStation(3) ; 


Table 3.2 


The first statement in Listing 2 (p. 275) is a repeat of the statement from the earlier listing. It is repeated 
here simply to maintain continuity. 

Method invocation syntax 

The second statement in Listing 2 (p. 275) is new. 

This statement shows the syntax used to send a message to a Java object, or to call a method on that 
object (depending on whether you prefer OOP-speak or Java-speak) . 

Join the method name to the reference 

The syntax required to call a method on a Java object joins the name of the method to the object’s 
reference, using a period as the joining operator. 

(In this case, the object’s reference is stored in the reference variable named myObjRef . However, 
there are cases where an object’s reference may be created and used in the same expression without storing 
it in a reference variable. We often refer to such an object as an anonymous object.) 

Pressing a radio button 

Given the previous discussion, the numeric value 3, passed to the method when it is called, simulates 
the pressing of the third button on the front of the radio (or the fourth button if you elect to number your 
buttons 0, 1, 2, 3, 4, 5) . 


3.2.1.5 Summary 


This is the first in a miniseries of modules that describe and discuss the necessary and most significant 
(essential) aspects of OOP using Java. 
In order to understand OOP, you need to understand the following three concepts: 


e Encapsulation 
e Inheritance 
e Polymorphism 


This module has concentrated on encapsulation. Encapsulation was used as a springboard for a discussion 
of objects. 

A description of an object-oriented program was provided, along with a description of an object, and 
how it relates to encapsulation. 

In order to relate object-oriented programming to the real world, a car radio was used to illustrate and 
discuss several aspects of software objects. 
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You learned that car radios, as well as software objects, have the ability to store data, along with the 
ability to modify or manipulate that data. 

You learned that car radios, as well as software objects, have the ability to accept messages and to 
perform an action, modify their state, return a value, or some combination of the above. 

You learned some of the jargon used in OOP, including persistence, state, messages, methods, and 
behaviors. 

You learned where objects come from, and you learned that a class is a set of plans that can be used to 
construct objects. You learned that a Java object is an instance of a class. 

You saw a little bit of Java code, used to create an object, and then to send a message to that object 
(invoke a method on the object). 

You learned about Java references and reference variables. You learned a little about memory allocation 
for objects and variables in Java. 


3.2.1.6 What’s next? 


The next module in the miniseries will introduce you to the java class. 

Continuing with the real-world example introduced in this module, the next module will provide a 
complete Java program that simulates the manufacture and use of a car radio. 

Along the way, you will see examples of (or read about) class definitions, constructing objects, saving 
references to objects, setter methods, sending messages to objects, instance variables and methods, class 
variables, array objects, persistence, and objects performing actions. 


3.2.1.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Objects and Encapsulation 
e File: Javal600.htm 

e Published: 12/10/01 

e Revised: 12/05/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have misappropriated copies of my modules from cnx.org, con- 
verted them to Kindle books, and placed them for sale on Amazon.com showing me as the author. 
I receive no compensation for those sales and don’t know who does receive compensation. If you 
purchase such a book, please be aware that it is a bootleg copy of a module that is freely available 
on cnx.org. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.2.2 Java1600s Slides” 
3.2.2.1 Table of Contents 


e Instructions for viewing slides (p. 277) 
e Miscellaneous (p. 277) 


3.2.2.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Javal600: Objects and Encapsulation 7! . 

Click here ?? to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.2.2.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java1600s Slides: Objects and Encapsulation 
e File: Javal600s.htm 
e Published: 11/16/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


20This content is available online at <http://cnx.org/content /m48897/1.4/>. 
21 http://cnx.org/content /m44153/latest /?collection=col11441/latest 
?2http://cnx.org/content /m48897 /latest /a0-Index.htm 
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3.2.3 Javal602: Classes” 
3.2.3.1 Table of Contents 


e Preface (p. 278) 
Viewing tip (p. 278) 

x Images (p. 278) 

x Listings (p. 278) 
Preview (p. 278) 
Discussion and sample code (p. 279) 
Summary (p. 285) 
What’s next? (p. 285) 
Miscellaneous (p. 286) 
Complete program listing (p. 286) 


3.2.3.2 Preface 

This module is the second in a collection of modules designed to teach you about the essence of Object- 
Oriented Programming (OOP) using Java. 

3.2.3.2.1 Viewing tip 

I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 
3.2.3.2.1.1 Images 


e Image 1 (p. 281) . Screen output. 


3.2.3.2.1.2 Listings 


) . The class named Radio01. 

( ) . Constructing a Radio object. 
Listing 3 (p. 280) . Programming the radio buttons. 
Listing 4 (p. 281) . Pressing a button on the radio. 
Listing 5 (p. 282) . The Radio class. 
Listing 6 (p. 282) . An instance variable. 

( ) 

( ) 

( ) 


Listing 1 (p. 279 
Listing 2 (p. 280 


Listing 7 (p. 283) . The setStationNumber method. 
Listing 8 (p. 284) . The playStation method. 
Listing 9 (p. 287) . The program named Radio01. 


3.2.3.3 Preview 


This module will concentrate primarily on a discussion of the Java class. 

A simple Java program will be discussed to illustrate the definition and use of two different classes. Taken 
in combination, these two classes simulate the manufacture and use of the car radio object discussed in an 
earlier module. 

You will see how to write code to create a new Radio object by applying the mew operator to the 
class named Radio . You will also see how to save that object’s reference in a reference variable of type 
Radio . 


?3This content is available online at <http://cnx.org/content /m44150/1.4/>. 
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You will see how to write code that is used to simulate the association of a radio button with a particular 
radio station. 

You will see how to write code that is used to simulate the pressing of a radio button to play the radio 
station associated with that button. 

You will see the definition of a class named Radio01 . This class consists simply of the main method. 
The main method of a Java application is executed by the Java Virtual Machine when the application is 
run. Thus, it is the driver for the entire application. 

You will see the definition of a class named Radio . This class includes one instance variable and two 
instance methods. 

(The instance variable is a reference variable that refers to a special kind of object that I refer to as an 
array object. I will provide a very brief discussion on array objects in this module. I will have more to say 
about array objects in a subsequent module.) 

I will provide a short discussion of class variables, which are not used in this program. I will explain that 
the use of class variables can often lead to undesirable side effects. 

Finally, I will provide a very brief discussion of the syntax of a simple class definition in Java. 


3.2.3.4 Discussion and sample code 


What is a class? 

Į explained in an earlier module that a class is a plan from which many objects can be created. I likened 
the class definition to the plans from which millions of nearly identical car radios can be produced. 

A simple Java program 

In order to help you to get started on the right foot, and in support of future discussions, it will be 
advantageous to provide and discuss a simple Java program in this module. 

The car radio example 

Harking back to an earlier module, Listing 9 (p. 287) , near the end of this module, shows the code for 
a simple Java application that simulates the manufacture and use of a car radio. 

Explain in fragments 

In order to help you to focus specifically on important sections of code, I will explain the behavior of this 
program in fragments. 

Top-level classes 

This program contains two top-level class definitions. (Java also supports inner classes as opposed to 
top-level classes. Inner classes will be explained in detail in subsequent modules in this series.) 

The class named Radio01 

One of those class definitions, named RadioO1 , is shown in its entirety in Listing 1 (p. 279) . The 
other class named Radio will be discussed later. 


Listing 1 . The class named Radio01. 


public class Radio01{ 

public static void main( 

String[] args) { 

Radio myObjRef = new Radio(); 
myObjRef .setStationNumber (3,93.5) ; 
myObjRef .playStation(3) ; 

}//end main 

}//end class Radio01 


Table 3.3 
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The class named RadioO01 consists simply of the main method. The main method of a Java 
application is executed by the Java Virtual Machine when the application is run. Thus, it is the driver for 
the entire application. 

The driver class 

The code in Listing 1 (p. 279) simulates the manufacturer of the radio and the use of the radio by the 
end user. Without getting into a lot of detail regarding Java syntax, I will further subdivide and discuss this 
code in the following listings. 

Constructing a Radio object 

As discussed in a previous module, the code in Listing 2 (p. 280) applies the new operator to the 
constructor for the Radio class, causing a new object to be created according to the plans specified in the 
class named Radio 


Listing 2 . Constructing a Radio object. 


Radio myObjRef = new Radio(); 


Table 3.4 


Saving a reference to the Radio object 

Also as discussed in a previous module, the code in Listing 2 (p. 280) declares a reference variable of 
type Radio and stores the new object’s reference in that variable. 

Programming the radio buttons 

The code in Listing 3 (p. 280) is new to this discussion. This statement simulates the process of 
associating a particular radio station with a particular button - programming a button on the radio. 

As I explained in a previous module, this is accomplished for my car radio by manually tuning the radio to 
a desired station and then holding the radio button down until it beeps. You have probably done something 
similar to this to the radio in your car. 


Listing 3 . Programming the radio buttons. 


myObjRef.setStationNumber (3, 93.5); 


Table 3.5 


The statement in Listing 3 (p. 280) accomplishes the association of a simulated button to a simulated 
radio station by calling the method named setStationNumber on the reference to the Radio object. 
(Recall that this sends a message to the object asking it to change its state.) 

The parameters passed to the method cause radio button number 3 to be associated with the frequency 
93.5 MHz. (The value 93.5 is stored in the variable that represents button number 3.) 

Sending a message to the object 

Using typical OOP jargon, the statement in Listing 3 (p. 280) sends a message to the Radio object, 

asking it to change its state according to the values passed as parameters. 
Pressing a button on the radio 

Finally, the code in Listing 4 (p. 281) calls the method named playStation on the Radio object, 

passing the integer value 3 (the button number) as a parameter. 
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Listing 4 . Pressing a button on the radio. 


myObjRef .playStation(3) ; 


Table 3.6 


Another message 
This code sends a message to the object asking it to perform an action. In this case, the action requested 
by the message is: 


e Tune yourself to the frequency previously associated with button number 3 
e Play the radio station that you find at that frequency through the speakers 


How does this simulated radio play? 

This simple program doesn’t actually play music. As you will see later, this causes the message shown in 
Image 1 (p. 281) to appear on the computer screen, simulating the selection and playing of a specific radio 
station. 


Image 1 . Screen output. 


Playing the station at 93.5 Mhz 


Table 3.7 


The Radio class 
Listing 5 (p. 282) shows the class definition for the Radio class in its entirety. 
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Listing 5 . The Radio class . 


class Radiof 
//This class simulates the plans from 
// which the radio object is created. 
protected double[] stationNumber = 
new double[5]; 


public void setStationNumber ( 
int index,double freq){ 

stationNumber[index] = freq; 

}//end method setStationNumber 


public void playStation(int index){ 
System. out .print1n( 
"Playing the station at " 
+ stationNumber [index] 
+" Mhz"); 
}//end method playStation 


}//end class Radio 


Table 3.8 


Note that the code in Listing 5 (p. 282) does not contain an explicit constructor. If you don’t define 
a constructor when you define a new class, a default version of the constructor is provided on your behalf. 
That is the case for this simple program. 
(Constructors will be explained in detail in subsequent modules.) 
The plans for an object 
The code in Listing 5 (p. 282) provides the plans from which one or more objects that simulate physical 
radios can be constructed. 
An object instantiated (an object is an instance of a class) from the code in Listing 5 (p. 282) simulates 
a physical radio. I will subdivide this code into fragments and discuss it in the following listings. 
An instance variable 
In a previous module, I explained that we often say that an object is an instance of a class. (A physical 
radio is one instance of the plans used to produce it.) The code in Listing 6 (p. 282) shows the declaration 
and initialization of what is commonly referred to as an instance variable. 


Listing 6 . An instance variable. 


protected double[] stationNumber = 
new double[5]; 


Table 3.9 


Why call it an instance variable? 
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The name instance variable comes from the fact that every instance of the class (object) has one. 
(Every radio produced from the same set of plans has the ability to associate a frequency with each selector 
button on the front of the radio.) 

Class variables - an aside 

Note that Java also supports something called a class variable, which is different from an instance variable. 

Class variables are shared among all of the objects created from a given class. Stated differently, no 
matter how many objects are instantiated from a class definition, they all share a single copy of each class 
variable. 

There is no analogy to a class variable in a physical radio object. Radios are installed in different cars 
separated from each other by thousands of miles. Therefore, there can be no sharing of anything among 
different physical radio objects. 

(Well, that may not be entirely true. In today’s technology, different radio objects could potentially 
share something at a common location via satellite communications, but my car radio doesn’t do anything 
like that.) 

Class variables can cause undesirable side effects 

While class variables are relatively easy to use in Java, they are difficult to explain from an OOP viewpoint. 
Also, it is my opinion that from a good overall design viewpoint, class variables should be used very sparingly, 
if at all. 

Therefore, for the first several modules, I will exclude the possibility of class variables in this series of 
modules. (I will explain the use of class variables in Java in a subsequent module.) 

Reference to an array object 

Now, let’s get back to the instance variable named stationNumber shown in Listing 6 (p. 282) . 
Without getting into a lot of detail, this variable is also a reference variable, referring to an array object. 

The array object encapsulates a simple one-dimensional array with five elements of type double 
(Java array indices begin with zero, so the index values for this array extend from 0 to 4 inclusive. I will 
also discuss array objects in more detail in a subsequent module.) 

Persistence 

The array object is where the data is stored that associates the frequency of a radio station with the 
simulated physical button on the front of the radio. 

Each element in the array corresponds to one frequency-selector button on the front of the radio. Hence, 
the radio simulated by an object of the Radio class has five simulated frequency-selector buttons. 

The array object exists when the code in Listing 6 (p. 282) has finished executing. Each element in the 
array has been initialized to a value of 0.0 (double-precision float value of zero) . 

The setStationNumber method 

Listing 7 (p. 283) shows the setStationNumber method in its entirety 


Listing 7 . The setStationNumber method. 


public void setStationNumber ( 
int index,double freq){ 
stationNumber[index] = freq; 
}//end method setStationNumber 


Table 3.10 
Associates radio station with button 


This is the method that is used to simulate the behavior of having the user associate a particular button 
with a particular radio station. (Recall that this is accomplished on my car radio by manually tuning the 
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radio to a specific station and then holding the button down until it beeps. Your car radio probably operates 
in some similar way.) 
This method receives two incoming parameters: 


e An integer that corresponds to a button number (button numbers are assumed to begin with 0 and 
extend through 4 in order to match array indexes) 
e A frequency value to be associated with the indicated button. 


Save the frequency value 

The code in the method stores the frequency value in an element of the array object discussed earlier. 

The element number is specified by the value of index shown in square brackets in the assignment 
expression. (This syntax is similar to storing a value in an array element in most programming languages 
that I am familiar with.) 

Pressing a radio button to select a station 

Listing 8 (p. 284) shows the playStation method. This is the method that simulates the result of 
having the user press a button on the front of the radio to select a particular radio station for play. 


Listing 8 . The playStation method. 


public void playStation(int index){ 
System. out .print1n( 
"Playing the station at " 
+ stationNumber [index] 
+" Mhz"); 
}//end method playStation 


Table 3.11 


Selecting and playing a radio station 
The method receives an integer index value as an incoming parameter. This index corresponds to the 
number of the button pressed by the user. This method simulates the playing of the radio station by 


e extracting the appropriate frequency value from the array object, and 
e displaying that value on the computer screen along with some surrounding text. 


When called by code in the main method of this program, this method produces the message shown in 
Image 1 (p. 281) on the computer screen 

That pretty-well summarizes the behavior of this simple program. 

Class definition syntax 

There are a number of items that can appear in a class definition, including the following: 


Instance variables 
Class variables 
Instance methods 
Class methods 
Constructors 

Static initializer blocks 
Inner classes 
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Let’s keep it simple 

In order to make these modules as easy to understand as possible, the first several modules will ignore 
the possibility of class variables, class methods, static initializer blocks, and inner classes. 

As mentioned in the earlier discussion of class variables, these elements aren’t particularly difficult to 
use, but they create a lot of complications when attempting to explain OOP from the viewpoint of Java 
programming. 

Therefore, the first several modules in the series will assume that class definitions are limited to the 
following elements: 


e Instance variables 
e Instance methods 
e Constructors 


A constructor 

A constructor is used only once in the lifetime of an object. It participates in the task of creating 
(instantiating) and initializing the object. Following instantiation, the state and behavior of an object 
depends entirely on instance variables, class variables, instance methods, and class methods. 

Instance variables and methods 

The class named Radio discussed earlier contains 


e one instance variable named stationNumber , and 


e two instance methods named setStationNumber and playStation 


3.2.3.5 Summary 


This module has concentrated primarily on a discussion of the Java class. 

A simple Java program was discussed to illustrate the definition and use of two different classes. Taken 
in combination, these two classes simulate the manufacture and use of the car radio object introduced in an 
earlier module. 

You saw how to write code to create anew Radio object by applying the new operator to the class 
named Radio 

You also saw how to save that object’s reference in a reference variable of type Radio 

You saw how to write code (in an instance method named setStationNumber ) used to simulate 
the association of a radio button with a particular radio station. 

You saw how to write code (in an instance method named playStation ) to simulate the pressing of 
a radio button to play the radio station associated with that button. 

You saw the definition of the class named RadioO1_ , which consists simply of the main method. The 

main method of a Java application is executed by the Java Virtual Machine when the application is run. 

You saw the definition of the class named Radio . This class includes one instance variable and two 
instance methods. (The instance variable is a reference variable that refers to a special kind of object that 
I refer to as an array object. I provided a very brief discussion on array objects. I will have more to say on 
this topic in a subsequent module.) 

I provided a short discussion of class variables, which are not used in this program. I explained that the 
use of class variables can often lead to undesirable side effects. 

Finally, I provided a very brief discussion of the syntax of a simple class definition in Java. 


3.2.3.6 What’s next? 
Recall that in order to understand OOP, you must understand the following three concepts: 


e Encapsulation 
e Inheritance 
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e Polymorphism 


The next module will begin a discussion of inheritance. Overall, the discussion of inheritance will require 
more than one module. In the next module, I will discuss how the definition of a class defines a new data 
type. I will show you how to extend an existing class. I will explain what is inherited through inheritance. 
I will discuss code reuse and explicit constructors. 

Finally, I will illustrate all of the above in a simple program that extends the Radio class discussed in 
this module into a new class named Combo that simulates an upgraded radio containing a tape player. 
(Yes, at one point in history, car radios did contain tape players.) 


3.2.3.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Classes 
e File: Javal602.htm 

e Published: 12/24/01 

e Revised: 12/05/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have misappropriated copies of my modules from cnx.org, con- 
verted them to Kindle books, and placed them for sale on Amazon.com showing me as the author. 
I receive no compensation for those sales and don’t know who does receive compensation. If you 
purchase such a book, please be aware that it is a bootleg copy of a module that is freely available 
on cnx.org. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.3.8 Complete program listing 


Listing 9 provides a complete listing of the program named Radio01 
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Listing 9 . The program named Radio01. 


/*File Radio01.java 
Copyright 2001, R.G.Baldwin 
Simulates manufacture and use of a 
car radio. 


This program produces the following 
output on the computer screen: 


Playing the station at 93.5 Mhz 
FE A I I IO EEE EEEE EEEE E EEEE EEEE EEEN 


public class Radio01{ 
//This class simulates the 
// manufacturer and the human user 
public static void main( 
String[] args){ 
Radio myObjRef = new Radio(); 
myObjRef .setStationNumber (3,93.5); 
myObjRef .playStation(3) ; 
}//end main 
}//end class Radio01 


class Radiof 
//This class simulates the plans from 
// which the radio object is created. 
protected double[] stationNumber = 
new double[5]; 


public void setStationNumber ( 
int index,double freq){ 
stationNumber[index] = freq; 
}//end method setStationNumber 


public void playStation(int index){ 
System. out. print1n( 
"Playing the station at " 
+ stationNumber [index] 
+" Mhz"); 
}//end method playStation 


}//end class Radio 


Table 3.12 


-end- 
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3.2.4 Javal602s Slides” 
3.2.4.1 Table of Contents 


e Instructions for viewing slides (p. 288) 
e Miscellaneous (p. 288) 


3.2.4.2 Instructions for viewing slides 
This module contains lecture slides keyed to the module titled Javal602: Classes 7° . 

Click here 7° to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.2.4.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Javal602s Slides: Classes 
e File: Java1602s .htm 
e Published: 01/16/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


24This content is available online at <http://cnx.org/content /m48898/1.3/>. 
5http://cnx.org/content /m44150/latest /?collection=col11441/latest 
6http://cnx.org/content /m48898 /latest /a0-Index.htm 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


287 


3.2.5 Javal604: Inheritance, Part 1” 
3.2.5.1 Table of Contents 


e Preface (p. 289) 
Viewing tip (p. 289) 
x Images (p. 289) 
x Listings (p. 289) 


Preview (p. 289) 
Discussion and sample code (p. 290) 


3.2.5.2 Preface 


Summary (p. 296) 


What’s next? (p. 297) 
Miscellaneous (p. 297) 
Complete program listing (p. 297) 


This module is one of a series of modules designed to teach you about the essence of Object-Oriented 
Programming (OOP) using Java. 


3.2.5.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.2.5.2.1.1 Images 


e Image 1 (p. 296) . Program output. 


3.2.5.2.1.2 Listings 


3.2.5.3 Preview 


Listing 1 (p. 
p- 


Listing 2 
Listing 3 
Listing 4 


Listing 6 
Listing 7 
Listing 8 
Listing 9 


( 
( 
( 
Listing 5 (p. 
( 
( 
( 
( 


291) . 
292) . 
293) . 
293) . 
294) . 
. 294 
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Extending a class 
This module shows you how to extend an existing class to create a new class. The new class is the 


blueprint for a new type. 


Beginning of the Combo class. 
The insertTape method. 

The removeTape method. 
The playTape method. 
Modified Radio class. 


) . Tape status. 

) . Change to the playStation method. 
295) . 

) 


. The program named Radio02. 


The class named Radio02. 


Inheritance and code reuse 
The existing class is often called the superclass and the new class is often called the subclass . This 
is the mechanism for class inheritance in Java. Inheritance provides a formal mechanism for code reuse. 


27This content is available online at <http://cnx.org/content /m44193/1.5/>. 
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The subclass inherits all of the variables and all of the methods defined in the superclass. 

Although not explicitly demonstrated in this module, whenever you declare a reference variable whose 
type is defined by a class, that variable can be used to store references to objects instantiated from that class 
or instantiated from any subclass of that class. Furthermore, that reference can be used to call methods 
defined in or inherited into that class with no requirement for a cast. If the method is defined in that class 
and overridden in the subclass, and if the object is actually of the subclass type, the overridden version will 
be executed. This is polymorphism. 

Car radios with tape players 

A class from a previous module (whose objects represent car radios) is extended to define a new class, 
whose objects represent expanded car radios that contain tape players. (Yes, at one point in history, car 
radios did contain tape players instead of CDs.) 

Sending messages to the object 

Objects of the new class know how to respond to messages for inserting, playing, and removing a tape, 

in addition to those messages that are appropriate for objects of the original Radio class. 


3.2.5.4 Discussion and sample code 


The three pillars of OOP 
In an earlier module, I explained that most books on OOP will tell you that in order to understand OOP, 
you must understand the following three concepts: 


e Encapsulation 
e Inheritance 
e Polymorphism 


I agree with that assessment. 
Encapsulation 
The first module in this series provided an explanation of encapsulation. 
Inheritance 

This module (and some modules to follow) will provide an explanation of inheritance. I will use another 

simple program to explain the concept of inheritance. 
Polymorphism 
Polymorphism is the most complex of the three, and will be explained in future modules. 
A new data type 

Whenever you define a class in Java, you cause a new data type to become available to the program. 
Therefore, whenever you need a new data type, you can define a new class to make that type available. 

Extending a class 

Defining a new class (to create a new type) can involve a lot of effort. Sometimes you have an option 
that can greatly reduce the effort required to create your new type. If a class (type) already exists that is 
close to what you need, you can often extend that class to produce a new class that is closer to what you 
need. 

In many cases, this will require much less effort than that required to start from scratch and define a 
new class to establish a new type. The ability to extend one class into another new class is the essence of 
inheritance . 

According to the current jargon, the new class is called the subclass and the class that is extended is 
called the superclass 

Although not explicitly demonstrated in this module, whenever you declare a reference variable whose 
type is defined by a class, that variable can be used to store references to objects instantiated from that class 
or instantiated from any subclass of that class. Furthermore, that reference can be used to call methods 
defined in or inherited into that class with no requirement for a cast. If the method is defined in that class 
and overridden in the subclass, and if the object is actually of the subclass type, the overridden version will 
be executed. This is polymorphism. 
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What is inherited? 

The subclass inherits all of the variables and all of the methods defined in (or inherited into) the 
superclass, almost as if you had completely defined the new class from scratch, and had reproduced all of 
the code already defined in the existing superclasses. 

Code reuse 

Therefore, inheritance often makes it possible to define a new class with a minimum requirement to write 
new code by formally reusing the code that was previously written into the superclasses. Sometimes you can 
get by with simply extending the existing class. 

Sometimes, however, it is also necessary to make changes to the existing class to improve its ability to 
be extended in a meaningful way. (That is the case with the sample program discussed in this module, 
but the next module will show you how to avoid that issue.) It all depends on how the existing class was 
designed in the first place. 

The Radio class 

A previous program defined a class named Radio . Objects instantiated from the Radio class (see 
the previous modules for a discussion of instantiating objects) were intended to simulate car radios. (Note 
that the car radios simulated by objects of the Radio class didn’t have built-in tape players.) 

The Combo class 

In this module, I will use inheritance to extend the Radio class into a new class named Combo 
Objects instantiated from the Combo class are intended to simulate car radios with a built-in tape player. 

A complete listing of the new program is shown in Listing 9 (p. 298) near the end of the module. 

Will discuss in fragments 

As usual, I will discuss this program in fragments. I will begin my discussion with the definition of the 
new class named Combo . Then I will come back and discuss the class named Radio and the driver 
class named Radio02 

The combo class 
The code in Listing 1 (p. 291) shows the beginning of the class named Combo 


Listing 1 . Beginning of the Combo class. 


class Combo extends Radiof{ 


public Combo(){//constructor 
System. out .print1n( 
"Combo object constructed") ; 
}//end constructor 


Table 3.13 


Two new items 

There are two new items in Listing 1 (p. 291) that you did not see in the code in the previous modules. 

Combo extends Radio 

First, the class named Combo extends the class named Radio . This means that an object instantiated 
from the Combo class will contain all of the variables and all the methods defined in the Combo lass, 
plus all the variables and methods defined in the Radio class, and its superclasses. (The variables and 
methods of the superclass are inherited into the subclass.) 

An explicit constructor 

Second, the class named Combo defines an explicit constructor. 

Defining a constructor is optional 
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When defining a new class, it is not necessary to define a constructor. If you don’t define a constructor, 

a default constructor will be provided automatically. 
Why define a constructor? 

The intended purpose of a constructor is to initialize the instance variables belonging to the new object. 
However, constructors can do other things as well. In this case, I used an explicit constructor to display a 
message when the object is instantiated from the class named Combo 

Brief discussion of constructors 

I’m not going to discuss constructors in detail at this point. However, I will give you a few rules regarding 

constructors. 


e Constructors (like methods) can be overloaded. (I will explain what overloading means in a 
subsequent module.) 
The names of constructors must match the names of the classes in which they are defined. 
A constructor signature never indicates a return type (such as void or double) . 
The code in a constructor never contains a return statement. 


Instance methods 
The new class named Combo defines three instance methods, each of which has to do with the handling 
of tape in the tape player: 


e insert'Tape 
e removeTape 
e playTape 


(If you feel ambitious, you could upgrade this class even further to add features such as rewind, fast forward, 
pause, etc.). 

The insert Tape method 

The entire method named insertTape is shown in Listing 2 (p. 292) . This is the method that is used 
to simulate the insertion of a tape by the user. 


Listing 2 . The insertTape method. 


public void insertTape(){ 
System. out .println("Insert Tape"); 
tapeIn = true 


Table 3.14 


The most significant thing about the code in Listing 2 (p. 292) is the assignment of the true value to 
the boolean variable named tapeIn . Other than setting the value of the tapeIn variable to true , 
the code in Listing 2 (p. 292) simply prints some messages to indicate what is going on. 

What is tapelIn used for? 

As you will see shortly, the value of the variable named tapelIn is used to determine if it is possible to 
play the tape or to play the radio. 

According to that logic: 


e If tapelIn is true, it is possible to play the tape but it is not possible to play the radio. 
e If tapelIn is false, it is possible to play the radio, but it is not possible to play the tape. 
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tapelIn is not declared in the Combo class 

It is also worthy of note that in this version of the program, the variable named tapelIn is not declared 
in the Combo class (this will change in the next module where the program uses method overriding) . 
Rather, this variable is inherited from the Radio class that is extended by the Combo class. 

The removeTape method 

The removeTape method of the Combo class is shown in Listing 3 (p. 293) . Its behavior is pretty 
much the reverse of the insertTape method, so I won’t discuss it further. 


Listing 3 . The removeTape method. 


public void removeTape(){ 

System.out.println("Remove Tape"); 
tapeIn = false; 
System. out .print1n( 

" Tape is out"); 
System. out .print1n( 

" Radio is on"); 

}//end removeTape method\ 


Table 3.15 


The playTape method 
Listing 4 (p. 293) shows the method named playTape defined in the new Combo class. 


Listing 4 . The playTape method . 


public void playTape(){ 
System.out.println("Play Tape"); 
if(!tapeIn){//tapeIn is false 
System.out .print1n( 
" Insert the tape first"); 
yelse{//tapeIn is true 
System.out .print1n( 
" Tape is playing"); 
}//end if/else 
}//end playTape 


Table 3.16 


Confirm that the tape is ready 

Calling the method named playTape can be thought of as sending a message to the Combo object 
asking it to play the tape. The code in the playTape method checks to confirm that the value stored in 
the tapeIn variable is true before executing the request to play the tape. 

If tapeIn is false , an error message is displayed advising the user to insert the tape first. 

If tapeIn is true , the method prints a message indicating that the tape is playing. 

Modified Radio class 

Listing 5 (p. 294) shows the definition of the modified version of the class named Radio 
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Listing 5 . Modified Radio class. 


class Radiof 
protected double[] stationNumber = 
new double[5]; 
protected boolean tapeIn = false 


Table 3.17 


Tape status 
The first significant change that was made to the class named Radio is shown in Listing 6 (p. 294) 
below. 


Listing 6 . Tape status. 


protected boolean tapeIn = false; 


Table 3.18 


The statement in Listing 6 (p. 294) declares and initializes a new instance variable named tapeIn . As 
explained earlier, this instance variable is used to indicate whether or not a tape is inserted. (The Combo 
class inherits this variable.) 

Earlier in this module, I explained how the playTape method of the Combo class uses this value to 
determine whether or not to attempt to play a tape. 

Change to the playStation method 

The significant change that was made to the method named playStation of the Radio class is shown 
in Listing 7 (p. 294) below. 


Listing 7 . Change to the playStation method. 


if(!tapeIn){//tapeIn is false 
System.out .print1n( 
" Playing the station at " 
+ stationNumber [index] 
+ Mhz") ; 
yelse{//tapeIn is true 
System.out .print1n( 
" Remove the tape first") 


Table 3.19 


Check the tape status 

The code in Listing 7 (p. 294) uses tapeIn to check the tape status before attempting to tune the radio 
station and play the radio. If a tape is inserted, this method simply displays an error message instructing 
the user to remove the tape first. 
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So, what’s the big deal with inheritance? 

The fact that it was necessary for me to make changes to the class named Radio greatly reduced the 
benefit of inheritance in this case. However, even in this case, the use of inheritance eliminated the need for 
me to define a new class that reproduces all of the code in the class named Radio 

(In the next module, I will explain the process of overriding methods. I will show you how to use method 
overriding to accomplish these same purposes by extending the Radio class, without any requirement to 
modify the code in the Radio class. That will be a much better illustration of the benefits of inheritance.) 

The driver class 

The new driver class named RadioO02 is shown in Listing 8 (p. 295) . 


Listing 8 . The class named Radio02. 


public class Radio02{ 
//This class simulates the 
// manufacturer and the human user 
public static void main( 
String[] args) { 
Combo myObjRef = new Combo() 


Table 3.20 


New object of the Combo class 
The most significant change in this class (relative to the driver class named Radio01__ in a previous 
module) is the statement that instantiates a new object of the Combo class (instead of the Radio class) 


All of the other new code in Listing 8 (p. 295) is used to send messages to the new object. in order to 
exercise its behavior. 
Program output 


The Combo object responds to those messages by producing the screen output shown in Image 1 (p. 
296) . 
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Image 1 . Program output. 


Combo object constructed 

Button 3 programmed 
Play Radio 

Playing the station at 93.5 Mhz 
Insert Tape 

Tape is in 

Radio is off 
Play Radio 

Remove the tape first 
Remove Tape 

Tape is out 

Radio is on 
Play Radio 

Playing the station at 93.5 Mhz 
Play Tape 

Insert the tape first 
Insert Tape 

Tape is in 

Radio is off 
Play Tape 

Tape is playing 
Remove Tape 

Tape is out 

Radio is on 
Play Radio 

Playing the station at 93.5 Mhz 


Table 3.21 


An exercise for the student 
As the old saying goes, I will leave it as an exercise for the student to correlate the messages in Listing 
8 (p. 295) with the output shown in Image 1 (p. 296) . 


3.2.5.5 Summary 


Extending an existing class often provides an easy way to create a new type. This is primarily true when an 
existing class creates a type whose features are close to, but not identical to the features needed in the new 
type. 

When an existing class is extended to define a new class, the existing class is often called the superclass 
and the new class is often called the subclass. 

The subclass inherits all of the variables and all of the methods defined in the superclass and its super- 
classes. 

Although not explicitly demonstrated in this module, whenever you declare a reference variable whose 
type is defined by a class, that variable can be used to store references to objects instantiated from that class 
or instantiated from any subclass of that class. Furthermore, that reference can be used to call methods 
defined in or inherited into that class with no requirement for a cast. If the method is defined in that class 
and overridden in the subclass, and if the object is actually of the subclass type, the overridden version will 
be executed. This is polymorphism. 
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Inheritance provides a formal mechanism for code reuse. 

This module modifies slightly, and then extends the Radio class from a previous module to define a 
new class named Combo . Objects of the Combo class simulate car radios that contain tape players. 
Objects of the Combo class know how to respond to messages for inserting, playing, and removing a tape, 
in addition to those messages appropriate for an object of the Radio class. 

The changes that were required in the definition of the Radio class provide for the fact that it is not 
possible to play a radio station and to play a tape at the same time. This change was necessary because the 
original designer of the Radio class (this author) didn’t design that class with the idea of extending it 
to include a tape player. This points out the importance of thinking ahead when defining a new class. 


3.2.5.6 What’s next? 


In the next module, I will show you how to use method overriding to cause the behavior of a method 
inherited into a subclass to be appropriate for an object instantiated from the subclass. 

I will also show you how to use method overriding to eliminate the above requirement to modify the 
Radio class before extending it. 


3.2.5.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Inheritance, Part 1 
e File: Javal604.htm 

e Published: 01/14/02 

e Revised: 12/06/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have misappropriated copies of my modules from cnx.org, con- 
verted them to Kindle books, and placed them for sale on Amazon.com showing me as the author. 
I receive no compensation for those sales and don’t know who does receive compensation. If you 
purchase such a book, please be aware that it is a bootleg copy of a module that is freely available 
on cnx.org. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.5.8 Complete program listing 


A complete listing of the program is shown in Listing 9 (p. 298) below. 

The primary difference between this program and the program in the earlier module (whose objects 
simulate car radios) is the inclusion in this program of a new class named Combo . The class named 
Combo extends the original Radio class to create a new type of radio that also contains a tape player. 
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Listing 9 . The program named Radio02. 


/*File Radio02. java 
Copyright 2002, R.G.Baldwin 
Simulates the manufacture and use of a 
combination car radio and tape player. 


This program produces the following 
output on the computer screen: 


Combo object constructed 
Button 3 programmed 
Play Radio 
Playing the station at 93.5 Mhz 
Insert Tape 
Tape is in 
Radio is off 
Play Radio 
Remove the tape first 
Remove Tape 
Tape is out 
Radio is on 
Play Radio 
Playing the station at 93.5 Mhz 
Play Tape 
Insert the tape first 
Insert Tape 
Tape is in 
Radio is off 
Play Tape 
Tape is playing 
Remove Tape 
Tape is out 
Radio is on 
Play Radio 
Playing the station at 93.5 Mhz 
aKa ak 3k 3k 3K OO ak ak I I I 3K K K K IOI III aK 3K a 3K 3K 3 K K ÞK KK ÞK / 


public class Radio02{ 
//This class simulates the 
// manufacturer and the human user 
public static void main( 
String[] args) { 
Combo myObjRef = new Combo(); 
myObjRef .setStationNumber (3,93.5) ; 
myObjRef .playStation(3) ; 
myObjRef .insertTape() ; 
myObjRef .playStation(3); 
myObjRef .removeTape() ; 
myObjRef .playStation(3) ; 
myObjRef .playTape() ; 
myObjRef.insertTa eQ; , 
myObjRef .play valla, or free at Connexions <http://cnx.org/content /col11441/1.181> 
myObjRef .removeTape() ; 
myObjRef .playStation(3) ; 
}//end main 
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Table 3.22 


-end- 


3.2.6 Javal604s Slides” 
3.2.6.1 Table of Contents 


e Instructions for viewing slides (p. 299) 
e Miscellaneous (p. 299) 


3.2.6.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Javal604: Inheritance, Part 1 7° . 

Click here 3° to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.2.6.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java1604s Slides: Inheritance, Part 1 
e File: Javal604s -htm 
e Published: 01/16/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


28This content is available online at <http://cnx.org/content /m48908/1.3/>. 
?°http://cnx.org/content /m44193/latest /?collection=coll 1441 /latest 
3°http://cnx.org/content /m48908 /latest /a0-Index.htm 
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3.2.7 Javal606: Inheritance, Part 2” 
3.2.7.1 Table of Contents 


e Preface (p. 300) 
Viewing tip (p. 300) 

x Images (p. 300) 

x Listings (p. 300) 
Preview (p. 300) 
Discussion and sample code (p. 301) 
Summary (p. 305) 
What’s next? (p. 306) 
Miscellaneous (p. 306) 
Complete program listing (p. 306) 


3.2.7.2 Preface 


This module is one of a series of modules designed to teach you about the essence of Object-Oriented 
Programming (OOP) using Java. 


3.2.7.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.2.7.2.1.1 Images 


e Image 1 (p. 305) . Program output. 


3.2.7.2.1.2 Listings 


e Listing 1 (p. 302) . The class named Radio. 

e Listing 2 (p. 302) . Beginning of the Combo class. 

e Listing 3 (p. 303) . The overridden playStation method. 
e Listing 4 (p. 304) . The driver class. 

e Listing 5 (p. 307) . The program named Radio03. 


3.2.7.3 Preview 


This module builds on the previous module. It is recommended that you study that module before embarking 
on this module. 

The program discussed in this module extends a Radio class to produce a new class that simulates an 
upgraded car radio containing a tape player. 

Method overriding is used to modify the behavior of a method of the Radio class named playStation 
, to cause that method to behave appropriately when a tape has been inserted into the tape player. 


31This content is available online at <http://cnx.org/content /m44156/1.4/>. 
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3.2.7.4 Discussion and sample code 


Inheriting methods and variables 

When you define a class that extends another class, an object instantiated from your new class will 
contain all of the methods and all of the variables defined in your new class. The object will also contain all 
of the methods and all of the variables defined in all of the superclasses of your new class. 

The behavior of the methods 

The behavior of the methods defined in a superclass and inherited into your new class may, or may not, 
be appropriate for an object instantiated from your new class. If those methods are appropriate, you can 
simply leave them alone. 

Overriding to change behavior 

If the behavior of one or more methods defined in a superclass and inherited into your new class is not 
appropriate for an object of your new class, you can change that behavior by overriding the method in your 
new class. 

How do you override a method? 

To override a method in your new class, simply reproduce the name, argument list, and return type of 
the original method in a new method definition in your new class. Then provide a body for the new method. 
Write code in that body to cause the behavior of the overridden method to be appropriate for an object of 
your new class. 

Here is a more precise description of method overriding taken from the excellent book entitled The 
Complete Java 2 Certification Study Guide , by Roberts, Heller, and Ernest: 

"A valid override has identical argument types and order, identical return type, and is not less accessible 
than the original method. The overriding method must not throw any checked exceptions that were not 
declared for the original method." 

Any method that is not declared final can be overridden in a subclass. 

Overriding versus overloading 

Don’t confuse method overriding with method overloading. Here is what Roberts, Heller, and Ernest 
have to say about overloading methods: 

"A valid overload differs in the number or type of its arguments. Differences in argument names are not 
significant. A different return type is permitted, but is not sufficient by itself to distinguish an overloading 
method." 

Car radios with built-in tape players 

This module presents a sample program that duplicates the functionality of the program named Radio02 
discussed in the previous module. A class named Radio is used to define the specifics of objects intended 
to simulate car radios. 

A class named Combo extends the Radio class to define the specifics of objects intended to simulate 
improved car radios having built-in tape players. 

Modification of the superclass 

In the program named Radio02 in the previous module, it was necessary to modify the superclass 
before extending it to provide the desired functionality. (The requirement to modify the superclass before 
extending it seriously detracts from the benefits of inheritance.) 

No superclass modification in this module 

The sample program (named Radio03 ) in this module uses method overriding to provide the same 
functionality as the previous program named Radio02 , without any requirement to modify the superclass 
before extending it. (Thus this program is more representative of the benefits available through inheritance 
than was the program in the previous module.) 

Overridden playStation method 

In particular, a method named playStation_, defined in the superclass named Radio , is overridden 
in the subclass named Combo 

The original version of playStation in the superclass supports only radio operations. The overridden 
version of playStation defined in the subclass supports both radio operations and tape operations. 
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(The behavior of the version of playStation defined in the Radio class is not appropriate for an 
object of the Combo class. Therefore, the method was overridden in the Combo class to cause its 
behavior to be appropriate for objects instantiated from the Combo class.) 

A complete listing of the program is shown in Listing 5 near the end of this module. 

The class named Radio 

As usual, I will discuss the program in fragments. 

Listing 1 (p. 302) shows the superclass named Radio . This code is shown here for easy referral. It 
is identical to the code for the same class used in the program named RadioO01 discussed in an earlier 
module. 


Listing 1 . The class named Radio. 


class Radio{ 
protected double[] stationNumber = 
new double[5]; 


public void setStationNumber ( 
int index,double freq){ 

stationNumber[index] = freq; 

3//end method setStationNumber 


public void playStation(int index){ 
System. out .print1n( 
"Playing the station at " 
+ stationNumber [index] 
+" Mhz"); 
}//end method playStation 


Table 3.23 


Will override playStation 

The class named Combo (discussed below) will extend the class named Radio . The method 
named playStation , shown in Listing 1 (p. 302) , will be overridden in the class named Combo 

If you examine the code for the playStation method in Listing 1 (p. 302) , you will see that it assumes 
radio operations only and doesn’t support tape operations. That is the reason that it needs to be overridden. 

(For example, it doesn’t know that it should refuse to play a radio station when a tape is being played.) 

The Combo class 

Listing 2 (p. 302) shows the beginning of the class definition for the class named Combo . The 
Combo class extends the class named Radio 


Listing 2 . Beginning of the Combo class. 


continued on next page 
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class Combo extends Radiof{ 


private boolean tapeIn = false; 


Table 3.24 


The tapelIn variable 

The most important thing about the code in Listing 2 (p. 302) is the declaration of the instance variable 
named tapeIn 

(In the program named Radio02 in the previous module, this variable was declared in the class named 
Radio and inherited into the class named Combo . That was one of the undesirable changes required 
for the class named Radio in that module.) 

In this version of the program, the variable named tapelIn is declared in the subclass instead of in the 
superclass. Thus, it is not necessary to modify the superclass before extending it. 

The constructor 

The constructor in Listing 2 (p. 302) is the same as in the previous program named Radio02 , so I 
won’t discuss it further. 

The overridden playStation method 

The overridden version of the method named playStation is shown in Listing 3 (p. 303) . As you 
can see, this version of the method duplicates the signature of the playStation method in the superclass 
named Radio , but provides a different body. 


Listing 3 . The overridden playStation method. 


public void playStation(int index) { 
System.out.println("Play Radio"); 
if(!tapeIn){//tapeIn is false 
System.out .print1n( 
" Playing the station at " 
+ stationNumber [index] 
+ Mhz") ; 
yelse{//tapeIn is true 
System.out .print1n( 
" Remove the tape first"); 
}//end if/else 
}//end method playStation 


Table 3.25 


Aware of the tape system 

This overridden version of the playStation method in Listing 3 (p. 303) is aware of the existence of 
the tape system and behaves accordingly. 

Depending on the value of the variable named tapeIn_ , this method will either 


e tune and play a radio station, or 
e display a message instructing the user to remove the tape. 
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Which version of playStation is executed? 

When the playStation method is called on an object of the Combo class, the overridden version of 
the method (and not the original version defined in the superclass named Radio ) is the version that is 
actually executed. 

Although not particularly obvious in this example, this is one of the important characteristics of runtime 
polymorphism . When a method is called on a reference to an object, it is the type of the object (and not 
the type of the variable containing the reference to the object) that is used to determine which version of 
the method is actually executed. 

Three other instance methods 
The subclass named Combo defines three other instance methods: 


e insert'Tape 
e removeTape 
e playTape 


The code in these three methods is identical to the code in the methods having the same names in the 
program named RadioO02 in the previous module. I discussed that code in the previous module and won’t 
repeat that discussion here. You can view those methods in the complete listing of the program shown in 
Listing 5 (p. 307) near the end of this module. 

The driver class 

Listing 4 (p. 304) shows the code for the driver class named Radio03. 


Listing 4 . The driver class. 


public class Radio03{ 
//This class simulates the 
// manufacturer and the human user 
public static void main( 
String[] args) { 


Table 3.26 


The code in Listing 4 (p. 304) is also identical to the code in the program named Radio02 discussed 
in the previous module. Therefore, I won’t discuss it in detail here. 

A new object of the Combo class 

I present this code here solely to emphasize that this code instantiates a new object of the Combo 
class. This assures that the overridden version of the method named playStation will be executed by the 
statements in Listing 4 (p. 304) that call the playStation method. 

(Although it is not the casein Listing 4 (p. 304) , even if the reference to the object of type Combo 
had been stored in a reference variable of type Radio , instead of a reference variable of type Combo , 
calling the playStation method on that reference would have caused the overridden version of the method 
to have been executed. That is the essence of runtime polymorphism based on overridden methods in Java.) 

Program output 

This program produces the output shown in Image 1 (p. 305) on the computer screen. 
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Image 1 . Program output. 


Combo object constructed 
Play Radio 
Playing the station at 93.5 Mhz 
Insert Tape 
Tape is in 
Radio is off 
Play Radio 
Remove the tape first 
Remove Tape 
Tape is out 
Radio is on 
Play Radio 
Playing the station at 93.5 Mhz 
Play Tape 
Insert the tape first 
Insert Tape 
Tape is in 
Radio is off 
Play Tape 
Tape is playing 
Remove Tape 
Tape is out 
Radio is on 
Play Radio 
Playing the station at 93.5 Mhz 


Table 3.27 


I will leave it as an exercise for the student to compare this output with the messages sent to the object 
by the code in Listing 4 (p. 304) . 


3.2.7.5 Summary 


An object instantiated from a class that extends another class will contain all of the methods and all of the 
variables defined in the subclass, plus all of the methods and all of the variables inherited into the subclass. 

The behavior of methods inherited into the subclass may not be appropriate for an object instantiated 
from the subclass. You can change that behavior by overriding the method in the definition of the subclass. 

To override a method in the subclass, reproduce the name, argument list, and return type of the original 
method in a new method definition in the subclass. Make sure that the overridden method is not less 
accessible than the original method. Also, make sure that it doesn’t throw any checked exceptions that were 
not declared for the original method. 

Provide a body for the overridden method, causing the behavior of the overridden method to be appro- 
priate for an object of the subclass. Any method that is not declared final can be overridden in a subclass. 
The program discussed in this module extends a Radio class to produce a subclass that simulates an 
upgraded car radio containing a tape player. 

Method overriding is used to modify the behavior of an inherited method named playStation to cause 
that method to behave appropriately when a tape has been inserted into the radio. 

Method overriding is different from method overloading. Method overloading will be discussed in the 
next module. 
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3.2.7.6 What’s next? 


In the next module, I will explain the use of overloaded methods for the purpose of achieving compile-time 
polymorphism. 


3.2.7.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Inheritance, Part 2 
e File: Javal606.htm 

e Published: 01/28/02 

e Revised: 12/06/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have misappropriated copies of my modules from cnx.org, con- 
verted them to Kindle books, and placed them for sale on Amazon.com showing me as the author. 
I receive no compensation for those sales and don’t know who does receive compensation. If you 
purchase such a book, please be aware that it is a bootleg copy of a module that is freely available 
on cnx.org. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.7.8 Complete program listing 
A complete listing of the program is shown in Listing 5 (p. 307) below. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


305 


Listing 5 . The program named Radio03. 


Copyright 2002, R.G.Baldwin 
Simulates the manufacture and use of a 
combination car radio and tape player. 
Uses method overriding to avoid 
modifying the class named Radio. 


This program produces the following 
output on the computer screen: 


Combo object constructed 
Play Radio 
Playing the station at 93.5 Mhz 
Insert Tape 
Tape is in 
Radio is off 
Play Radio 
Remove the tape first 
Remove Tape 
Tape is out 
Radio is on 
Play Radio 
Playing the station at 93.5 Mhz 
Play Tape 
Insert the tape first 
Insert Tape 
Tape is in 
Radio is off 
Play Tape 
Tape is playing 
Remove Tape 
Tape is out 
Radio is on 
Play Radio 
Playing the station at 93.5 Mhz 
aKa ak 3k 3K 3K OO ak ak I I I ICI I I IOI IOI IK 3K 3K a 3K 3K K K ÞK KK ÞK / 


public class Radio03{ 
//This class simulates the 
// manufacturer and the human user 
public static void main( 
String[] args){ 
Combo myObjRef = new Combo(); 
myObjRef .setStationNumber (3,93.5); 
myObjRef .playStation(3) ; 
myObjRef .insertTape() ; 
myObjRef .playStation(3) ; 
myObjRef .removeTape() ; 
myObjRef .playStation(3); 
myObjRef .playTape() ; 
myObjRef.insertTape() ; 
nyObjRef pia ANAE. 
myObjRef .removeTape(); 
myObjRef .playStation(3) ; 
}//end main 


BH a” i a Piet ee ee 
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Table 3.28 


-end- 


3.2.8 Javal606s Slides” 
3.2.8.1 Table of Contents 


e Instructions for viewing slides (p. 308) 
e Miscellaneous (p. 308) 


3.2.8.2 Instructions for viewing slides 
This module contains lecture slides keyed to the module titled Javal606: Inheritance, Part 2 3° . 

Click here *4 to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.2.8.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Javal606s Slides: Inheritance, Part 2 
e File: Javal606s.htm 
e Published: 01/16/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


32This content is available online at <http://cnx.org/content /m48907/1.3/>. 
33http://cnx.org/content /m44156/latest /?collection=coll1441/latest 
34http://cnx.org/content /m48907 /latest /a0-Index.htm 
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3.2.9 Javal608: Polymorphism Based on Overloaded Methods” 
3.2.9.1 Table of Contents 


e Preface (p. 309) 

Viewing tip (p. 309) 

x Listings (p. 309) 

Preview (p. 309) 
Discussion and sample code (p. 310) 
Summary (p. 315) 
What’s next? (p. 316) 
Miscellaneous (p. 316) 
Complete program listings (p. 316) 


3.2.9.2 Preface 


This module is one of a series of modules designed to teach you about the essence of Object-Oriented 
Programming (OOP) using Java. 


3.2.9.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


3.2.9.2.1.1 Listings 


. Definition of the class named A. 


e Listing 1 (p. 312) 

e Listing 2 (p. 314) . Definition of the class named B. 

e Listing 3 (p. 314) . Definition of the driver class named Poly01. 
e Listing 4 (p. 317) . Complete program listing. 


3.2.9.3 Preview 


Previous modules introduced overloading and overriding methods. This module concentrates on the use 
of method overloading to achieve compile-time polymorphism . 

Every class in Java is a direct or indirect subclass of the class named Object . Methods defined in the 
class named Object are inherited into all other classes. Inherited methods that are not declared final 
may be overridden to make their behavior more appropriate to objects instantiated from the new class. 

Overloaded methods have the same name and different formal argument lists. They may or may not 
have the same return type. 

Polymorphism manifests itself in Java in the form of multiple methods having the same name. This mod- 
ule concentrates on method overloading, sometimes referred to as compile-time polymorphism . Subsequent 
modules concentrate on method overriding, sometimes referred to as runtime polymorphism . 

Overloaded methods may all be defined in the same class, or may be defined in different classes as long 
as those classes have a superclass-subclass relationship. 


35This content is available online at <http://cnx.org/content /m44182/1.4/>. 
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3.2.9.4 Discussion and sample code 


Three concepts 
In an earlier module, I explained that most books on OOP will tell you that in order to understand OOP, 
you must understand the following three concepts: 


e Encapsulation 
e Inheritance 
e Polymorphism 


I agree with that assessment. 

Encapsulation and inheritance 

Previous modules in this series have explained Encapsulation and Inheritance. This module will tackle 
the somewhat more complex topic of Polymorphism. 

Overloading and overriding methods 

In the modules on inheritance, you learned a little about overloading and overriding methods (you will 
learn more about these concepts as you progress through these modules) . This module concentrates on the 
use of overloaded methods to achieve compile-time polymorphism. 

Real-world scenarios 

The sample programs that I used in the previous modules in this series dealt with two kinds of car radios: 


e Plain car radios 
e Car radios having built-in tape players 


I couched those programs in a real-world scenario in an attempt to convince you that encapsulation and 
inheritance really do have a place in the real world. 

Programs were fairly long 

However, even though those programs were simple in concept, they were relatively long. That made them 
somewhat difficult to explain due simply to the amount of code involved. 

Keep it short and simple 

Beginning with this module, I am going to back away from real-world scenarios and begin using sample 
programs that are as short and as simple as I know how to make them, while still illustrating the important 
points under discussion. 

My objective in this and future modules is to make the polymorphic concepts as clear as possible without 
having those concepts clouded by other programming issues. 

I will simply ask you to trust me when I tell you that polymorphism has enormous applicability in the 
real world. 

A little more on inheritance 

There is another aspect of inheritance that I didn’t explain in the previous modules. 

Every class extends some other class 

Every class in Java extends some other class. If you don’t explicitly specify the class that your new class 
extends, it will automatically extend the class named Object 

A class hierarchy 

Thus, all classes in Java exist in a class hierarchy where the class named Object forms the root of the 
hierarchy. 

Some classes extend Object directly, while other classes are subclasses of Object further down the 
hierarchy. 

Methods in the Object class 

The class named Object defines default versions of the following methods: 


e clone() 


e equals(Object obj) 
e finalize() 
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e getClass() 

e hashCode() 

e notify() 

e notifyAll() 

e toString() 

e wait() 

e wait(long timeout) 

e wait(long timeout, int nanos) 


As you can see, this list includes three overloaded versions of the method named wait . The three versions 
have the same name but different formal argument lists. Thus, these three methods are overloaded versions 
of the method name wait 

Every class inherits these eleven methods 

Because every class is either a direct or indirect subclass of Object , every class in Java, (including 
new classes that you define) , inherit these eleven methods. 

To be overridden ... 

Some of these eleven methods are intended to be overridden for various purposes. However, some of 
them, such as getClass , notify , and the three versions of wait , are intended to be used directly 
without overriding. (Although not shown here, these five methods are declared to be final , meaning that 
they may not be overridden.) 

What is polymorphism? 
The meaning of the word polymorphism is something like one name, many forms. 
How does Java implement polymorphism? 

Polymorphism manifests itself in Java in the form of multiple methods having the same name. 

In some cases, multiple methods have the same name, but different formal argument lists (overloaded 
methods) . In other cases, multiple methods have the same name, same return type, and same formal 
argument list (overridden methods) . 

Three distinct forms of polymorphism 

From a practical programming viewpoint, polymorphism manifests itself in three distinct forms in Java: 


e Method overloading 
e Method overriding through inheritance 
e Method overriding through the Java interface 


Method overloading 

I will begin the discussion of polymorphism with method overloading, which is the simplest of the three. 
I will cover method overloading in this module and will cover polymorphism based on overridden methods 
and interfaces in subsequent modules. 

Method overloading versus method overriding 

Don’t confuse method overloading with method overriding . 

Java allows you to have two or more method definitions in the same scope with the same name, provided 
that they have different formal argument lists. 

More specifically, here is what Roberts, Heller, and Ernest have to say about overloading methods in 
their excellent book titled The Complete Java 2 Certification Study Guide 

"A valid overload differs in the number or type of its arguments. Differences in argument names are not 
significant. A different return type is permitted, but is not sufficient by itself to distinguish an overloading 
method." 

Similarly, as a preview of things to come, here is what they have to say about method overriding: 

"A valid override has identical argument types and order, identical return type, and is not less accessible 
than the original method. The overriding method must not throw any checked exceptions that were not 
declared for the original method." 

You should read these two descriptions carefully and make certain that you recognize the differences. 
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Compile-time polymorphism 

Some authors refer to method overloading as a form of compile-time polymorphism , as distinguished 
from run-time polymorphism . 

This distinction comes from the fact that, for each method call, the compiler determines which method 

(from a group of overloaded methods) will be executed, and this decision is made when the program is 

compiled. (In contrast, I will tell you later that the determination of which overridden method to execute 
isn’t made until runtime.) 

Selection based on the argument list 

In practice, the compiler simply examines the types, number, and order of the parameters being passed 
in a method call, and selects the overloaded method having a matching formal argument list. 

A sample program 

I will discuss a sample program named Poly01 to illustrate method overloading. A complete listing of 
the program can be viewed in Listing 4 (p. 317) near the end of the module. 

Within the class and the hierarchy 

Method overloading can occur both within a class definition, and vertically within the class inheritance 
hierarchy. (In other words, an overloaded method can be inherited into a class that defines other overloaded 
versions of the method.) The program named Poly01 illustrates both aspects of method overloading. 

Class B extends class A, which extends Object 

Upon examination of the program, you will see that the class named A extends the class named 
Object . You will also see that the class named B extends the class named A 

The class named Poly01 is a driver class whose main method exercises the methods defined in the 
classes named A and B 

Once again, this program is not intended to correspond to any particular real-world scenario. Rather, it 
is a very simple program designed specifically to illustrate method overloading. 

Will discuss in fragments 

As is my usual approach, I will discuss this program in fragments. The code in Listing 1 (p. 312) defines 
the class named A , which explicitly extends Object 


Listing 1 . Definition of the class named A. 


class A extends Object{ 
public void m(){ 
System. out.printin("m(Q)"); 
3//end method m() 
}//end class A 


Table 3.29 


Redundant code 

Explicitly extending Object is not required (but it also doesn’t hurt anything to do it) . 

By default, the class named A would extend the class named Object automatically, unless the class 
named A explicitly extends some other class. 

The method named m() 

The code in Listing 1 (p. 312) defines a method named m() . Note that this version of the method 
has an empty argument list (it doesn’t receive any parameters when it is executed) . The behavior of the 
method is simply to display a message indicating that it has been called. 

The class named B 

Listing 2 (p. 314) contains the definition for the class named B . The class named B extends the 

class named A , and inherits the method named m defined in the class named A 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


311 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


312 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Listing 2 . Definition of the class named B. 


class B extends A{ 
public void m(int x){ 
System. out .println("m(int x)"); 
}//end method m(int x) 


public void m(String y){ 
System. out .println("m(String y)"); 
}//end method m(String y) 
}//end class B 


Table 3.30 


Overloaded methods 


In addition to the inherited method named m , the class named B defines two overloaded versions of 
the method named m : 


e m(int x) 
e m(String y) 


(Note that each of these two versions of the method receives a single parameter, and the type of the 
parameter is different in each case.) 
As with the version of the method having the same name defined in the class named A , the behavior 
of each of these two methods is to display a message indicating that it has been called. 
The driver class 


Listing 3 (p. 314) contains the definition of the driver class named Poly01 


Listing 3 . Definition of the driver class named Poly01. 


public class Poly01{ 

public static void main(String[] args){ 
B var = new B(); 
var.m(); 
var.m(3); 
var.m("String") ; 

}//end main 

}//end class Poly01 


Table 3.31 


Call all three overloaded methods 
The code in the main method 


e Instantiates a new object of the class named B , and 


e Successively calls each of the three overloaded versions of the method named m on the reference to 
that object. 
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One version is inherited 

The overloaded version of the method named m , defined in the class named A ,is inherited into the 
class named B . Therefore, it can be called on a reference to an object instantiated from the class named 
B 

Two versions defined in class B 

The other two versions of the method named m are defined in the class named B . Thus, they also 
can be called on a reference to an object instantiated from the class named B 

The output 

As you would expect, the output produced by sending messages to the object asking it to execute each 
of the three overloaded versions of the method named m is: 


m() 
m(int x) 
m(String y) 


Note that the values of the parameters passed to the methods do not appear in the output. Rather, in this 
simple example, the parameters are used solely to make it possible for the compiler to select the correct 
version of the overloaded method to execute. 

This output confirms that each overloaded version of the method is properly selected for execution based 
on the matching of method parameters to the formal argument list of each method. 


3.2.9.5 Summary 


Previous modules introduced overloading and overriding methods. This module concentrates on the use 
of method overloading to achieve compile-time polymorphism . 

All classes in Java form a hierarchy with a class named Object at the root of the hierarchy. Thus, 
every class in Java is a direct or indirect subclass of the class named Object 

If a new class doesn’t explicitly extend some other class, it will, by default, automatically extend the 
class named Object 

The Object class defines default versions of eleven different methods. These methods are inherited 
into all other classes, and some (those not declared final ) may be overridden to make their behavior 
more appropriate for objects instantiated from the new class. 

Overloaded methods have the same name and different formal argument lists. They may or may not 
have the same return type. 

Three of the eleven methods defined in the class named Object are overloaded versions of the method 
name wait . One version takes no parameters. A second version takes a single parameter of type long 
The third version takes two parameters, one of type long , and one of type int 

The word polymorphism means something like one name, many forms . Polymorphism manifests itself 
in Java in the form of multiple methods having the same name. 

Polymorphism manifests itself in three distinct forms in Java: 


e Method overloading 
e Method overriding through inheritance 
e Method overriding through the Java interface 


This module concentrates on method overloading , sometimes referred to as compile-time polymorphism . 
This form of polymorphism is distinguished by the fact that the compiler selects a specific method from two 
or more overloaded methods on the basis of the types and the number of parameters passed to the method 
when it is called. The selection is made when the program is compiled (rather than being made later when 
the program is run) . 

Overloaded methods may all be defined in the same class, or may be defined in different classes as long 
as those classes have a superclass-subclass relationship in the class hierarchy. 
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The sample program in this module illustrates three overloaded versions of the same method name with 
two of the versions being defined in a single class, and the other version being defined in the superclass of 
that class. 


3.2.9.6 What’s next? 


The next module in this collection teaches you about assignment compatibility, type conversion, and casting 
for both primitive and reference types. 

It also teaches you about the relationship between reference types, method calls, and the location in the 
class hierarchy where a method is defined. 


3.2.9.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Polymorphism Based on Overloaded Methods 
e File: Javal608.htm 

e Published: 02/11/02 

e Revised: 12/06/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have misappropriated copies of my modules from cnx.org, con- 
verted them to Kindle books, and placed them for sale on Amazon.com showing me as the author. 
I receive no compensation for those sales and don’t know who does receive compensation. If you 
purchase such a book, please be aware that it is a bootleg copy of a module that is freely available 
on cnx.org. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.9.8 Complete program listings 
A complete listing of the program is shown in Listing 4 (p. 317) below. 
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Listing 4 . Complete program listing. 


/*File Poly01.java 
Copyright 2002, R.G.Baldwin 


Program output is: 

m() 

m(int x) 

m(String y) 

FE A I IO EEE EEEE EEEE E I I aK EEEE EEEN 


class A extends Object{ 
public void m(){ 
System.out.printin("m(Q)"); 
}//end method m() 
}//end class A 


class B extends Af 
public void m(int x){ 
System.out.println("m(int x)"); 
}//end method m(int x) 


public void m(String y){ 
System.out.println("m(String y)"); 
}//end method m(String y) 
}//end class B 


public class Poly01{ 
public static void main(String[] args){ 
B var = new B(); 
var.m(); 
var.m(3); 
var.m("String") ; 
}//end main 
}//end class Poly01 


Table 3.32 


-end- 


3.2.10 Javal1608s Slides” 
3.2.10.1 Table of Contents 


e Instructions for viewing slides (p. 318) 
e Miscellaneous (p. 318) 


36This content is available online at <http://cnx.org/content /m48903/1.3/>. 
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3.2.10.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java1608: Polymorphism Based on Overloaded 
Methods 37 . 

Click here 38 to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.2.10.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Javal608s Slides: Polymorphism Based on Overloaded Methods 
e File: Javal608s.htm 
e Published: 01/16/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.2.11 Java1610: Polymorphism, Type Conversion, Casting, etc.” 
3.2.11.1 Table of Contents 


e Preface (p. 319) 
Viewing tip (p. 319) 
x Listings (p. 319) 

e Preview (p. 319) 


e Discussion and sample code (p. 320) 
e Summary (p. 326) 


87http://cnx.org/content /m44182/latest /?collection=col11441 /latest 
38http://cnx.org/content /m48903/latest /a0-Index.htm 
3°This content is available online at <http://cnx.org/content /m44168/1.4/>. 
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e What’s next? (p. 326) 
e Miscellaneous (p. 326) 
e Complete program listings (p. 327) 


3.2.11.2 Preface 


This module is one of a series of modules designed to teach you about the essence of Object-Oriented 
Programming (OOP) using Java. 


3.2.11.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


3.2.11.2.1.1 Listings 


e Listing 1 (p. 322) . Definition of the class named A. 
e Listing 2 (p. 322) . Definition of the class named B. 
e Listing 3 (p. 322) . Definition of the class named C. 
e Listing 4 (p. 323) . Beginning of the class named Poly02. 
e Listing 5 (p. 323) . An illegal operation. 

e Listing 6 (p. 324) . An ineffective downcast. 

e Listing 7 (p. 324) . A downcast to type B. 

e Listing 8 (p. 325) . Declare a variable of type B. 

e Listing 9 (p. 325) . Cannot be assigned to type C. 
e Listing 10 (p. 325) . Another failed attempt. 

e Listing 11 (p. 328) . Complete program listing. 


3.2.11.3 Preview 


This module discusses type conversion for both primitive and reference types. 

A value of a particular type may be assignment compatible with variables of other types, in which case 
the value can be assigned directly to the variable. Otherwise, it may be possible to perform a cast on the 
value to change its type and assign it to the variable as the new type. 

With regard to reference types, whether or not a cast can be successfully performed 


e depends on the relationships of the classes involved in the class hierarchy. 


A reference to any object can be assigned to a reference variable of the type Object , because the Object 
class is a superclass of every other class. 

When we cast a reference along the class hierarchy in a direction from the root class Object toward 
the leaves, we often refer to it as a downcast . 

Whether or not a method can be called on a reference to an object depends on 


e the current type of the reference, and 
e the location in the class hierarchy where the method is defined. 


In order to use a reference of a class type to call a method, the method must be defined at or above that 
class in the class hierarchy. 

A sample program is provided that illustrates much of the detail involved in type conversion, method 
calls, and casting with respect to reference types. 
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3.2.11.4 Discussion and sample code 


What is polymorphism? 

As a quick review, the meaning of the word polymorphism is something like one name, many forms 

How does Java implement polymorphism? 

Polymorphism manifests itself in Java in the form of multiple methods having the same name. 

In some cases, multiple methods have the same name, but different formal argument lists (overloaded 
methods, which were discussed in a previous module) . 

In other cases, multiple methods have the same name, same return type, and same formal argument list 
(overridden methods) . 

Three distinct forms of polymorphism 

From a practical programming viewpoint, polymorphism manifests itself in three distinct forms in Java: 


e Method overloading 
e Method overriding through inheritance 
e Method overriding through the Java interface 


I covered method overloading as one form of polymorphism in a previous module. 

We need to backtrack 

In this module, I will backtrack a bit and discuss the conversion of references from one type to another. 

I will begin the discussion of polymorphism through method overriding and inheritance in the next 
module. I will cover interfaces in a future module. 

Assignment compatibility and type conversion 

As a background for polymorphism, you need to understand something about assignment compatibility 
and type conversion . 

A value of a given type is assignment compatible with another type if 


e a value of the first type 
e can be successfully assigned to a variable of the second type. 


Type conversion and the cast operator 

In some cases, type conversion happens automatically. In other cases, type conversion must be forced 
through the use of a cast operator 

A cast operator is a unary operator, which has a single right operand. The physical representation of 
the cast operator is the name of a type inside a pair of matched parentheses, as in: 


(int) 


Applying a cast operator 

Applying a cast operator to the name of a variable doesn’t actually change the type of the variable. 
However, it does cause the contents of the variable to be treated as a different type for the evaluation of the 
expression in which the cast operator is contained. Thus, the application of a cast operator is a short-term 
event. 

Primitive values and type conversion 

Assignment compatibility issues come into play for both primitive types and reference types. 

However, values of type boolean can only be assigned to variables of type boolean (you cannot change 
the type of a boolean) . 

Otherwise, a primitive value can be assigned to any variable of a type 


e whose range is as wide or wider 
e than the range of the type of the value. 
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In that case, the type of the value is automatically converted to the type of the variable. 

(For example, types byte and short can be assigned to a variable of type int without 
the requirement for a cast because type int has a wider range than either type byte or type 
short.) 

Conversion to narrower range 

On the other hand, a primitive value of a given type cannot be assigned to a variable of a type with a 
narrower range than the type of the value, 


e unless the cast operator is used to force a type conversion. 


Oftentimes, such a conversion will result in the loss of data, and that loss is the responsibility of the 
programmer who performs the cast. 

Assignment compatibility for references 

Assignment compatibility, with respect to references, doesn’t involve range issues, as is the case with 
primitives. Instead, the reference to an object instantiated from a given class can be assigned to: 


e Any reference variable whose type is the same as the class from which the object was instantiated. 


Any reference variable whose type is a superclass of the class from which the object was instantiated. 
Any reference variable whose type is an interface that is implemented by the class from which the 
object was instantiated. 

e Any reference variable whose type is an interface that is implemented by a superclass of the class from 
which the object was instantiated, and 

e A few other cases involving the class and interface hierarchy. 


Such an assignment does not require the use of a cast operator. 

Type Object is completely generic 

A reference to any object can be assigned to a reference variable of the type Object , because the 
Object class is a superclass of every other class. 

Converting reference types with a cast 

Assignments of references, other than those listed above (p. 321) , require the use of a cast operator to 
purposely change the type of the reference. 

Doesn’t work in all cases 

However, it is not possible to perform a successful cast to convert the type of a reference in all cases. 

Generally, a cast can only be performed among reference types that fall on the same ancestral line of 
the class hierarchy, or on an ancestral line of an interface hierarchy. For example, a reference cannot be 
successfully cast to the type of a sibling or a cousin in the class hierarchy. 

Downcasting 

When we cast a reference along the class hierarchy in a direction from the root class Object toward 
the leaves, we often refer to it as a downcast 

While it is also possible to cast in the direction from the leaves to the root, this happens automatically, 
and the use of a cast operator is not required. 

A sample program 

The program named Poly02 , shown in Listing 11 (p. 328) near the end of the module, illustrates the 
use of the cast operator with references. 

When you examine that program, you will see that two classes named A and C each extend the class 
named Object . Hence, we might say that they are siblings in the class hierarchy. 

Another class named B extends the class named A . Thus, we might say that A is a child of 
Object ,and B isa child of A 

The class named A 

The definition of the class named A is shown in Listing 1 (p. 322) . This class extends the class named 
Object 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


320 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


(Recall that it is not necessary to explicitly state that a class extends the class named Object . Any 
class that does not explicitly extend some other class will automatically extend Object by default. The 
class named A is shown to extend Object here simply for clarity of presentation.) 


Listing 1 . Definition of the class named A. 


class A extends Object{ 
//this class is empty 
}//end class A 


Table 3.33 


The class named A is empty. It was included in this example for the sole purpose of adding a layer of 
inheritance to the class hierarchy. 

The class named B 

Listing 2 (p. 322) shows the definition of the class named B . This class extends the class named A . 


Listing 2 . Definition of the class named B. 


class B extends A{ 
public void m(){ 
System.out.println("m in class B"); 
}//end method m() 
}//end class B 


Table 3.34 


The method named m() 

The class named B defines a method named m() . The behavior of the method is simply to display 
a message each time it is called. 

The class named C 

Listing 3 (p. 322) contains the definition of the class named C , which also extends Object 


Listing 3 . Definition of the class named C. 


class C extends Object{ 
//this class is empty 
}//end class C 


Table 3.35 


The class named C is also empty. It was included in this example as a sibling class for the class named 
A . Stated differently, it was included as a class that is not in the ancestral line of the class named B 

The driver class 

Listing 4 (p. 323) shows the beginning of the driver class named Poly02 
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Listing 4 . Beginning of the class named Poly02. 


public class Poly02{ 
public static void main(String[] args){ 
Object var = new B(); 


Table 3.36 


An object of the class named B 

The code in Listing 4 (p. 323) instantiates an object of the class B and assigns the object’s reference 
to a reference variable of type Object 

(It is important to note that the reference to the object of type B was not assigned to a reference 
variable of type B _. Instead, it was assigned to a reference variable of type Object .) 

This assignment is allowable because Object is a superclass of B . In other words, the reference to 
the object of the class B is assignment compatible with a reference variable of the type Object 

Automatic type conversion 

In this case, the reference of type B is automatically converted to type Object and assigned to 
the reference variable of type Object . (Note that the use of a cast operator was not required in this 
assignment.) 

Only part of the story 

However, assignment compatibility is only part of the story. The simple fact that a reference is assignment 
compatible with a reference variable of a given type says nothing about what can be done with the reference 
after it is assigned to the reference variable. 

An illegal operation 

For example, in this case, the reference variable that was automatically converted to type Object cannot 
be used directly to call the method named m() on the object of type B . This is indicated in Listing 5 
(p. 323) . 


Listing 5 . An illegal operation. 


//var.mQ); 


Table 3.37 


An attempt to call the method named m() on the reference variable of type Object in Listing 5 (p. 
323) resulted in a compiler error. It was necessary to convert the statement into a comment in order to get 
the program to compile successfully. 

An important rule 

In order to use a reference of a class type to call a method, the method must be defined at or above that, 
class in the class hierarchy. 

This case violates the rule 

In this case, the method named m() is defined in the class named B , which is two levels down from 
the class named Object 

When the reference to the object of the class B was assigned to the reference variable of type Object 
, the type of the reference was automatically converted to type Object 

Therefore, because the reference is of type Object , it cannot be used directly to call the method 
named m() . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


322 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


The solution is a downcast 
In this case, the solution to the problem is a downcast. The code in Listing 6 (p. 324) shows an attempt 
to solve the problem by casting the reference down the hierarchy to type A . 


Listing 6 . An ineffective downcast. 


//((A)var) .mQ; 


Table 3.38 


Still doesn’t solve the problem 

However, this still doesn’t solve the problem, and the result is another compiler error. Again, it was 
necessary to convert the statement into a comment in order to get the program to compile. 

What is the problem here? 

The problem is that the downcast simply didn’t go far enough down the inheritance hierarchy. 

The class named A neither defines nor inherits the method named m() . The method named m() 
is defined in class B , which is a subclass of class A . 

Therefore, a reference of type A is no more useful than a reference of type Object insofar as calling 
the method named m() is concerned. 

The real solution 

The solution to the problem is shown in Listing 7 (p. 324) . 


Listing 7 . A downcast to type B. 


((B)var) .m() ; 


Table 3.39 


The code in Listing 7 (p. 324) casts (converts) the reference value contained in the Object variable 
named var down to type B . 

The method named m() is defined in the class named B . Therefore, a reference of type B can be 
used to call the method. 

The code in Listing 7 (p. 324) compiles and executes successfully. This causes the method named m() 
to execute, producing the following output on the computer screen. 


m in class B 


A few odds and ends 
Before leaving this topic, let’s look at a couple more issues. The code in Listing 8 (p. 325) declares and 
populates a new variable of type B 
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Listing 8 . Declare a variable of type B. 


B vi = (B)var; 


Table 3.40 
The code in Listing 8 also uses a cast to: 


e Convert the contents of the Object variable to type B 
e Assign the converted reference to the new reference variable of type B. 


A legal operation 

This is a legal operation. In this class hierarchy, the reference to the object of the class B can be 
assigned to a reference variable of the types B , A ,or Object 

Cannot be assigned to type C 

However, the reference to the object of the class B cannot be assigned to a reference variable of any 
other type, including the type C . An attempt to do so is shown in Listing 9 (p. 325) . 


Listing 9 . Cannot be assigned to type C. 


//C v2 = (C)var; 


Table 3.41 


The code in Listing 9 (p. 325) attempts to cast the reference to type C and assign it to a reference 
variable of type C 

A runtime error 

Although the program will compile, it won’t execute. An attempt to execute the statement in Listing 
9 (p. 325) results in a ClassCastException at runtime. As a result, it was necessary to convert the 
statement into a comment in order to execute the program. 

Another failed attempt 

Similarly, an attempt to cast the reference to type B and assign it to a reference variable of type C , 
as shown in Listing 10 (p. 325) , won’t compile. 


Listing 10 . Another failed attempt. 


//C v3 = (B)var; 


Table 3.42 
The problem here is that the class C is not a superclass of the class named B . Therefore, a reference 


of type B is not assignment compatible with a reference variable of type C 
Again, it was necessary to convert the statement into a comment in order to compile the program. 
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3.2.11.5 Summary 


This module discusses type conversion for both primitive and reference types. 

A value of a particular type may be assignment compatible with variables of other types. 

If the type of a value is not assignment compatible with a variable of a given type, it may be possible to 
perform a cast on the value to change its type and assign it to the variable as the new type. For primitive 
types, this will often result in the loss of information. 

Except for type boolean , values of primitive types can be assigned to any variable whose type represents 
a range that is as wide or wider than the range of the value’s type. (Values of type boolean can only 
be assigned to variables of type boolean.) 

With respect to reference types, the reference to an object instantiated from a given class can be assigned 
to any of the following without the use of a cast: 


Any reference variable whose type is the same as the class from which the object was instantiated. 
Any reference variable whose type is a superclass of the class from which the object was instantiated. 
Any reference variable whose type is an interface that is implemented by the class from which the 
object was instantiated. 

e Any reference variable whose type is an interface that is implemented by a superclass of the class from 
which the object was instantiated. 

e A few other cases involving the class and interface hierarchy. 


Assignments of references, other than those listed above, require the use of a cast to change the type of the 
reference. 

It is not always possible to perform a successful cast to convert the type of a reference. Whether or not a 
cast can be successfully performed depends on the relationship of the classes involved in the class hierarchy. 

A reference to any object can be assigned to a reference variable of the type Object , because the 
Object class is a superclass of every other class. 

When we cast a reference along the class hierarchy in a direction from the root class Object toward 
the leaves, we often refer to it as a downcast. 

Whether or not a method can be called on a reference to an object depends on the current type of the 
reference and the location in the class hierarchy where the method is defined. In order to use a reference of 
a class type to call a method, the method must be defined at or above that class in the class hierarchy. 

A sample program is provided that illustrates much of the detail involved in type conversion, method 
invocation, and casting with respect to reference types. 


3.2.11.6 What’s next? 


I will begin the discussion of runtime polymorphism through method overriding and inheritance in the next 
module. 

I will demonstrate that for runtime polymorphism, the selection of a method for execution is based on the 
actual type of object whose reference is stored in a reference variable, and not on the type of the reference 
variable on which the method is called. 


3.2.11.7 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java OOP: Polymorphism, Type Conversion, Casting, etc. 
e File: Javal610.htm 

e Published: 02/26/02 

e Revised: 12/06/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have misappropriated copies of my modules from cnx.org, con- 
verted them to Kindle books, and placed them for sale on Amazon.com showing me as the author. 
I receive no compensation for those sales and don’t know who does receive compensation. If you 
purchase such a book, please be aware that it is a bootleg copy of a module that is freely available 
on cnx.org. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.11.8 Complete program listings 
A complete listing of the program is shown in Listing 11 (p. 328) below. 
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Listing 11 . Complete program listing. 


/*File Poly02.java 
Copyright 2002, R.G.Baldwin 


This program illustrates downcasting 
Program output is: 


m in class B 
TC Te CTT TeCLeCrTTCrrrrecrrererrere Lr. ere? toe 


class A extends Object{ 
//this class is empty 
}//end class A 


class B extends Af 
public void m(){ 
System.out.println("m in class B"); 
}//end method m() 
}//end class B 


class C extends Object{ 
//this class is empty 
}//end class C 


public class Poly02{ 
public static void main(String[] args){ 

Object var = new B(); 
//Following will not compile 
//var.m(); 
//Following will not compile 
//((A) var) .mQ ; 
//Following will compile and run 


((B)var) .m(); 


//Following will compile and run 
B vi = (B)var; 
//Following will not execute 
//C v2 = (C)var; 
//Following will not compile 
//C v3 = (B)var; 
}//end main 
}//end class Poly02 


Table 3.43 
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-end- 


3.2.12 Java1610s Slides” 
3.2.12.1 Table of Contents 


e Instructions for viewing slides (p. 329) 
e Miscellaneous (p. 329) 


3.2.12.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java1610: Polymorphism, Type Conversion, 
Casting, etc. +! 

Click here 4? to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.2.12.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Javal610s Slides: Polymorphism, Type Conversion, Casting, etc. 
e File: Javal610s.htm 
e Published: 01/16/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


40This content is available online at <http://cnx.org/content /m48917/1.3/>. 
“lhttp://cnx.org/content /m44168 /latest /?collection=col11441/latest 
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3.2.13 Javal612: Runtime Polymorphism through Inheritance” 
3.2.13.1 Table of Contents 


e Preface (p. 330) 

Viewing tip (p. 330) 

x Listings (p. 330) 

Preview (p. 330) 
Discussion and sample code (p. 331) 
Summary (p. 336) 
What’s next? (p. 336) 
Miscellaneous (p. 336) 
Complete program listing (p. 337) 


3.2.13.2 Preface 


This module is one of a series of modules designed to teach you about the essence of Object-Oriented 
Programming (OOP) using Java. 


3.2.13.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


3.2.13.2.1.1 Listings 


. Definition of the class named A. 


e Listing 1 (p. 332) 

e Listing 2 (p. 332) . Definition of the class named B. 

e Listing 3 (p. 333) . Beginning of the driver class named Poly03. 
e Listing 4 (p. 334) . Polymorphic behavior. 

e Listing 5 (p. 334) . Source of a compiler error. 

e Listing 6 (p. 335) . A new object of type A. 

e Listing 7 (p. 338) . Complete program listing. 


3.2.13.3 Preview 


What is polymorphism? 

The meaning of the word polymorphism is something like one name, many forms . 

How does Java implement polymorphism? 

Polymorphism manifests itself in Java in the form of multiple methods having the same name. 

In some cases, multiple methods have the same name, but different formal argument lists (overloaded 
methods, which were discussed in a previous module) . 

In other cases, multiple methods have the same name, same return type, and same formal argument list 
(overridden methods) . 

Three distinct forms of polymorphism 

From a practical programming viewpoint, polymorphism manifests itself in three distinct forms in Java: 


e Method overloading 
e Method overriding through class inheritance 
e Method overriding through the Java interface 


43This content is available online at <http://cnx.org/content /m44177/1.4/>. 
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I covered method overloading as one form of polymorphism (compile-time polymorphism) in a previous 
module. I also explained automatic type conversion and the use of the cast operator for type conversion in 
a previous module. 

In this module ... 

I will begin the discussion of runtime polymorphism through method overriding and class inheritance in 
this module. I will cover interfaces in a future module. 

The essence of runtime polymorphic behavior 

With runtime polymorphism based on method overriding, 


e the decision as to which version of a method will be executed is based on 
e the actual type of the object whose reference is stored in the reference variable, and 
e not onthe type of the reference variable on which the method is called. 


Late binding 
The decision as to which version of the method to call cannot be made at compile time. That decision 
must be deferred and made at runtime. This is sometimes referred to as late binding . 


3.2.13.4 Discussion and sample code 


Operational description of runtime polymorphism 
Here is an operational description of runtime polymorphism as implemented in Java through class inher- 
itance and method overriding: 


Assume that a class named SuperClass defines a method named method 
Assume that a class named SubClass extends SuperClass and overrides the method named 
method 

e Assume that a reference to an object of the class named SubClass is assigned to a reference variable 
named ref of type SuperClass 

e Assume that the method named method is then called on the reference variable using the following 


syntax: 
ref.method() 
° Result: The version of the method named method that will actually be executed is the 


overridden version in the class named SubClass , and is not the version that is defined in the class 
named SuperClass, even though the reference to the object of type SubClass is stored in a 
variable of type SuperClass 


This is runtime polymorphism in a nutshell, which is sometimes also referred to as late-binding. 

Runtime polymorphism is very powerful 

As you gain more experience with Java, you will learn that much of the power of OOP using Java is 
centered on runtime polymorphism using class inheritance, interfaces, and method overriding. (The use of 
interfaces for polymorphism will be discussed in a future module.) 

An important attribute of runtime polymorphism 

The decision as to which version of the method to execute 


e is based on the actual type of object whose reference is stored in the reference variable, and 
e not on the type of the reference variable on which the method is called. 


Why is it called runtime polymorphism? 

The reason that this type of polymorphism is often referred to as runtime polymorphism is because the 
decision as to which version of the method to execute cannot be made until runtime. The decision cannot 
be made at compile time. 

Why defer the decision? 
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The decision cannot be made at compile time because the compiler has no way of knowing (when the 
program is compiled) the actual type of the object whose reference will be stored in the reference variable . 

In an extreme case, for example, the object might be de-serialized at runtime from a network connection 
of which the compiler has no knowledge. 

Could be either type 

For the situation described above, that de-serialized object could just as easily be of type SuperClass 
as of type SubClass . In either case, it would be valid to assign the object’s reference to the same 
superclass reference variable. 

If the object were of the SuperClass type, then a call to the method named method on the reference 
would cause the version of the method defined in SuperClass , and not the version defined in SubClass 
, to be executed. (The version executed is determined by the type of the object and not by the type of the 
reference variable containing the reference to the object.) 

Sample Program 

Let’s take a look at a sample program that illustrates runtime polymorphism using class inheritance and 
overridden methods. The name of the program is Poly03 . A complete listing of the program is shown in 
Listing 7 (p. 338) near the end of the module. 

Listing 1 (p. 332) shows the definition of a class named A , which extends the class named Object 

(Remember that any class that doesn’t extend some other class automatically extends Object by 
default, and it is not necessary to show that explicitly as I did in this example.) 


Listing 1 . Definition of the class named A. 


class A extends Object{ 
public void m(){ 
System.out.println("m in class A"); 
}//end method m() 
}//end class A 


Table 3.44 


The class named A defines a method named m() . 

Behavior of the method 

The behavior of the method, as defined in the class named A ,is to display a message indicating that 
it has been called, and that it is defined in the class named A 

This message will allow us to determine which version of the method is executed in each case discussed 
later. 

The class named B 

Listing 2 (p. 332) shows the definition of a class named B that extends the class named A 


Listing 2 . Definition of the class named B. 


class B extends A{ 
public void m(){ 
System.out.println("m in class B"); 
}//end method m() 
}//end class B 
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Table 3.45 


The class named B overrides (redefines) the method named m() , which it inherits from the class 
named A 

Behavior of the overridden version of the method 

Like the inherited version, the overridden version displays a message indicating that it has been called. 
However, the message is different from the message displayed by the inherited version discussed above. The 
overridden version tells us that it is defined in the class named B . (The behavior of the overridden version 
of the method is appropriate for an object instantiated from the class named B .) 

Again, this message will allow us to determine which version of the method is executed in each case 
discussed later. 

The driver class 

Listing 3 (p. 333) shows the beginning of the driver class named Poly03 


Listing 3 . Beginning of the driver class named Poly03. 


public class Poly03{ 
public static void main(String[] args){ 
Object var = new B(); 


((B)var) .m(); 


Table 3.46 


A new object of the class B 

The code in the main method begins by instantiating a new object of the class named B 
assigning the object’s reference to a reference variable of type Object 

(Recall that this is legal because an object’s reference can be assigned to any reference variable whose 

type is a superclass of the class from which the object was instantiated. The class named Object is the 
superclass of all classes.) 

Downcast and call the method 

If you read the earlier module on casting, it will come as no surprise to you that the second statement in 
the main method, which casts the reference down to type B and calls the method named m() on it, 
will compile and execute successfully. 

Which version is executed? 

The execution of the method produces the following output on the computer screen: 


, and 


m in class B 


By examining the output, you can confirm that the version of the method that was overridden in the class 
named B is the version that was executed. 

Why was this version executed? 

This should also come as no surprise to you. The cast converts the type of the reference from type 
Object totype B 

You can always call a public method belonging to an object using a reference to the object whose type 
is the same as the class from which the object was instantiated. 

Not runtime polymorphic behavior 

Just for the record, the above call to the method does not constitute runtime polymorphism (in my 
opinion) . I included that call to the method to serve as a backdrop for what follows. 

Runtime polymorphic behavior 

However, the following call to the method does constitute runtime polymorphism. 
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The statement in Listing 4 (p. 334) casts the reference down to type A and calls the method named 
m() on that reference. 

It may not come as a surprise to you that the call to the method shown in Listing 4 (p. 334) also compiles 
and runs successfully. 


Listing 4 . Polymorphic behavior. 


((A)var) .m(); 


Table 3.47 


The method output 
Here is the punch line. Not only does the statement in Listing 4 (p. 334) compile and run successfully, 
it produces the following output, (which is exactly the same output as before) : 


m in class B 


Same method executed in both cases 
It is important to note that this output, (produced by casting the reference variable to type A instead 
of type B ) , is exactly the same as that produced by the earlier call to the method when the reference 
was cast to type B . This means that the same version of the method was executed in both cases. 
This confirms that, even though the type of the reference was converted to type A , (rather than type 
Object or type B ) , the overridden version of the method defined in class B was actually executed. 
This is an example of runtime polymorphic behavior. 
The version of the method that was executed was based on 


e the actual type of the object, B , and 
e not on the type of the reference, A 


This is an extremely powerful and useful concept. 

Another call to the method 

Now take a look at the statement in Listing 5 (p. 334) . Will this statement compile and execute 
successfully? If so, which version of the method will be executed? 


Listing 5 . Source of a compiler error. 


var.m(); 


Table 3.48 


Compiler error 

The code in Listing 5 (p. 334) attempts, unsuccessfully, to call the method named m() using the 
reference variable named var , which is of type Object . The result is a compiler error, which, depending 
on your version of the JDK, will be similar to the following: 


Poly03.java:40: cannot resolve symbol 
symbol : method m () 
location: class java.lang.Object 
var.m(); 
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Some important rules 

The Object class does not define a method named m() . Therefore, the overridden method named 
m() in the class named B is not an overridden version of a method that is defined in the class named 
Object 

Necessary, but not sufficient 

Runtime polymorphism based on class inheritance requires that the type of the reference variable be a 
superclass of the class from which the object (on which the method will be called) is instantiated. 

However, while necessary, that is not sufficient. 

The type of the reference variable must also be a class that either defines or inherits the method 
that will ultimately be called on the object. 

This method is not defined in the Object class 

Since the class named Object neither defines nor inherits the method named m() , a reference of 
type Object does not qualify as a participant in runtime polymorphic behavior in this case. The attempt 
to use it as a participant resulted in the compiler error given above. 

One additional scenario 

Before leaving this topic, let’s look at one additional scenario to help you distinguish what is, and what 
is not, runtime polymorphism. Consider the code shown in Listing 6 (p. 335) . 


Listing 6 . A new object of type A. 


var = new AQ; 


((A)var) .m(); 


Table 3.49 


A new object of type A 

The code in Listing 6 (p. 335) instantiates a new object of the class named A , and stores the object’s 
reference in the original reference variable named var of type Object 

(As a side note, this overwrites the previous contents of the reference variable with a new reference and 
causes the object whose reference was previously stored there to become eligible for garbage collection.) 

Downcast and call the method 

Then the code in Listing 6 (p. 335) casts the reference down to type A , (the type of the object to 
which the reference refers) , and calls the method named m() on the downcast reference. 

The output 

As you would probably predict, this produces the following output on the computer screen: 


m in class A 


In this case, the version of the method defined in the class named A , (not the version defined in B ) 
was executed. 

Not polymorphic behavior 

In my view, this is not polymorphic behavior (at least it isn’t a very useful form of polymorphic behavior) 
. This code simply converts the type of the reference from type Object to the type of the class from which 
the object was instantiated, and calls one of its methods. Nothing special takes place regarding a selection 
among different versions of the method. 

Some authors may disagree 

While some authors might argue that this is technically runtime polymorphic behavior, in my view at 
least, it does not illustrate the real benefits of runtime polymorphic behavior. The benefits of runtime 
polymorphic behavior generally accrue when the actual type of the object is a subclass of the type of the 
reference variable containing the reference to the object. 
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Once again, what is runtime polymorphism? 
As I have discussed in this module, runtime polymorphic behavior based on class inheritance occurs when 


e The type of the reference is a superclass of the class from which the object was instantiated. 
e The version of the method that is executed is the version that is either defined in, or inherited into, 
the class from which the object was instantiated. 


More than you ever wanted to hear 

And that is probably more than you ever wanted to hear about runtime polymorphism based on class 
inheritance. 

A future module will discuss runtime polymorphism based on the Java interface. From a practical 
viewpoint, you will find the rules to be similar but somewhat different in the case of the Java interface. 

A very important concept 

For example, the entire event-driven graphical user interface structure of Java is based on runtime poly- 
morphism involving the Java interface. 


3.2.13.5 Summary 


Polymorphism manifests itself in Java in the form of multiple methods having the same name. 
From a practical programming viewpoint, polymorphism manifests itself in three distinct forms in Java: 


e Method overloading 
e Method overriding through class inheritance 
e Method overriding through the Java interface 


This module discusses method overriding through class inheritance. 

With runtime polymorphism based on method overriding, the decision as to which version of a method 
will be executed is based on the actual type of object whose reference is stored in the reference variable, and 
not on the type of the reference variable on which the method is called. 

The decision as to which version of the method to call cannot be made at compile time. That decision 
must be deferred and made at runtime. This is sometimes referred to as late binding. 

This is illustrated in the sample program discussed in this module. 


3.2.13.6 What’s next? 


In the next module, I will continue my discussion of the implementation of polymorphism using method 
overriding through class inheritance, and I will concentrate on a special case in that category. 

Specifically, I will discuss the use of the Object class as a completely generic type for storing references 
to objects of subclass types, and explain how that results in a very useful form of runtime polymorphism. 


3.2.13.7 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java OOP: Runtime Polymorphism through Class Inheritance 
e File: Javal612.htm 

e Published: 02/27/02 

e Revised: 12/06/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have misappropriated copies of my modules from cnx.org, con- 
verted them to Kindle books, and placed them for sale on Amazon.com showing me as the author. 
I receive no compensation for those sales and don’t know who does receive compensation. If you 
purchase such a book, please be aware that it is a bootleg copy of a module that is freely available 
on cnx.org. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.13.8 Complete program listing 
A complete listing of the program is shown in Listing 7 (p. 338) below. 
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Listing 7 . Listing 7: Complete program listing. 


m in class B 
m in class B 
m in class A 
TCT ETCTCTTCLeCrTTCrrrrrrrrrerrere ree Tet tof 


/*File Poly03.java 
Copyright 2002, R.G.Baldwin 


This program illustrates downcasting 
and polymorphic behavior 


Program output is: 


class A extends Object{ 
public void m(){ 
System.out.println("m in class A"); 
}//end method m() 
}//end class A 


class B extends Af 
public void m(){ 
System.out.println("m in class B"); 
}//end method m() 
}//end class B 


public class Poly03{ 
public static void main(String[] args){ 


new BQ); 


//Following will compile and run 
((B)var) .m(); 

//Following will also compile 

// and run due to polymorphic 

// behavior. 

(CA) var) .mQ ; 

//Following will not compile 


//Instantiate obj of class A 
new AQ); 
//Call the method on it 
((A)var) .m(); 
}//end main 
}//end class Poly03 


-end- 


Table 3.50 
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3.2.14 Java1612s Slides“ 
3.2.14.1 Table of Contents 


e Instructions for viewing slides (p. 339) 
e Miscellaneous (p. 339) 


3.2.14.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java1612: Runtime Polymorphism through 
Inheritance * . 

Click here ê to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.2.14.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Javal612s Slides: Runtime Polymorphism through Inheritance 
e File: Javal612s.htm 
e Published: 01/17/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


44This content is available online at <http://cnx.org/content /m48928/1.2/>. 
“5h ttp://cnx.org/content /m44177 /latest /?collection=col11441 /latest 
46http://cnx.org/content /m48928 /latest /a0-Index.htm 
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3.2.15 Javal614: Polymorphism and the Object Class“ 
3.2.15.1 Table of Contents 


e Preface (p. 340) 

Viewing tip (p. 340) 

x Listings (p. 340) 

Preview (p. 340) 
Discussion and sample code (p. 341) 
Summary (p. 346) 
What’s next? (p. 346) 
Miscellaneous (p. 346) 
Complete program listing (p. 347) 


3.2.15.2 Preface 
This module is one of a series of modules designed to teach you about the essence of Object-Oriented 


Programming (OOP) using Java. 


3.2.15.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


3.2.15.2.1.1 Listings 


. Definition of the class named A. 


e Listing 1 (p. 342) 

e Listing 2 (p. 342) . Definition of the class named B. 

e Listing 3 (p. 343) . Definition of the class named C. 

e Listing 4 (p. 344) . Beginning of the class named Poly04. 
e Listing 5 (p. 345) . A new object of the class named B. 
e Listing 6 (p. 345) . A new object of the class named C. 
e Listing 7 (p. 348) . Complete program listing. 


3.2.15.3 Preview 


What is polymorphism? 

If you have studied the earlier modules in this collection, you should already know what polymorphism 
is, how it is implemented in Java, the three distinct forms of polymorphism in Java, etc. 

I discussed runtime polymorphism implemented through method overriding and class inheritance in a 
previous module. However, before leaving that topic, I need to discuss an important special case. 

In this module, I will discuss the use of the Object class as a completely generic type for storing 
references to objects of subclass types, and will explain how that results in a very useful form of runtime 
polymorphism. 

I will briefly discuss the default versions of eleven methods defined in the Object class, and will explain 
that in many cases, those default versions are meant to be overridden. 


47This content is available online at <http://cnx.org/content /m44190/1.4/>. 
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3.2.15.4 Discussion and sample code 


The Java Collections Framework 

Java supports a framework, known as the Java Collections Framework, which you can read about in other 
tutorials on my web site at http://www.dickbaldwin.com/toc.htm ^8 . 

Without getting into a lot of detail, the framework provides several concrete implementations of interfaces 
with names like list , set , and map 

The classes that provide the implementations have names like LinkedList , TreeSet , ArrayList 
, Vector ,and Hashtable . As you might recognize, the framework satisfies the requirements for what 
we might refer to as classical data structures. 

Not the purpose ... 

However, it is not the purpose of this module to discuss either the Java Collections Framework, or classical 
data structures. Rather, they are mentioned here simply because the framework provides a good example of 
the use of the Object class as a generic type for runtime polymorphic behavior. 

(Also beyond the scope of this module is the fact that the framework provides an outstanding example 
of the implementation of polymorphic behavior through the use of the Java interface. The use of the Java 
interface is a topic for a future module) 

References of type Object 

The classes mentioned above store references to objects created according to interfaces, contracts, and 
stipulations provided by the framework. More importantly for the purposes of this module, those references 
are stored as type Object 

(See my tutorial titled Generics in J2SE 5.0 at http://www.developer.com /java/other /article.php/3495121/Generics- 
in-J2SE-50.htm +*° for additional information on this topic.) 

The Object type is a completely generic type, which can be used to store a reference to any object 
that can be instantiated in Java. 

Methods defined in the Object class 

In an earlier module, I told you that the class named Object defines default versions of the following 
methods: 


clone() 
equals(Object obj) 
finalize() 
getClass() 
hashCode() 
notify() 

notify All() 
toString() 

wait() 

wait (long timeout) 
wait (long timeout, int nanos) 


Every class inherits these methods 

Because every class is either a direct or indirect subclass of Object , every class in Java, (including 
new classes that you define) , inherits these eleven methods. 

To be overridden ... 

Some of these eleven methods are intended to be overridden for various purposes. 

Calling methods of the Object class 

You can store a reference to any object in a reference variable of type Object 

If you have studied the previous modules in this collection, you also know how runtime polymorphism 
based on class inheritance works. 


48http://www.dickbaldwin.com/toc.htm 
49http://www.developer.com/java/other/article.php/3495121/Generics-in-J2SE-50.htm 
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Given the above, you should know that you can call any of the methods defined in the Object class on 
any reference to any object stored in a reference variable of type Object (including the references stored 
in the concrete implementations of the Java Collections Framework) . 

And the behavior will be ... 

If the class from which that object is instantiated inherits or defines an overridden version of one of 
the methods in the above list, calling that method on the reference will cause the overridden version to be 
executed. 

Otherwise, calling that method on the reference will cause the default version defined in the Object 
class to be executed. 

A sample program 

This is illustrated in the program named Poly04 , which you can view in its entirety in Listing 7 (p. 
348) near the end of this module. 

For purposes of illustration, this program deals specifically with the method named toString from the 
above list, but it could deal just as well with other non-final methods in the list. 

The class named A 

Listing 1 (p. 342) defines a class named A , which extends the class named Object (recall that it is 

not necessary to explicitly show that a class extends Object ). 


Listing 1 . Definition of the class named A. 


class A extends Object{ 
//This class is empty 
}//end class A 


Table 3.51 


Does not override the toString method 

The most important thing to note about the class named A is that it does not override any of the 
methods that it inherits from the class named Object 

For purposes of this illustration, we will say that it inherits the default version of the method named 
toString , from the class named Object . (We will see an example of the behavior of the default version 
of the toString method shortly.) 

The class named B 

Listing 2 (p. 342) contains the definition of a class named B . This class extends the class named A . 


Listing 2 . Definition of the class named B. 


class B extends A{ 
public String toString(){ 
return "toString in class B"; 
}//end overridden toString () 
}//end class B 


Table 3.52 
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Overrides the toString method 
Of particular interest, for purposes of this module, is the fact that the class named B does override the 
inherited t oString method. 

(The class named B inherits the default version of the method, because its superclass named A , 
which extends Object , does not override the toString method.) 

Purpose of the toString method 

The purpose of the toString method is to return a reference to an object of the class String that 
represents an object instantiated from a class that overrides the method. 
Here is part of what Sun has to say about the toString method: 

"Returns a string representation of the object. In general, the toString method returns a string that 
"textually represents" this object. The result should be a concise but informative representation that is easy 
for a person to read. It is recommended that all subclasses override this method." 

Behavior of the overridden version 

As you can see, I didn’t follow Sun’s advice very closely in this program. To begin with, I didn’t override 
the toString method in the class named A 

Further, the behavior of my overridden version of the toString method in the class named B doesn’t 
provide much in the way of a textual representation of an object instantiated from class B 

My overridden version simply returns a reference to a String object, containing text that indicates 
that the overridden version of the method defined in the class named B has been executed. (Of course, 
there wasn’t much about an object instantiated from the class named B that could be represented in a 
textual way.) 

Will be useful later 

The reference to the String object returned by the overridden version of the toString method will 
prove useful later when we need to determine which version of the method is actually executed. 

The class named C 

Listing 3 (p. 343) shows the definition of a class named C , which extends the class named B , and 
overrides the method named toString again. (A non-final method can be overridden by every class that 
inherits it, resulting in potentially many different overridden versions of a method in a class hierarchy.) 


Listing 3 . Definition of the class named C. 


class C extends B{ 
public String toString(){ 
return "toString in class C"; 
}//end overridden toString () 
}//end class B 


Table 3.53 


Behavior of overridden version 

The behavior of this overridden version of the method is similar to, but different from the overridden 
version in the class B 

In this case, the method returns a reference to a String object that can be used to confirm that this 
overridden version of the method has been executed. 

The driver class 

Finally, Listing 4 (p. 344) shows the beginning of the driver class named Poly04 
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Listing 4 . Beginning of the class named Poly04. 


public class Poly04{ 
public static void main(String[] args){ 
Object varA = new A(); 
String vi = varA.toString(); 
System. out.println(v1); 


Table 3.54 


A new object of the class A 

The main method of the driver class begins by instantiating a new object of the class A , and saving 
the object’s reference in a reference variable of type Object , named varA 

Call toString method on the reference 

Then the code in Listing 4 (p. 344) calls the toString method on the reference variable named varA 
, Saving the returned reference to the String in a reference variable of type String named vl 

Display the returned String 

Finally, that reference is passed to the printIn method, causing the String returned by the toString 
method to be displayed on the computer screen. 

(In a future module, you will learn that some of the code in Listing 4 (p. 344) is redundant.) 

This causes the following text to be displayed on the computer screen: 


A@111f£71 


Pretty ugly, huh? 

Nowhere does our program explicitly show the creation of any text that looks anything like this. Where 
did it come from? 

Default toString behavior 

What you are seeing here is the String produced by the default version of the toString method, as 
defined by the class named Object 

Class A does not override toString 

Recall that our new class named A does not override the toString method. Therefore, when the 
toString method is called on a reference to an object of the class A , the default version of the method 
is executed, producing output similar to that shown above (p. 344) . 

What does Sun have to say? 
Here is more of what Sun has to say about the default version of the toString method 
"The toString method for class Object returns a string consisting of the name of the class of which 
the object is an instance, the at-sign character ‘@’, and the unsigned hexadecimal representation of the hash 
code of the object." 

You should recognize this as a description of the output produced by calling the toString method on 
the reference to the object of the class A . That explains the ugliness of the screen output shown above 
(p. 344) (hexadecimal representations of hashcodes are usually pretty ugly) . 

A new object of the class B 

Now consider the code shown in Listing 5 (p. 345) , which instantiates a new object of the class named 

B „and stores the object’s reference in a reference variable of type Object 
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Listing 5 . A new object of the class named B. 


Object varB = new B(); 
String v2 = varB.toString(); 
System. out.println(v2) ; 


Table 3.55 


Call toString and display the result 
The code in Listing 5 (p. 345) calls the toString method on the reference of type Object , saving the 
returned reference in the reference variable named v2 . (Recall that the toString method is overridden 
in the class named B.) 
As before, the reference is passed to the println method, which causes the following text to be displayed 
on the computer screen. 


toString in class B 


Do you recognize this? 

You should recognize this as the text that was encapsulated in the String object by the overridden 

version of the toString method defined in the class named B 
Overridden version of toString was executed 

This verifies that even though the reference to the object of the class B was stored in a reference variable 
of type Object , the overridden version of the toString method defined in the class named B was 
executed (instead of the default version defined in the class named Object ) . This is a good example of 
runtime polymorphic behavior , as described in a previous module. 

As you learned in the previous module, the selection of a method for execution is based on the actual 
type of object whose reference is stored in a reference variable, and not on the type of the reference 
variable on which the method is called. 

An object of the class C 
Finally, the code in Listing 6 (p. 345) 


Instantiates a new object of the class C 

Stores the object’s reference in a reference variable of type Object 
Calls the toString method on the reference. 

Displays the returned string on the computer screen. 


Listing 6 . A new object of the class named C. 


Object varC = new C(); 
String v3 = varC.toString(); 
System. out.println(v3) ; 


Table 3.56 


What will the output look like? 
By now, you should know what to expect in the way of text appearing on the computer screen. The code 
in Listing 6 (p. 345) causes the following text to be displayed: 
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toString in class C 


Overridden version of toString was called 

This confirms what you should already have known by now. In particular, even though the reference to 
the object of the class C is stored in a reference variable of type Object , the overridden version of 
the toString method defined in the class named C was executed. Again, this is runtime polymorphic 
behavior based on class inheritance and method overriding. 

No downcasting was required 

It is also very important to note that no downcasting was required in order to call the toString method 
in any of the cases shown above. 

Because a default version of the toString method is defined in the Object class, the toString 
method can be called without a requirement for downcasting on a reference to any object stored in a variable 
of type Object . This holds true for any of the eleven methods defined in the class named Object 
(although some of those methods are declared final and therefore may not be overridden) . 


3.2.15.5 Summary 


Polymorphism manifests itself in Java in the form of multiple methods having the same name. 
From a practical programming viewpoint, polymorphism manifests itself in three distinct forms in Java: 


e Method overloading 
e Method overriding through class inheritance 
e Method overriding through the Java interface 


In this module, I have continued my discussion of the implementation of polymorphism using method over- 
riding through class inheritance, and have concentrated on a special case in that category. 

More specifically, in this module, I have discussed the use of the Object class as a completely generic 
type for storing references to objects of subclass types, and have explained how that results in a very useful 
form of runtime polymorphism. . 

I briefly mentioned the default version of the eleven methods defined in the Object class, and explained 
that in some cases, those default versions are meant to be overridden. 

I provided a sample program that illustrates the overriding of the toString method, which is one of 
the eleven methods defined in the Object class. 


3.2.15.6 What’s next? 


In the next module, I will embark on an explanation of runtime polymorphic behavior based on the Java 
interface and method overriding. 

In my opinion, this is one of the most important concepts in Java OOP, and the one that seems to give 
students the greatest amount of difficulty. 


3.2.15.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Polymorphism and the Object Class 
e File: Javal614.htm 

e Published: 03/13/02 

e Revised: 12/06/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have misappropriated copies of my modules from cnx.org, con- 
verted them to Kindle books, and placed them for sale on Amazon.com showing me as the author. 
I receive no compensation for those sales and don’t know who does receive compensation. If you 
purchase such a book, please be aware that it is a bootleg copy of a module that is freely available 
on cnx.org. 


Affiliation :: I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.15.8 Complete program listing 
A complete listing of the program is shown in Listing 7 (p. 348) below. 
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Listing 7 . Complete program listing. 


/*File Poly04. java 
Copyright 2002, R.G.Baldwin 


This program illustrates polymorphic 
behavior 


Program output is: 


A@111f71 

toString in class B 

toString in class C 

FE A IO I IGA I I ICI AI I E EEEE EEEE EEEN 


class A extends Objectf{ 
//This class is empty 
}//end class A 


class B extends Af 
public String toString(){ 
return "toString in class B"; 
}//end overridden toString () 
}//end class B 


class C extends Bf 
public String toString(){ 
return "toString in class C"; 
}//end overridden toString () 
}//end class B 


public class Poly04{ 
public static void main(String[] args){ 
Object varA = new A(); 
String vi = varA.toString(); 
System.out.println(v1); 


Object varB = new B(); 
String v2 = varB.toString(); 
System. out.println(v2) ; 


Object varC = new C(); 
String v3 = varC.toString(); 
System. out.println(v3) ; 


}//end main 
}//end class Poly04 
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Table 3.57 


-end- 


3.2.16 Javal614s Slides” 
3.2.16.1 Table of Contents 


e Instructions for viewing slides (p. 349) 
e Miscellaneous (p. 349) 


3.2.16.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Javal1614: Polymorphism and the Object 
Class *! . 

Click here 5? to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.2.16.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Javal614s Slides: Polymorphism and the Object Class 
e File: Javal614s.htm 
e Published: 01/17/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


50This content is available online at <http://cnx.org/content /m48923/1.2/>. 
*lhttp://cnx.org/content /m44190/latest /?collection=coll 1441 /latest 
52http://cnx.org/content /m48923 /latest /a0-Index.htm 
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3.2.17 Javal616: Polymorphism and Interfaces, Part 1” 
3.2.17.1 Table of Contents 


e Preface (p. 350) 

Viewing tip (p. 350) 

x Listings (p. 350) 

Preview (p. 350) 
Discussion and sample code (p. 351) 
Summary (p. 358) 
What’s next? (p. 358) 
Miscellaneous (p. 358) 
Complete program listings (p. 359) 


3.2.17.2 Preface 
This module is one of a series of modules designed to teach you about the essence of Object-Oriented 


Programming (OOP) using Java. 


3.2.17.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


3.2.17.2.1.1 Listings 


e Listing 1 (p. 352) . Definition of interfaces named I1 and I2. 
e Listing 2 (p. 353) . Definition of the class named A. 

e Listing 3 (p. 353) . Definition of the class named B. 

e Listing 4 (p. 355) . Definition of the class named C. 

e Listing 5 (p. 355) . The driver class named Poly05. 

e Listing 6 (p. 360) . Complete program listing. 


3.2.17.3 Preview 


Method overloading 

I covered method overloading as one form of polymorphism (compile-time polymorphism) in a previous 
module. I also explained automatic type conversion and the use of the cast operator for type conversion in 
a previous module. 

Method overriding and class inheritance 

I also discussed runtime polymorphism implemented through method overriding and class inheritance in 
previous modules. 

Using the Java interface 

In this module and the next, I will explain runtime polymorphism as implemented using method overriding 
and the Java interface. 

A very important concept 

In my opinion, this is one of the most important concepts in Java OOP, and the one that seems to give 
students the greatest amount of difficulty. Therefore, I will try to take it slow and easy. As usual, I will 
illustrate the concept using sample programs. 


53This content is available online at <http://cnx.org/content /m44195/1.4/>. 
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I will also tie this concept back to the concept of polymorphism using method overriding through inher- 
itance. 

A skeleton program 

In this module, I will present a simple skeleton program that illustrates many of the important aspects 
of polymorphic behavior based on the Java interface. 

Multiple inheritance and the cardinal rule 

I will explain how the implementation of interfaces in Java is similar to multiple inheritance. I will explain 
the cardinal rule of interface implementation. 

A new relationship 

I will explain that objects instantiated from classes that implement the same interface have a new rela- 
tionship that goes beyond the relationship imposed by the standard class hierarchy. 

One object, many types 

I will explain that due to the combination of the class hierarchy and the fact that a class can implement 
many different interfaces, a single object in Java can be treated as many different types. However, for any 
given type, there are restrictions on the methods that can be called on the object. 

Many classes, one type 

I will explain that because different classes can implement the same interface, objects instantiated from 
different classes can be treated as a common interface type. 

Interfaces are critical to Java programming 

I will suggest that there is little if anything useful that can be done in Java without understanding and 
using interfaces. 

In support of this suggestion, I will discuss several real-world examples of the use of the Java inter- 
face, including the Delegation Event Model, the Model View Control paradigm, and iterators in Java data 
structures. 


3.2.17.4 Discussion and sample code 


Listing 6 (p. 360) near the end of the module contains a very simple program named Poly05 

The purpose of this program is to illustrate polymorphic behavior using interfaces in addition to class 
inheritance. 

Designed to illustrate structure 

This is a skeleton program designed solely to illustrate the inheritance and interface implementation 
structure in as simple a program as possible. (I will put some meat on this skeleton using another program 
in the next module.) 

Empty methods 

Except for the two methods that return type String _, all of the methods in the program are empty. 
(Methods that return type String cannot be empty. They must contain a return statement in order to 
compile successfully. ) 

Interface definitions 

Listing 1 (p. 352) shows the definition of two simple interfaces named I1 and I2 
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Listing 1 . Definition of interfaces named I1 and I2. 


interface Iif 
public void pQ); 
}//end interface I1 


interface I2 extends Iif 
public void q(Q); 
}//end interface I2 


Table 3.58 


Similar but different 

An interface definition is similar to a class definition. However, there are some very important differences. 

No single hierarchy 

To begin with, unlike the case with classes, there is no single interface hierarchy. Also, multiple inheritance 
is allowed when extending interfaces. 

A new interface can extend none, one, or more existing interfaces. In Listing 1 (p. 352) , I2 extends 
I1 , but I1 doesn’t extend any other interface (and unlike classes, an interface doesn’t automatically 
extend another interface by default) . 

Two kinds of members allowed 

Only two kinds of members are allowed in an interface definition: 


e Methods, which are implicitly abstract 
e Variables, which are implicitly constant (final) 


Each of the interfaces in Listing 1 (p. 352) declares an implicitly abstract method (an abstract method does 
not have a body) . 

Neither of the interfaces in Listing 1 (p. 352) declares any variables (they aren’t needed for the purpose 
of this module) . 

A new data type 

I told you earlier that when you define a new class, you cause a new data type to become available to 
your program. The same is true of an interface definition. Each interface definition constitutes a new type. 

The class named A 

Listing 2 (p. 353) defines a very simple class named A , which in turn defines two methods named 
toString and x 
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Listing 2 . Definition of the class named A. 


class A extends Object{ 
public String toString(){ 

return "toString in A"; 
}//end toString() 


public String x(){ 
return "x in A"; 


}//end xQ 


}//end class A 


Table 3.59 


Overridden toString 
The method named toString in Listing 2 (p. 353) is actually an overridden version of the method 


having the same name that is defined in the class named Object . (Recall that a previous module made 
heavy use of overridden versions of the toString method.) 

New method 

The method named x is newly defined in the class named A . (The method named x is not 
inherited into the class named A „ because the class named Object does not define a method named 


x .) 
The class named B 
Listing 3 (p. 353) contains material that is new to this module. 


Listing 3 . Definition of the class named B. 


class B extends A implements I2{ 
public void p(){ 
}//end pQ 


public void q(){ 
}//end qQ; 


}//end class B 


Table 3.60 


Implementing an interface 


Listing 3 (p. 353) defines a class named B , which extends the class named A , and implements 
the interface named I2 


As you already know, a class in Java can extend only one other class. However, a Java class can implement 
any number of interfaces. (Multiple inheritance is allowed with interfaces.) 
Similar to an abstract class 
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An interface is similar, but not identical, to an abstract class. (An abstract class may contain abstract 
methods or concrete methods, or a combination of the two while all of the methods in an interface are 
implicitly abstract.) 

Restrictions 

An abstract class cannot be instantiated. Thus, an abstract class is only useful when it is extended by 
another class. 

An interface also cannot be instantiated. 

Implicitly abstract methods 

As mentioned above, all methods declared in an interface are implicitly abstract, but that is not true 
for an abstract class. An abstract class can also contain fully-defined (concrete) methods. Regardless, an 
abstract class cannot be instantiated. 

A totally abstract class 

At the risk of offending the purists, I will coin a new term here and say that an interface is similar to a 
totally abstract class (one which contains only abstract method declarations and final variables) . 

To a first degree of approximation then, we might say that the class named B is not only a subclass of 
the class named A ,it is also a subclass of the totally abstract class named I2 . (This is pretty far 
out with respect to terminology, so to avoid being embarrassed, you probably shouldn’t repeat it to anyone 
else.) 

Since I2 extends I1 , we might also say that the class named B is a subclass of the totally abstract 
class named I1 

A different kind of thinking 

With this kind of thinking, we have suddenly make it possible for Java classes to support multiple 
inheritance , with the stipulation that all but one of the inherited classes must be totally abstract classes . 

Be very careful with this way of thinking 

However, we need to be very careful with this kind of thinking. While it may help some students to 
understand the role of interfaces in Java, there are probably some hidden dangers lurking here. 

Back to the safety zone 

The safest course of action is to simply say that the class named B 


e Extends the class named A 
e Implements the interface named I2 directly 
e Implements the interface named I1 through inheritance 


Java does not support multiple inheritance, but it does allow you to extend one class and implement any 
number of interfaces. 

The cardinal rule regarding interface implementation 

The cardinal rule in implementing interfaces is: 

If a class implements an interface, it must provide a concrete definition for all the methods declared 
by that interface, and all the methods inherited by that interface. Otherwise, the class must be declared 
abstract and the definitions must be provided by a class that extends the abstract class. 

The cardinal rule regarding class inheritance 

A similar rule exists for defining classes that inherit abstract methods from other classes: 

If a class inherits one or more abstract methods from its superclasses, it must provide concrete definitions 
for all the inherited abstract methods. Otherwise, the class must be declared abstract and the concrete 
definitions must be provided by a class that extends the abstract class. 

What does that mean in this case? 

In this case, this means that the class named B must provide concrete definitions for the methods 
named p and q , because: 


e The class named B implements the interface named I2 


e The method named q_ is declared in the interface named I2 
e The interface named I2 extends the interface named I1 
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e The method named p is declared in the interface named I1 


As in method overriding, the signature of the concrete method in the defining class must match the signature 
of the method as it is declared in the interface. 

Class B satisfies the cardinal rule 

As you can see from Listing 3 (p. 353) , the class named B does provide concrete (but empty) 
definitions of the methods named p and q . 

(As mentioned earlier, I made the methods empty in this program for simplicity. However, it is not 
uncommon to define empty methods in classes that implement interfaces that declare a large number of 
methods, such as the MouseListener interface. See my tutorials on event-driven programming at 
http://www.dickbaldwin.com/toc.htm 54 for examples.) 

The class named C 

Listing 4 (p. 355) defines a class named C , which extends Object , and also implements I2 . As 
in the case of the class named B , this class must, and does, provide concrete (but empty) definitions for 
the methods named p and q . 


Listing 4 . Definition of the class named C. 


class C extends Object implements I2{ 
public void p(){ 
}//end pQ 


public void q(){ 
}//end qQ; 


}//end class B 


Table 3.61 


A driver class 
Finally, the driver class named Poly05 shown in Listing 5 (p. 355) defines an empty main method. 


Listing 5 . The driver class named Poly05. 


public class Poly05{ 
public static void main(String[] args){ 
}//end main 
}//end class Poly05 


Table 3.62 


Doesn’t do anything 
As mentioned earlier, the purpose of this program is solely to illustrate an inheritance and interface 
structure. This program can be compiled and executed, but it doesn’t do anything useful. 


54http://www.dickbaldwin.com/toc.htm 
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A new relationship 

At this point, it might be useful for you to sketch out the structure in a simple hierarchy diagram. 

If you do, you will see that implementation of the interface named I2 by the classes named B and 
C „has created a relationship between those two classes that is totally independent of the normal class 
hierarchical relationship. 

What is the new relationship? 

By declaring that both of these classes implement the same interface named I2 , we are guaranteeing 
that an object of either class will contain concrete definitions of the two methods declared in the interfaces 
named I2 and Il 

Furthermore, we are guaranteeing that objects instantiated from the two classes can be treated as the 
common type I2 

( Important : references to any objects instantiated from classes that implement I2 , can 
be stored in reference variables of the type I2 , and any of the interface methods can be called on those 
references.) 

We know the user interface 

The signatures of the interface methods in the two classes must match the signatures declared in the 
interfaces. 

This means that if we have access to the documentation for the interfaces, we also know the signatures 
of the interface methods for objects instantiated from any class that implements the interfaces. 

Different behavior 

However, and this is extremely important, the behavior of the interface methods as defined in the class 
named B may be (and often will be) entirely different from the behavior of the interface methods having 
the same signatures as defined in the class named C 

Possibly the most powerful concept in Java 

This is possibly the most powerful (and most difficult) concept embodied in the Java programming 
language. 

If you don’t understand interfaces ... 

Į usually tell my students several times each semester that if they don’t understand interfaces, they don’t 
really understand Java. 

It is unlikely that you will ever be successful as a Java programmer without an understanding of interfaces. 

There are very few worthwhile programs that can be written in Java without an understanding of inter- 
faces. 

The core aspect 

So, what is the core aspect of this concept that is so powerful? 

I told you earlier that each interface definition constitutes a new type. As a result, a reference to any 
object instantiated from any class that implements a given interface can be treated as the type of the 
interface. 

So what! 

When a reference to an object is treated as an interface type, any method declared in, or inherited into 
that interface can be called on the reference to the object. 

However, the behavior of the method when called on references to different objects of the same interface 
type may be very different. In the current jargon, the behavior is appropriate for the object on which it is 
called 

One object, many types 

Furthermore, because a single class can implement any number of different interfaces, a single object 
instantiated from a given class can be treated as any of the interface types implemented by the class from 
which it is instantiated. Therefore, a single object in Java can be treated as many different types. 

(However, when an object is treated as an interface type, only those methods declared in that interface 
can be called on the object. To call other methods on the object, it necessary to cast the object’s reference 
to a different type.) 

Treating different types of objects as a common type 
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All of this also makes it possible to treat objects instantiated from widely differing classes as the same 
type, provided that all of those classes implement the same interface. 

Important : When an interface method is called on one of the objects using the reference of the interface 
type, the behavior of the method will be as defined by the author of the specific class that implemented the 
interface. The behavior of the method will often be different for different objects instantiated from different. 
classes that implement the same interface. 

Receiving parameters as interface types 

Methods can receive parameters that are references of interface types. In this case, the author of the 
code that calls interface methods on the incoming reference doesn’t need to know, and often doesn’t care, 
about the name of the class from which the object was instantiated. (For a discussion of this capability, 
see my tutorials on Java Data Structures on my web site at http://www.dickbaldwin.com/toc.htm °° .) 

A common example 

A very common example is to store references to objects instantiated from different classes, (which 
implement the same interface) in some sort of data structure ( such as list or a set) and then to call the 
same methods on each of the references in the collection. 

Heart of the Delegation Event Model 

For example, this methodology is at the heart of the Delegation Event Model , which forms the basis 
of Graphical User Interfaces and event-driven programming in Java. 

This often entails defining classes that implement standard interfaces such as MouseListener , 
WindowListener , TextListener , etc. In this case, the programmer defines the interface methods to 
be appropriate for a listener object instantiated from a specific class. Then a reference to the listener object. 
is registered on an event source as the interface type 

Later when an event of that type occurs, the source object calls one or more interface methods on the 
listener object using the reference of the interface type. The event source object doesn’t know or care about 
the class from which the object was instantiated. In fact, it doesn’t even care how the interface method 
behaves when it is called. The responsibility of the source object ends when it calls the appropriate interface 
method on the listener object. 

Model View Control 

This same methodology is also critical to the use of the Model View Control paradigm in Java using 
the Observer interface and the Observable class. In this case, view objects instantiated from different, 
classes that implement the Observer interface can register themselves on a model object that extends the 

Observable class. Then each time the data being maintained in the model changes, each of the views will 
be notified so that they can update themselves. 

JavaBeans Components 

This concept is also critical to the use of bound and constrained properties in JavaBeans Components. 
One bean can register itself on other beans to be notified each time the value of a bound or constrained 
property changes. In the case of constrained properties, the bean that is notified has the option of vetoing 
the change. 

Java Collections Framework 

The Java Collections Framework is also totally dependent on the use of interfaces. As I mentioned earlier, 
you can read all about this in my modules on Java Data Structures. 

Iterators and Enumerators 

If you appreciate data structures, you will also appreciate iterators. In Java, Iterator is an interface, 
and an object that knows how to iterate across a data structure is an object of a class that implements the 
Iterator interface. 

As a result, the users of the concrete implementations in the Java Collections Framework don’t need 
to know any of the implementation details of the collection to create and use an iterator. All of the work 
necessary to properly create an iterator is done by the author of the class that implements the appropriate 
Collection interfaces. All the user needs to understand is the behavior of the three methods declared in the 
Iterator interface. 


°®http://www.dickbaldwin.com/toc.htm 
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3.2.17.5 Summary 


Polymorphic behavior, based on the Java interface, is one of the most important concepts in Java OOP 

In this module, I began my discussion of runtime polymorphism as implemented using method overriding 
and the Java interface. 

I presented a simple skeleton program that illustrated many of the important aspects of polymorphic 
behavior based on the Java interface. 

By using a nonstandard notation of my own design, (a totally abstract class) , I explained how the 
implementation of interfaces in Java is similar to multiple inheritance. 

I explained the cardinal rule, which is: 

If a class implements an interface, it must provide a concrete definition for all the methods declared 
by that interface, and all the methods inherited by that interface. Otherwise, the class must be declared 
abstract and the definitions must be provided by a class that extends the abstract class. 

Į explained that objects instantiated from classes that implement the same interface have a new relation- 
ship that goes beyond the relationship imposed by the standard class hierarchy. 

I explained that due to the combination of the class hierarchy and the fact that a class can implement 
many different interfaces, a single object in Java can be treated as many different types. However, for any 
given type, there are restrictions on the methods that can be called on the object. 

I also explained that because different classes can implement the same interface, objects instantiated 
from different classes can be treated as a common interface type. 

I suggested that there is little if anything useful that can be done in Java without understanding and 
using interfaces. 

Finally I discussed some real-world examples of the use of the Java interface: 


Delegation event model 

Model View Control paradigm 

Bound and constrained properties in JavaBeans Components 
Java Collections Framework Iterators and Enumerators 


3.2.17.6 What’s next? 


In the next module, I will explain a more substantive program as I continue my discussion of polymorphic 
behavior using the Java interface. 


3.2.17.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Polymorphism and Interfaces, Part 1 
e File: Javal616.htm 

e Published: 03/27/02 

e Revised: 12/06/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have misappropriated copies of my modules from cnx.org, con- 
verted them to Kindle books, and placed them for sale on Amazon.com showing me as the author. 
I receive no compensation for those sales and don’t know who does receive compensation. If you 
purchase such a book, please be aware that it is a bootleg copy of a module that is freely available 
on cnx.org. 


Affiliation :: I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.17.8 Complete program listings 


A complete listing of the sample program is shown in Listing 6 (p. 360) below. 
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Listing 6 . Complete program listing. 


/*File Poly05.java 
Copyright 2002, R.G.Baldwin 
FEA I IO I IOI EE EEEE E EEEE EEEE EEEN 


interface Iif 
public void p(); 
}//end interface I1 


interface I2 extends Iif 
public void q(); 
}//end interface I2 


class A extends Object{ 
public String toString(){ 
return "toString in A"; 
}//end toString() 


public String x(){ 
return "x in A"; 


}//end x() 

[| / --------------------------------- // 
}//end class A 
fa / / 


class B extends A implements I2{ 
public void p(){ 


}//end pQ 

| /--------------------------------- Ed 

public void q(){ 

}//end qQ; 

| /--------------------------------- // 
}//end class B 
//============= // 


class C extends Object implements I2f{ 
public void p(){ 


}//end pQ 
| /--------------------------------- // 
public void q(){ 
}//end qQ; 
| /--------------------------------- // 
}//end class B 
/ /sssssssssssssssssssssssssssssssssas// 


publie lass Poryet lable. f t i htt tent /col11441/1.181> 
public static vo le Ot See Bh Seres F pin nxte content;/co i 


}//end main 
}//end class Poly05 
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Table 3.63 


-end- 


3.2.18 Javal616s Slides” 
3.2.18.1 Table of Contents 


e Instructions for viewing slides (p. 361) 
e Miscellaneous (p. 361) 


3.2.18.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java1616: Polymorphism and Interfaces, Part 
Der 

Click here 58 to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.2.18.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Javal616s Slides: Polymorphism and Interfaces, Part 1 
e File: Javal616s.htm 
e Published: 01/17/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


56 This content is available online at <http://cnx.org/content /m48921/1.2/>. 
5http://cnx.org/content /m44195/latest /?collection=col1 1441 /latest 
'8http://cnx.org/content /m48921 /latest /a0-Index.htm 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


360 


CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


3.2.19 Javal618: Polymorphism and Interfaces, Part 2” 
3.2.19.1 Table of Contents 


e Preface (p. 362) 


Viewing tip (p. 362) 
x Listings (p. 362) 


Preview (p. 362) 


Summary (p. 371) 


3.2.19.2 Preface 


Discussion and sample code (p. 363) 


What’s next? (p. 371) 
Miscellaneous (p. 372) 
Complete program listing (p. 372) 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 


using Java. 


3.2.19.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them.. 


3.2.19.2.1.1 Listings 
Listing 1 (p. 364 


(p. 
Listing 3 (p. 
Listing 4 (p. 
Listing 5 (p. 366 
Listing 6 (p. 
Listing 7 (p. 
Listing 8 (p. 
Listing 9 (p 
Listing 10 (p. 36 
Listing 11 (p. 369 
Listing 12 (p. 
Listing 13 ( 
Listing 14 (p. 370 
Listing 15 (p. 373 


3.2.19.3 Preview 


Method overloading 


. Definition of the interfaces named I1 and 12. 
Listing 2 (p. 364) . 
. Definition of the class named B. 

. Definition of the class named C. 

. Beginning of the class named Poly06. 

. Try unsuccessfully to call the method named q. 
. Successfully call the method named q. 

. Instantiate a new object of the class B. 

. 368) . 


Definition of the class named A. 


Try unsuccessfully to call the method named x. 


) . Successfully call the method named x. 
) . Call the toString method. 
p ) . Try unsuccessfully to call the method named p. 
p. 370) . 
) 
) 


Successfully call the method named p. 


. A walk in the park. 
. Complete program listing. 


I covered method overloading as one form of polymorphism (compile-time polymorphism) in a previous 


module. 


Method overriding and class inheritance 
I discussed runtime polymorphism implemented through method overriding and class inheritance in 
more than one previous module. 


59This content is available online at <http://cnx.org/content /m44196/1.4/>. 
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Using the Java interface 

In this and the previous module, I am explaining runtime polymorphism as implemented using method 

overriding and the Java interface. 
A very important concept 

In my opinion, this is one of the most important concepts in Java OOP, and the one that seems to give 
students the greatest amount of difficulty. Therefore, I am trying to take it slow and easy. As usual, I am 
illustrating the concept using sample programs. 

A skeleton program 

In the previous module, I presented a simple skeleton program that illustrated many of the important 

aspects of polymorphic behavior based on the Java interface. 
Multiple inheritance and the cardinal rule 

I explained how the implementation of interfaces in Java is similar to multiple inheritance. I explained 

the cardinal rule of interface implementation. 
A new relationship 

Į explained that objects instantiated from classes that implement the same interface have a new relation- 

ship that goes beyond the relationship imposed by the standard class hierarchy. 
One object, many types 

I explained that due to the combination of the class hierarchy and the fact that a class can implement 
many different interfaces, a single object in Java can be treated as many different types. However, for any 
given type, there are restrictions on the methods that can be called on the object. 

Many classes, one type 

I explained that because different classes can implement the same interface, objects instantiated from 

different classes can be treated as a common interface type. 
Interfaces are critical to Java programming 

I suggested that there is little if anything useful that can be done in Java without understanding and 
using interfaces. In support of this suggestion, I discussed several real-world examples of the use of the Java 
interface, including the Delegation Event Model and the Model View Control paradigm. 

Another sample program 

In this module, I will present another sample program that will take you deeper into the world of 
polymorphism as implemented using the Java interface. 

The sample program that I will discuss in this module will illustrate (in a very basic form) some of the 
things that you can do with interfaces, along with some of the things that you cannot do with interfaces. In 
order to write programs that do something worthwhile, you will need to extend the concepts illustrated by 
this sample program into real-world requirements. 


3.2.19.4 Discussion and sample code 


Now, let’s take a look at a sample program named Poly06 that is much simpler than any of the real-world 
examples that you will see in future modules. 

This program is designed to be very simple, while still illustrating runtime polymorphism using interfaces, 
class inheritance, and overridden methods. 

You can view a complete listing of the program in Listing 15 (p. 373) near the end of the module. 

Same structure as before 

Note that this program has the same structure as Poly05 discussed in the previous module. (I strongly 
recommend that you study the previous module before continuing with this module.) However, unlike the 
program in the previous module, the methods in this version of the program are not empty. When a method 
is called in this version, something happens. (Admittedly not much happens. Text is displayed on the 
computer screen, but that is something.) 

The interface definitions 

Listing 1 (p. 364) shows the definition of the two interfaces named Il and I2 
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Listing 1 . Definition of the interfaces named I1 and I2. 


interface Iif 
public void pQ); 
}//end interface I1 


interface I2 extends Iif 
public void q(Q); 
}//end interface I2 


Table 3.64 


Since the methods declared in an interface are not allowed to have a body, these interface definitions are 
identical to those shown in the program from the previous module. 

The class named A 

Similarly, Listing 2 (p. 364) shows the definition of the class named A along with the definition of the 
method named x , and the overridden method named toString . 


Listing 2 . Definition of the class named A. 


class A extends Object{ 


public String toString(){ 
return "toString in A"; 
}//end toString() 


public String x(){ 
return "x in A"; 


}//end xQ 


}//end class A 


Table 3.65 


These two methods were also fully defined in the program from the previous module, so there is no change 
here either. 

The method named B 

Listing 3 (p. 365) defines the class named B , which extends A , and implements I2 . 
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Listing 3 . Definition of the class named B. 


class B extends A implements I2{ 
public void p(){ 

System.out.println("p in B"); 
}//end pQ 


public void q(){ 
System.out.println("q in B"); 
}//end qQ; 


}//end class B 


Table 3.66 


Actually implements two interfaces 

Although it isn’t obvious from an examination of Listing 3 (p. 365) alone, the class named B actually 
implements both I2 and I1 . This is because the interface named I2 extends I1 . Thus, the class 
named B implements I2 directly, and implements I1 through interface inheritance. 

The cardinal rule 

In case you have forgotten it, the cardinal rule for implementing interfaces is: 

If a class implements an interface, it must provide a concrete definition for all the methods declared 
by that interface, and all the methods inherited by that interface. Otherwise, the class must be declared 
abstract and the definitions must be provided by a class that extends the abstract class. 

Must define two methods 

As a result, the class named B must provide concrete definitions for the methods p and q . (The 
method named p is declared in interface I1 and the method named q is declared in interface 12.) 

As you can see from Listing 3 (p. 365) , the behavior of each of these methods is to display a message 
indicating that it has been executed. This will be useful later to tell us exactly which method is executed 
when we exercise the objects in the main method of the driver class. 

The class named C 

Listing 4 (p. 365) shows the upgraded version of the class named C 


Listing 4 . Definition of the class named C. 


class C extends Object implements I2{ 
public void p(){ 

System.out.println("p in C"); 
}//end pQ 


public void q(){ 
System.out.println("q in C"); 
}//end qQ; 


}//end class B 
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Table 3.67 


In this upgraded version, the methods named p and q each display a message indicating that they 
have been executed. Again, this will be useful later to let us know exactly which version of the methods 
named p and q get executed when we exercise the objects. 

The driver class 

Listing 5 (p. 366) shows the beginning of the class named Poly06 . The main method in this class 
instantiates objects of the classes named B and C , and exercises them to illustrate what can, and what 
cannot be done with them. 


Listing 5 . Beginning of the class named Poly06. 


public class Poly06{ 
public static void main( 
String[] args) { 
I1 vari = new BQ); 
vari.p();//0K 


Table 3.68 


A new data type 

As explained in the previous module, when you define a new interface, you create a new data type. 

You can store the reference to any object instantiated from any class that implements the interface in a 
reference variable of that type. 

A new object of the class B 

The code shown in Listing 5 (p. 366) instantiates a new object of the class B 

Important: stored as type I1 

It is important to note that the code in Listing 5 (p. 366) stores the object’s reference in a reference 
variable of the interface type I1 (not as the class type B ) . 

Call an interface method 

Following this, the code in Listing 5 (p. 366) successfully calls the method named p on the reference, 

producing the following output on the computer screen: 


p in B 


Why is this allowed? 

This is allowable because the method named p is declared in the interface named I1 

Which version of the method was executed? 

It is also important to note, (by observing the output) , that the version of the method defined in the 
class named B (and not the version defined in the class named C ) was actually executed. 

Attempt unsuccessfully to call q 

Next, the code in Listing 6 (p. 367) attempts, unsuccessfully, to call the method named q on the same 
reference variable of type I1 
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Listing 6 . Try unsuccessfully to call the method named q. 


vari.qQ;//won’t compile 


Table 3.69 


Why did it fail? 

Even though the class named B , from which the object was instantiated, defines the method named 
q , that method is neither declared nor inherited into the interface named I1 

Therefore, a reference of type I1 cannot be used to call the method named q . 

The solution is a type conversion 

Listing 7 (p. 367) shows the solution to the problem presented by Listing 6 (p. 367) . 


Listing 7 . Successfully call the method named q. 


((12) var1) .qQ ;//0K 


Table 3.70 


As in the case of polymorphism involving class inheritance, the solution is to change the type of the 
reference to a type that either declares or inherits the method named q . 

In this case, this takes the form of using a cast operator to convert the type of the reference from type 
I1 ,totype I2 , and then calling the method named q on that reference of a new type. 

This produces the following output: 


q in B 


Using type I2 directly 
Listing 8 (p. 367) instantiates a new object of the class B and stores the object’s reference in a reference 
variable of the interface type I2 


Listing 8 . Instantiate a new object of the class B. 


I2 var2 = new B(); 
var2.p();//0K 
var2.q();//0K 


Table 3.71 


Call both methods successfully 
Then the code successfully calls both the methods p and q on that reference, producing the following 
output: 


p in B 
q in B 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


366 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Why does this work? 
This works because: 


e The interface named I2 declares the method named q 

e The interface named I2 inherits the declaration of the method named p 

e The class named B implements the interface named I2 and provides concrete definitions of both 
the methods p and q . 


Attempt, unsuccessfully, to call x on var2 
Following this, the code in Listing 9 (p. 368) attempts, unsuccessfully, to call the method named x on 
the reference variable named var2 of type I2 . This code produces a compiler error. 


Listing 9 . Try unsuccessfully to call the method named x. 


String var3 = var2.x(); 


Table 3.72 


The object of class B has a method named x 
At this point, the reference variable named var2 contains a reference to an object instantiated from 
the class named B 
Furthermore, the class named B inherits the method named x from the class named A 
Necessary, but not sufficient 
However, the fact that the object contains the method is not sufficient to make it executable in this case. 
Same song, different verse 
The interface named I2 neither declares nor inherits the method named x 
Therefore, the method named x cannot be called using the reference stored in the variable named var2 
unless the reference is converted either to type A (where the method named x is defined) or type 
B (where the method named x is inherited) . 
Do the type conversion 
The required type conversion is accomplished in Listing 10 (p. 368) where the reference is temporarily 
converted to type A using a cast operator. (It would also work to cast it to type B .) 


Listing 10 . Successfully call the method named x. 


String var3 = ((A)var2).x( ;//0K 
System. out.println(var3) ; 


Table 3.73 


The String produced by the first statement in Listing 10 (p. 368) is passed to the println method 
causing the following text to be displayed on the computer screen: 


x in A 
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Get ready for a surprise 

If you have now caught onto the general scheme of things, the next thing that I am going to show you 
may result in a little surprise. 

Successfully call the toString method on var2 

The first statement in Listing 11 (p. 369) successfully calls the toString method on the object of the 
class B whose reference is stored as type I2 


Listing 11 . Call the toString method. 


var3 = var2.toString() ;//0K 
System. out.println(var3) ; 


Table 3.74 


How can this work? 
How can this work when the interface named I2 neither declares nor inherits a method named toString 


A subtle difference in behavior 

I am unable to point you to any Sun documentation to verify the following. (I also admit that I haven’t 
spent a large amount of time searching for such documentation). 

With respect to the eleven methods declared in the Object class (listed in an earlier module) , a 
reference of an interface type acts like it is also of type Object 

And the end result is ... 

This allows the methods declared in the Object class to be called on references held as interface types 
without a requirement to cast the references to type Object . (Later, I will show you that the reverse is 
not true.) 

The output 

Therefore, the two statements shown in Listing 11 (p. 369) cause the following to be displayed on the 

computer screen: 


toString in A 


Polymorphism applies 
Note that the object whose reference is held in var2 was instantiated from the class named B , which 
extends the class named A 
Due to polymorphism, the toString method that was actually executed in Listing 11 (p. 369) was 
the overridden version defined in class A , and not the default version defined in the Object class. The 
overridden version in class A was inherited into class B 
The reverse is not true 
While a reference of an interface type also acts like type Object , a reference of type Object does 
not act like an interface type. 
Store a reference as type Object 
The code in Listing 12 (p. 370) instantiates a new object of type B and stores it in a reference of type 
Object 
Attempt unsuccessfully to call p 
Then it attempts, unsuccessfully, to call the method named p on the reference. 
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Listing 12 . Try unsuccessfully to call the method named p. 


Object var4 = new B(); 
var4.p();//won’t compile 


Table 3.75 


Same song, an even different verse 

The code in Listing 12 (p. 370) won’t compile, because the Object class neither defines nor inherits 
the method named p . 

In order to call the method named p on the reference of type Object , the type of the reference must 
be changed to either: 


e The class in which the method is defined 

e An interface that declares the method, which is implemented by the class in which the method is 
defined 

e A couple of other possibilities involving subclasses or sub-interfaces 


Convert reference to type I1 
The code in Listing 13 (p. 370) uses a cast operator to convert the reference from type Object to type 
T1_, and calls the method named p on the converted reference. 


Listing 13 . Successfully call the method named p. 


((I1) var4) .pQ ;//0K 


Table 3.76 


The output 
The code in Listing 13 (p. 370) compiles and executes successfully, producing the following text on the 
computer screen: 


p in B 


A walk in the park 
If you understand all of the above, understanding the code in Listing 14 (p. 370) should be like a walk 
in the park on a sunny day. 


Listing 14. A walk in the park. 


var2 = new C(); 
var2.p();//0K 
var2.q(Q) ;//0K 


Table 3.77 
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Class C implements I2 

Recall that the class named C also implements the interface named I2 

The code in Listing 14 (p. 370) instantiates a new object of the class named C , and stores the object’s 
reference in the existing reference variable named var2 of type I2 

Then it calls the methods named p and q on that reference, causing the following text to be displayed 
on the computer screen: 


p in C 
q in C 


Which methods were executed? 

This confirms that the methods that were actually executed were the versions defined in the class named 
C ( and not the versions defined in the class named B ) . 

Same method name, different behavior 

It is important to note that the behavior of the methods named p and q , as defined in the class 
named C , is different from the behavior of the methods having the same signatures defined in the class 
named B . Therein lies much of the power of the Java interface. 

The power of the Java interface 

Using interface types, it is possible to collect many objects instantiated from many different classes 
(provided all the classes implement a common interface) , and store each of the references in some kind of 
collection as the interface type. 

Appropriate behavior 

Then it is possible to call any of the interface methods on any of the objects whose references are stored 
in the collection. 

To use the current jargon, when a given interface method is called on a given reference, the behavior that 
results will be appropriate to the class from which that particular object was instantiated. 

This is runtime polymorphism based on interfaces and overridden methods. 


3.2.19.5 Summary 


If you don’t understand interfaces ... 

If you don’t understand interfaces, you don’t understand Java, and it is highly unlikely that you will be 
successful as a Java programmer. 

Interfaces are indispensable in Java 

Beyond writing "Hello World" programs, there is little if anything that can be accomplished using Java 
without understanding and using interfaces. 

What can you do with interfaces? 

The sample program that I discussed in this module has illustrated (in a very basic form) some of the 
things that you can do with interfaces, along with some of the things that you cannot do with interfaces. 

In order to write programs that do something worthwhile, you will need to extend the concepts illustrated 
by this sample program into real-world requirements. 


3.2.19.6 What’s next? 


Java supports the use of static member variables and static methods in class definitions. 

While static members can be useful in some situations, the existence of static members tends to 
complicate the overall object-oriented structure of Java. 

Furthermore, the overuse of static members can lead to problems similar to those experienced in 
languages like C and C++ that support global variables and global functions. 

The use of static members will be discussed in the next module. 
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3.2.19.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Polymorphism and Interfaces, Part 2 
e File: Javal618.htm 

e Published: 04/10/02 

e Revised: 12/06/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have misappropriated copies of my modules from cnx.org, con- 
verted them to Kindle books, and placed them for sale on Amazon.com showing me as the author. 
I receive no compensation for those sales and don’t know who does receive compensation. If you 
purchase such a book, please be aware that it is a bootleg copy of a module that is freely available 
on cnx.org. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.19.8 Complete program listing 
A complete listing of the sample program is shown in Listing 15 (p. 373) below. 
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Listing 15 . Complete program listing. 


/*File Poly06. java 
Copyright 2002, R.G.Baldwin 


This program illustrates polymorphic 
behavior using interfaces in addition 
to class inheritance. 


The program output is: 
p in B 
q inB 


p in B 
q in B 
x in A 
toString in A 


p in B 


p in C 
q in C 
LEETE EEEE EEEE EE EEEE EEE EEEE E EEEE EEEE EEEN 


interface Iif 
public void pQ); 
}//end interface I1 


interface I2 extends Iif 
public void q(Q); 
}//end interface I2 


class A extends Object{ 
public String toString(){ 


return "toString in A"; 
}//end toString() 


public String x(){ 
return "x in A"; 


}//end x() 

[| /--------------------------------- // 
}//end class A 
Y /=================================== / / 


class B extends A implements I2{ 
public void p(){ 
System.out.println("p in B"); 
}//end pQ 


public void q(){ 
System.out.println("q in B"); 
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Table 3.78 


-end- 


3.2.20 Javal618s Slides” 
3.2.20.1 Table of Contents 


e Instructions for viewing slides (p. 374) 
e Miscellaneous (p. 374) 


3.2.20.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Javal618: Polymorphism and Interfaces, Part 
297 

Click here ©? to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.2.20.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Javal618s Slides: Polymorphism and Interfaces, Part 2 
e File: Javal618s.htm 
e Published: 01/17/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


6°This content is available online at <http://cnx.org/content /m48925/1.2/>. 
®lhttp://cnx.org/content /m44196 /latest /?collection=coll1441/latest 
62http://cnx.org/content /m48925 /latest /a0-Index.htm 
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3.2.21 Java1620: Static Members” 
3.2.21.1 Table of Contents 


e Preface (p. 375) 
Viewing tip (p. 375) 

x Images (p. 375) 

x Listings (p. 375) 


3.2.21.2 Preface 


Preview (p. 376) 
Discussion and sample code (p. 376) 
Summary (p. 388) 
What’s next? (p. 389) 
Miscellaneous (p. 389) 
Complete program listing (p. 390) 
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This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 


using Java. 


3.2.21.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 


following links to easily find and view the images and listings while you are reading about them. 


3.2.21.2.1.1 Images 


Image 2 (p 


Image 1 (p. 381 


) 
( ) 
Image 3 (p. 383) 
Image 4 (p. 384) . 
Image 5 (p. 385) 
Image 6 (p. 387) 


3.2.21.2.1.2 Listings 


Listing 1 (p. 
Listing 2 (p. 
Listing 3 (p. 
Listing 4 (p. 3 
Listing 5 (p. 
Listing 6 (p. 
Listing 7 (p. 
Listing 8 (p. 
Listing 9 (p. 
Listing 10 (p. 
Listing 11 (p. 
Listing 12 (p. 3 
Listing 13 (p. 
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. Output date and time. 
. Five seconds later. 
. Same date and time as before. 


A new date and time. 


. Same date and time as before. 
. Output from overridden toString method in Date class. 


. Beginning of the class named MyClass01. 
. Signature of the main method. 

. Display some text. 

. Display date information. 

. A five-second delay. 

. Instantiate a new object. 

. Display the new Date object. 

. Accessing class variable via an object. 

. Another new object. 


). 
). 


86) . 
). 


Display the date and time. 
Display date information. 
Revisiting System.out.println. 
Complete program listing. 


63 This content is available online at <http://cnx.org/content /m44197/1.5/>. 
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3.2.21.3 Preview 


Static members 

There is another aspect of OOP in Java that I have avoided up to this point in the discussion: static 
variables and static methods. 

Tends to complicate ... 

I have avoided this topic because, while not particularly difficult, the existence of static members tends 
to break up the simple structures that I have discussed in previous modules in this collection. 

While static members can be useful in some situations, the existence of static members tends to 
complicate the overall object-oriented structure of Java. 

Avoid overuse of static members 

Furthermore, the overuse of static members can lead to problems similar to those experienced in 
languages like C and C++ that support global variables and global functions. 

When to use static members 

I will discuss the use of static members in this module, and will provide some guidelines for their use. 

The class named Class 

I will also introduce the class named Class and discuss how it enters into the use of static variables 
and methods. 

Instance members versus class members 

I will describe the differences between instance members and class members with particular emphasis 
being placed on their accessibility. 

Three kinds of objects 

From a conceptual viewpoint, there are at least three kinds of objects involved in a Java program: 


e Ordinary objects 
e Array objects 
e Class objects 


Ordinary objects 

All (or at least most) of the discussion up to this point in the collection deals with what I have referred 
to in the above list as ordinary objects 

These are the objects that you instantiate in you code by applying the new operator to a constructor 
for a class in order to create a new instance (object) of that class. (There are also a couple of other ways 
to create ordinary objects, but I’m not going to get into that at this time.) 

Array objects 

I haven’t discussed array objects thus far in this collection. (I will discuss them in a future module.) 

Suffice it for now to say that array objects are objects whose purpose is to encapsulate a one-dimensional 
array structure that can contain either primitive values, or references to other objects (including other array 
objects). 

I will discuss Class objects in this module. 


3.2.21.4 Discussion and sample code 


Class objects 

Let me emphasize at the beginning that the following discussion is conceptual in nature. In this 
discussion, I will describe how the Java system behaves, not necessarily how it is implemented. In other 
words, however it is implemented, it behaves as though it is implemented in the manner described below. 

The class named Class 

There is a class whose name is Class . The purpose of this class is to encapsulate information about 
some other class (actually, it can also be used to encapsulate information about primitive types as well as 
class types). 

Here is part of what Sun has to say about this class: 

"Instances of the class Class represent classes and interfaces in a running Java application. ... 
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Class has no public constructor. Instead Class objects are constructed automatically by the Java 
Virtual Machine as classes are loaded ..." 
What does this mean? 

As a practical matter, when one or more objects are instantiated from a given class, an extra object of 
the Class class is also instantiated automatically. This object contains information about the class from 
which the objects were instantiated. (Note that it is also possible to cause a Class object that describes 
a specific class to be created in the absence of objects of that class, but that is a topic that will be reserved 
for more advanced modules.) 

A real-world analogy 

Here is an attempt to describe a real-world analogy. Remember that a class definition contains the 
blueprint for objects instantiated from that class. 

A certain large construction company is in the business of building condominium projects. This contractor 
builds condos of many different sizes, types, and price ranges. However, each different condo project contains 
condos of only two or three different types or price ranges. 

A library of blueprints 

There is a large library of blueprints at the contractor’s central office. This library contains blueprints 
for all of the different types of condos that the contractor has built or is building. (This library is analogous 
to the class libraries available to the Java programmer.) 

A subset from the blueprint library 

When a condo project begins, the contractor delivers copies of several sets of blueprints to the construction 

site. The blueprints delivered to that site describe only the types of condos being constructed on that site. 
Condo is analogous to an object 

Each condo unit is analogous to an ordinary Java object 

Each set of blueprints delivered to the construction site is roughly analogous to an object of the class 
named Class . In other words, each set of blueprints describes one or more condo units constructed from 
that set of blueprints. 

When construction is complete 

When the construction project is complete, the contractor delivers a set of blueprints for each type of 
condo unit to the management firm that has been hired to manage the condo complex. Each set of blueprints 
continues to be analogous to an object of the class named Class . The blueprints remain at the site of the 
condo units. 

RTTI 

Thus, information regarding the construction, wiring, plumbing, air conditioning, etc., for each condo 
unit (object) continues to be available at the site even after the construction has been completed. (This is 
somewhat analogous to something called runtime type information and often abbreviated as RTTI. A Class 
object contains RTTI for objects instantiated from that class.) 

What are those analogies again? 

In the above scenario, each condo unit is (roughly) analogous to an object instantiated from a specific 
class (set of blueprints). 

Each set of blueprints remaining onsite after construction is complete is roughly analogous to a Class 
object that describes the characteristics of one or more condo units. 

What do you care? 

Until you get involved in such advanced topics as reflection and introspection , you don’t usually have 
much involvement or much interest in Class objects. They are created automatically, and are primarily 
used by the Java virtual machine during runtime to help it do the things that it needs to do. 

An exception to that rule 

However, there is one area where you will be interested in the use of these Class objects from early on. 
You will be interested whenever variables or methods in the class definition are declared to be static 

Class variables and class methods 

According to the current jargon, declaring a member variable to be static causes it to be a class 

variable . (Note that local variables cannot be declared static . Only member variables can be declared 
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static .) Similarly, declaring a method to be static causes it to be a class method. 
Instance variables and methods 

On the other hand, according to the current jargon, not declaring a variable to be static causes it to 
be an instance variable , and not declaring a method to be static causes it to be an instance method . 

In general, we can refer to them as class members and instance members 

What is the difference? 

Here are some of the differences between class and instance members insofar as this discussion is 
concerned. 

How many copies of member variables exist? 

Every object instantiated from a given class has its own copy of each instance variable defined in the 
class. (Instance variables are not shared among objects.) However, every object instantiated from a given 
class shares the same copy of each class variable defined in the class. (It is as though the class variable 
belongs to the single Class object and not to the individual objects instantiated from that class.) 

Access to an instance variable 

Every object has its own copy of each instance variable (the object owns the instance variable). There- 
fore, the only way that you can access an instance variable is to use that object’s reference to send a message 
to the object requesting access to the variable (even then, you may not be given access, depending on access 


modifiers). 
Why call it an instance variable? 
According to the current jargon, an object is an instance of a class . (I probably told you that 


somewhere before in this collection.) Each object has its own copy of each non-static variable. Hence, they 
are often called instance variables. (Every instance of the class owns one and they are not implicitly shared 
among instances. ) 

Access to a class variable 

You can also send a message to an object requesting access to a class variable that the object shares with 
other objects instantiated from the same class. (Again, you may or may not gain access, depending the 
access modifiers). 

Access using the Class object 

More importantly, you can also access a class variable without a requirement to go through an object 
instantiated from the class. (In fact, a class variable can be accessed in the total absence of objects 
of that class.) (Remember, this discussion is conceptual in nature, and may not represent an actual 
implementation.) 

Assuming that a class variable is otherwise accessible, you can access the class variable by sending an 
access request message to the Class object to which the variable belongs. 

One way to think of this 

To help you keep track of things in a message-passing sense, you can pretend that there is a global 
reference variable whose name is the same as the name of a class. 

This (hypothetical) reference variable contains a reference to the Class object that owns the class 
variable. Using standard Java message-passing syntax, you can access the class variable by joining the name 
of the reference variable to the name of the class variable with a period. Example syntax is shown below: 


ReferenceVariableName.ClassVariableName 
Asa result of the hypothetical substitution process that I described above, this is equivalent to the following: 
ClassName.ClassVariableName 


We will see an example of this in the sample program that I will discuss later. 

Be careful with this thought process 

While this thought process may be useful when thinking about static variables and methods, I want 
to point out, that the thought process breaks down very quickly when dealing with Class objects in a 
deeper sense. 
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For example, when calling the getName method on a Class object, an actual reference of type 
Class is required to access the members of the Class object. The name of the class will not suffice. 

If this discussion of a global reference variable whose name matches the name of the class is confusing 
to you, just forget it. Simply remember that you can access class variables by joining the name of the class 
to the name of the class variable using a period as the joining operator. 

Characteristics of class methods 

I’m not going to talk very much about instance methods and class methods in this module. However, 
there are a couple of characteristics of class methods that deserve a brief discussion in this context. 

Cannot access instance members 

First, the code in a class method has direct access only to other static members of the class. (A class 
method does not have direct access to instance variables or instance methods of the class.) This is sort of 
like saying that a class method has access to the methods and variables belonging to the Class object, but 
does not have access to the methods and variables belonging to the ordinary objects instantiated from the 
class described by the Class object. 

Once again, be careful 

Once again, this thinking breaks down very quickly once you get beyond static members. A Class 
object also has instance methods, such as getName , which can only be accessed using an actual reference 
to the Class object. 

Now you are probably beginning to understand why I deferred this discussion until after I finished 
discussing the easy stuff. 

No object required 

Another important characteristic is that a class method can be accessed without a requirement for an 
object of the class to exist. 

As with class variables, class methods can be accessed by joining the name of the class to the name of 
the method with a period. 

I will illustrate much of this with a sample program named MyClass01 

Discuss in fragments 

I will discuss the program in fragments. You will find a complete listing of the program in Listing 13 (p. 
391) near the end of the module. 

Listing 1 (p. 379) shows the beginning of the class definition. 


Listing 1 . Beginning of the class named MyClass01. 


class MyClass01f{ 
static Date vi = new Date(); 
Date v2 = new Date(); 


Table 3.79 


Two member variables 

The code in Listing 1 (p. 379) declares two member variables, named v1 and v2 , and initializes 
each of those variables with a reference to a new object of the Date class. (When instantiated using 
the constructor with no arguments, the new Date object encapsulates the current date and time from the 
system clock.) 

Note the static keyword 

The important thing to note here is the use of the static keyword when declaring the variable named 
v1 . This causes v1 to bea class variable , exhibiting the characteristics of class variables described 
earlier. 

An instance variable 
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On the other hand, the variable named v2 is not declared static . This causes it to be an instance 
variable , as described above. 

The main method is a class method 

Listing 2 (p. 380) shows the signature for the main method. 


Listing 2 . Signature of the main method. 


public static void main(String[] args){ 


Table 3.80 


The important thing to note here is that the main method is declared static . That causes it to be 
a class method . 

As aresult, the main method can be called without a requirement for an object of the class to exist. 
(Also, the main method has direct access only to other static members.) 

How a Java application starts running 

In fact, that is how the Java Virtual Machine starts an application running. 

First the JVM finds the specified file having an extension of .class. Then it examines that file to see 
if it has a main method with the correct signature. If not, an error occurs. 

If the JVM finds a main method with the correct signature, it calls that method without instantiating 
an object of the class. That is how the Java Virtual Machine causes a Java application to start running. 

A side note regarding applets 

For those of you who are familiar with Java applets, you should know that this is not the case for an 
applet. An applet does not use a main method. When an applet is started, an object of the controlling 
class is instantiated by the browser, by the appletviewer program, or by whatever program is being used 
to control the execution of the applet. 

A poor programming technique 

Basically, this entire sample program is coded inside the main method. As a practical manner, this is 
a very poor programming technique, but it works well for this example. 

Display some text 

The code in Listing 3 (p. 380) , which is the first executable statement in the main method, causes 
the words Static variable to appear on the computer screen. I will come back and discuss the details of 
this and similar statements later in the module. 


Listing 3 . Display some text. 


System.out.println("Static variable"); 


Table 3.81 


Display date information 

Continuing with the code in the main method, the code in Listing 4 (p. 381) causes the current 
contents of the Date object referred to by the contents of the class variable named v1 to be displayed 
on the computer screen. 
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Listing 4 . Display date information. 


System. out.println(MyClass01.v1); 


Table 3.82 


No object required 

For the moment, concentrate on the text inside the parentheses in the statement in Listing 4 (p. 381) . 

Because the variable named v1 isa class variable, it’s value is accessed by joining the name of the class 
to the name of the variable with a period. 

What was the output? 

I will discuss the remaining portion of statements of this sort later. For now, just be aware that the code 
in Listing 4 (p. 381) caused the output shown in Image 1 (p. 381) to be displayed on my computer screen 
when I ran the program. 


Image 1 . Output date and time. 


Mon Sep 17 09:52:27 CDT 2001 


Table 3.83 


Displays date and time 

Obviously, the date and time displayed will depend on when you run the program. As you can see, I first 
wrote this module and ran this program in 2001. 

Pay particular attention to the seconds portion of the time. I will refer back to this later. 

A five-second delay 

The code in Listing 5 (p. 381) (still in the main method) causes the main thread of the program to 
go to sleep for five seconds. Don’t worry about it if you don’t understand this code. The only reason that I 
included it in the program was to force a five-second delay in the execution of the program. 


Listing 5 . A five-second delay. 


try{ 
Thread. currentThread() .sleep(5000); 
}catch(InterruptedException e){} 


Table 3.84 


Instantiate a new object 

Having caused the program to sleep for five seconds, the code in Listing 6 (p. 382) instantiates a new 
object of the class named MyClass01 . This code stores the new object’s reference in the reference variable 
named refi 
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Listing 6 . Instantiate a new object . 


MyClass01 refi = new MyClass01(); 


Table 3.85 


A new Date object also 

Recall from Listing 1 (p. 379) above that the class declares an instance variable named v2 of the type 
Date 

When the new object is instantiated by the code in Listing 6 (p. 382) , a new Date object is also 
instantiated. A reference to that object is stored in the instance variable named v2 . (In other words, the 
new object of the class MyClass01 owns a reference to a new object of the class Date . That reference 
is stored in an instance variable named v2 in the new MyClass01 object.) 

Display the new Date object 

The code in Listing 7 (p. 382) causes a textual representation of the new Date object referred to by 
the reference variable named v2 belonging to the object referred to by the reference variable named refi 
, to be displayed on the standard output device. 


Listing 7 . Display the new Date object . 


System. out.println(ref1.v2) ; 


Table 3.86 


Five seconds later 
This code caused the date and time shown in Image 2 (p. 382) to appear on the computer screen when 
I ran the program: 


Image 2 . Five seconds later. 


Mon Sep 17 09:52:32 CDT 2001 


Table 3.87 


The date and time shown in Image 2 (p. 382) is five seconds later than the time reflected in the Date 
object referred to by the class variable named v1 (see Image 1 (p. 381) ) . That time was displayed by 
the code in Listing 4 (p. 381) earlier. 

So, what does this mean? 

It means that the Date object referred to by the static reference variable named v1 was created 

five seconds earlier than the Date object referred to by the instance variable named v2 
When is a class variable created? 

I can’t tell you precisely when a class variable comes into existence. All I can say is that the virtual 
machine brings it into existence as soon as it is needed. 

My guess is that it comes into existence at the first mention (in the program) of the class to which it 
belongs. 
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When is an instance variable created? 

An instance variable doesn’t come into existence until the object to which it belongs is created. (An 
instance variable cannot exist until the object to which it belongs exists.) 

If the instance variable is initialized with a reference to a new object (such as anew Date object in 
this sample program), that new object comes into existence when the object to which it belongs comes into 
existence. 

A five-second delay 

In this program, I purposely inserted a five-second delay between the first mention of the class named 
MyClass01 in Listing 4 (p. 381) , and the instantiation of the object of the class named MyClass01 in 
Listing 6 (p. 382) . 

As a result, the Date object referred to by the instance variable named v2 was created about five 
seconds later than the Date object referred to by the class variable named v1 

This is reflected in the date and time values displayed and discussed above. 

Accessing class variable via an object 

While it is possible to access a class variable using the name of the class joined to the name of the variable, 
it is also possible to access a class variable using a reference to any object instantiated from the class. 

(As mentioned earlier, if two or more objects are instantiated from the same class, they share the same 
class variable.) 

The code in parentheses in Listing 8 (p. 383) uses the reference variable named ref1 to access the class 
variable named v1_, and to cause the contents of the Date object referred to by the class variable to be 
displayed. 


Listing 8 . Accessing class variable via an object. 


System. out.println(ref1.v1); 


Table 3.88 


The output 
This caused the date and time shown in Image 3 (p. 383) to be displayed on my computer screen. 


Image 3 . Same date and time as before. 


Mon Sep 17 09:52:27 CDT 2001 


Table 3.89 


Same date and time as before 
As you have probably already surmised, this is the same date and time shown earlier in Image 1 (p. 381) 
. This is because the code in Listing 8 (p. 383) refers to the same class variable as the code in Listing 4 (p. 
381) . 
Nothing has caused the contents of that class variable to change, so both Image 1 (p. 381) and Image 3 
(p. 383) display the contents of the same Date object. 
(Only one class variable exists and it doesn’t matter how you access it. Either way, you gain access to 
the same Date object whose reference is stored in the class variable. Thus, the same date and time is 
shown in both cases.) 
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Another new object 

If you examine the code in Listing 13 (p. 391) near the end of the program, you will see that an additional 
five-second delay is introduced at this point in the program. 

Following that delay, the code in Listing 9 (p. 384) instantiates another new object of the class named 
MyClass01_, and stores the object’s reference in a new reference variable named ref2 

(The object referred to by ref1 is a different object than the object referred to by ref2 . Each object 
has its own instance variable named v2_, and in this case, each instance variable is initialized to instantiate 
and refer to anew Date object when the new MyClass01 object is instantiated.) 


Listing 9 . Another new object . 


MyClass01 ref2 = new MyClass01(); 


Table 3.90 


Display the date and time 
Then, the code in Listing 10 (p. 384) causes the contents of the Date object referred to by the instance 
variable named v2 in the second object of the class named MyClass01 to be displayed. 


Listing 10 . Display the date and time . 


System. out.println(ref2.v2) ; 


Table 3.91 


This caused the output shown in Image 4 (p. 384) to be displayed on my computer screen when I ran 
the program. 

(Once again, you will get different results if you compile and run the program because the date and time 
shown is the date and time that you run the program.) 


Image 4 . A new date and time. 


Mon Sep 17 09:52:37 CDT 2001 


Table 3.92 


Five seconds later 

As you have probably figured out by now, the time encapsulated in this Date object is five seconds 
later than the time encapsulated in the Date object displayed in Image 2 (p. 382) . This is because the 
program was put to sleep for five seconds between the instantiation of the two objects referred to by refl 
and ref2 

Every object has one 

Every object instantiated from a given class has its own copy of each instance variable declared in the 
class definition. There is no sharing of instance variables among objects. 
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Each instance variable comes into existence when the object to which it belongs comes into existence, 
and ceases to exist when the object to which it belongs ceases to exist. 
Eligible for garbage collection 

If the instance variables are reference variables holding references to other objects, as is the case here, 
and if there are no other reference variables holding references to those same objects, the secondary objects 
cease to exist when the primary objects cease to exist. 

Technically, the objects may not actually cease to exist. Technically they become eligible for garbage 
collection, which means that the memory that they occupy becomes eligible for reuse. However, as a practical 
matter, they cease to exist insofar as the program is concerned because they are no longer accessible. 

A five-second difference in the time of creation 

Since the two objects referred to by refl and ref2 came into existence with a five-second delay, the 
Date objects belonging to those two object reflect a five-second difference in the time encapsulated in the 
objects. 

Only one copy of class variable exists 

Also remember that if a variable is a class variable, only one copy of the variable exists, and all objects 
instantiated from the class share that one copy. 

This is illustrated by the code in Listing 11 (p. 385) , which uses the reference to the second object 
instantiated from the class named MyClass01 _, to cause the contents of the class variable named v1 to 
be displayed. 


Listing 11 . Display date information. 


System.out.println(ref2.v1); 
}//end main 


Table 3.93 


The output produced by the code in Listing 11 (p. 385) is shown in Image 5 (p. 385) . 


Image 5 . Same date and time as before. 


Mon Sep 17 09:52:27 CDT 2001 


Table 3.94 


Same output as before 
As you can see, this is the same as the output shown in Image 1 (p. 381) and Image 3 (p. 383) earlier. 
Accessing the same physical class variable 

Since only one class variable named v1_ exists, and all objects instantiated from the class named 
MyClass01 share that single copy, it doesn’t matter whether you access the class variable using the name 
of the class, or access it using a reference to either of the objects instantiated from the class. In all three 
cases, you are accessing the same physical class variable. 

Since nothing was done to cause the contents of the class variable to change after it came into existence 
and was initialized, Image 1 (p. 381) , Image 3 (p. 383) , and Image 5 (p. 385) are simply three different 
displays of the date and time encapsulated in the same Date object whose reference is stored in the class 
variable. 
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Let’s revisit System.out.printIn... 
Now, I want to revisit the statement originally shown in Listing 8 (p. 383) and repeated in Listing 12 
(p. 386) for viewing convenience. 


Listing 12 . Revisiting System.out.println. 


System. out.println(ref1.v1); 


Table 3.95 


Java programmer wanted 

I sometimes tell my students that if I were out in industry interviewing prospective Java programmers, 
my first question would be to ask the prospective employee to tell me everything that she knows about the 
statement in Listing 12 (p. 386) . 

Covers a lot of Java OOP technology 

This is not because there is a great demand for the use of this statement in real-world problems. (In fact, 
in a GUEdriven software product world, there is probably very little demand for the use of this statement.) 
Rather, it is because a lot of Java object-oriented technology is embodied in this single statement. 

In that scenario, I would expect to receive a verbal dissertation of fifteen to twenty minutes in length to 
cover all the important points. 

The short version 

Let me give you the short version. There is a class named System . The System class declares three 
static (class) variables having the following types, names, and modifiers: 


e public static final PrintStream out 
e public static final InputStream in 
e public static final PrintStream err 


(Note that these class variables are also declared final , causing them to behave as constants.) 

A ccess the out variable without an object 

Because out is a class variable, System.out returns the contents of the class variable named out 
(an object of the System class is not required in order to access a class variable of the System class). 

In general, (ignoring the possibility of subclasses and interfaces) because out is a reference variable 
of type PrintStream , the returned value must either be null (no object reference) or a reference to a 
valid PrintStream object. 

Object of the PrintStream class 

When the Java Virtual Machine starts an application running, it automatically instantiates an object of 
the PrintStream class and connects it to the standard output device . (By default, the standard 
output device is typically the computer screen, but it can be redirected at the operating system level to be 
some other device. The following discussion assumes that the screen is the standard output device.) 

Assign object’s reference to out variable 

When the PrintStream object is instantiated by the virtual machine, the object’s reference is assigned 
to the class variable of the System class named out . (Because the variable named out is final, the 
contents of the variable cannot be modified later.) 

Reference to a PrintStream object 

Therefore, the expression System.out returns a reference to the PrintStream object, which is 
connected to the standard output device. 

Many instance methods 
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An object of the PrintStream class contains many instance methods. This includes numerous over- 
loaded versions of a method named println . The signature of one of those overloaded versions of the 
println method follows 


public void println(Object x) 


Textual representation of an object 
The purpose of this overloaded version of the printIn method is to: 


e Create a textual representation of the object referred to by the incoming parameter of type Object 
(because Object is a totally generic type, this version of the printIn method can accept an 
incoming parameter that is a reference to any type of object) 
e Send that textual representation to the output device 


In general... 

A new PrintStream object can be connected to a variety of output devices when it is instantiated. 
However, in the special case of the PrintStream object instantiated by the virtual machine when the 
program starts, whose reference is stored in the class variable named out of the System class, the 
purpose of the object is to provide a display path to the standard output device. 

Our old friend, the toString method 
To accomplish this, the code in the version of the println method shown above (p. 387) calls the 
toString method on the incoming reference. (I discussed the toString method in detail in earlier 
modules in this collection.) The toString method may, or may not, have been overridden in the definition 
of the class from which the object was instantiated, or in some superclass of the class from which the object 
was instantiated. 
Default version of toString 

If not overridden, the default version of the toString method defined in the Object class is used to 
produce a textual representation of the object. As we learned in an earlier module, that textual representation 
looks something like the following: 


ClassName@HexHashCode 


Overridden version of toString method 

If the class from which the object was instantiated (or some superclass of that class) contains an 
overridden version of the toString method, runtime polymorphism kicks in and the overridden version of 
the method is executed to produce the textual representation of the object. 

The Date class overrides toString 

In the case of this sample program, the object was instantiated from the Date class. The Date class 
does override the toString method. 

When the overridden toString method is called ona Date object’s reference, the String returned 
by the method looks something like that shown in Image 6 (p. 387) . 


Image 6 . Output from overridden toString method in Date class. 


Mon Sep 17 09:52:27 CDT 2001 


Table 3.96 
You will recall that this is the output that was produced by the code shown in Listing 8 (p. 383) and 


Listing 12 (p. 386) . 
More than you ever wanted to know ... 
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And that is probably more than you ever wanted to know about the expression System.out.printin... 


It is also probably more than you ever wanted to know about class variables, class methods, instance 

variables, and instance methods. 
Some cautions 

Before leaving this topic, I do want to express some cautions. Basically, I want to suggest that you use 

static members very sparingly, if at all. 
Static variables 

To begin with, don’t ever use static variables without declaring them final unless you understand 

exactly why you are declaring them static 
( static final variables, or constants, are often very appropriate. See the fields in the Color class 
for example.) 

I can only think of only a very a few situations in which the use of a non-final static variable might be 
appropriate. 

(One appropriate use might be to count the number of objects instantiated from a specific class.) 
Static methods 

Don’t declare methods static if there is any requirement for the method to remember anything from 
one call to the next. 

There are many appropriate uses for static methods, but in most cases, the purpose of the method 
will be to completely perform some action with no requirement to remember anything from that call to the 
next. 

The method should probably also be self-contained. By this I mean that all information that the method 
needs to do its job should either come from incoming parameters or from final static member variables 

(constants). The method probably should not depend on the values stored in non-final static member 
variables, which are subject to change over time. 
(A static method only has access to other static members of the class, so it cannot depend on 
instance variables defined in the class.) 

An appropriate example of a static method is the sqrt method of the Math class. This method 
computes and "Returns the correctly rounded positive square root of a double" where the double value is 
provided as a parameter to the method. Each time the method is called, it completes its task and doesn’t 
attempt to save any values from that call to the next. Furthermore, it gets all the information that it needs 
to do its job from an incoming parameter. 


3.2.21.5 Summary 


Added complexity 

The existence of static members tends to break up the simple OOP structures that I have discussed 
in previous modules in this collection. 

While static members can be useful in some situations, the existence of static members tends to 
complicate the overall object-oriented structure of Java. 

Furthermore, the overuse of static members can lead to problems similar to those experienced in 
languages like C and C++ that support global variables and global functions. 

The class named Class 

I discussed the class named Class and how a conceptual object of type Class exists in memory 
following a reference to a specific class in the program code. 

The Class object represents the referenced class in memory, and contains the static variables and 
static methods belonging to that class. (It contains some other information as well, such as the name of 
the superclass.) 

Class members and instance members 
Class variables and class methods are declared static (declaring a member static in the class 
definition causes to be called a class member) . 
Instance variables and instance methods are not declared static 
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Each object has its own copy ... 

Every object instantiated from a given class has its own copy of each instance variable declared in the 
class definition. (Instance variables are not shared among objects.) 

Every object instantiated from a given class acts like it has its own copy of every instance method declared 
in the class definition. (Although instance methods are actually shared among objects in order to reduce 
the amount of memory required, they are shared in such a way that they don’t appear to be shared.) 

Every object shares ... 

Every object instantiated from a given class shares the same single copy of each class variable declared 
in the class definition. Similarly, every object instantiated from a given class shares the same copy of each 
class method. 

Accessing an instance member 

An instance variable or an instance method can only be accessed by using a reference to the object that 
owns it. Even then, it may or may not be accessible depending on the access modifier assigned by the 
programmer. 

Accessing a class member 
The single shared copy of a class variable or a class method can be accessed in either of two ways: 


e Via a reference to any object instantiated from the class. 
e By simply joining the name of the class to the name of the class variable or the class method. 


Again, the variable or method may or may not be accessible, depending on the access modifiers assigned by 
the programmer. 

When to use class variables 

It is very often appropriate to use final static variables, as constants in your programs. It is rarely, if 
ever, appropriate to use non-final static variables in your programs. The use of non-final static variables 
should definitely be minimized. 

When to use static methods 

It is often appropriate to use static methods in your programs, provided there is no requirement for 
the method to remember anything from one call to the next. Static methods should be self-contained. 


3.2.21.6 What’s next? 


The next module in this collection will address the special case of Array Objects. 


3.2.21.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Static Members 
e File: Javal620.htm 

e Published: 04/24/02 

e Revised:12/06/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 

Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.21.8 Complete program listing 
A complete listing of the sample program is shown in Listing 13 (p. 391) . 
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Listing 13 . Complete program listing. 


/*File MyClass01. java 
Copyright 2002, R.G.Baldwin 


This program illustrates static 
members of a class. Output is: 


Static variable 
Mon Sep 17 09:52:27 CDT 2001 


Instance variable 

Mon Sep 17 09:52:32 CDT 2001 
Static variable 

Mon Sep 17 09:52:27 CDT 2001 


Instance variable 
Mon Sep 17 09:52:37 CDT 2001 
Static variable 
Mon Sep 17 09:52:27 CDT 2001 
SOOO OO a a a kk kk ak ak kak ak / 
import java.util.Date; 

class MyClass01f{ 

static Date vi = new Date(); 

Date v2 = new Date(); 


public static void main( 

String[] args) { 

//Display static variable 
System.out.print1n( 

"Static variable") ; 
System.out.println(MyClass01.v1); 


//Delay for five seconds 

try{ 

Thread.currentThread() .sleep(5000) ; 
}catch(InterruptedException e){} 


//Instantiate an object and 

// display instance variable 
MyClass01 refi = new MyClass01(); 
System.out.println();//blank line 
System.out.printin( 

"Instance variable") ; 
System.out.println(ref1.v2) ; 


//Now, display the static 
// variable using object reference 
System.out.printin( 
"Static variable"); 
System.out.println(ref1,.v1); , 
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Table 3.97 


-end- 


3.2.22 Javal620s Slides™ 
3.2.22.1 Table of Contents 


e Instructions for viewing slides (p. 392) 
e Miscellaneous (p. 392) 


3.2.22.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Javal620: Static Members © . 

Click here ĉĉ to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.2.22.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Javal620s Slides: Static Members 
e File: Java1620s.htm 
e Published: 01/17/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


64This content is available online at <http://cnx.org/content /m48929/1.2/>. 
*Shttp://cnx.org/content /m44197 /latest /?collection=col11441/latest 
66http://cnx.org/content /m48929 /latest /a0-Index.htm 
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3.2.23 Javal622: Array Objects, Part 1° 
3.2.23.1 Table of Contents 


e Preface (p. 393) 

Viewing tip (p. 393) 

x Listings (p. 393) 

Preview (p. 393) 
Discussion and sample code (p. 394) 
Summary (p. 403) 
What’s next? (p. 403) 
Miscellaneous (p. 403) 
Complete program listing (p. 404) 


3.2.23.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 


3.2.23.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


3.2.23.2.1.1 Listings 


e Listing 1 (p. 394) . Sample variable declarations for array objects. 
e Listing 2 (p. 396) . The special case of type Object. 

e Listing 3 (p. 397) . Creating array objects. 

e Listing 4 (p. 399) . The beginning of the class named Array05. 

e Listing 5 (p. 400) . A new ordinary object of class Array05. 

e Listing 6 (p. 400) . Populate the second element. 

e Listing 7 (p. 400) . Print some data. 

e Listing 8 (p. 401) . Produce some more output. 

e Listing 9 (p. 405) . Complete program listing. 


3.2.23.3 Preview 


This module explains how array objects fit into the grand scheme of things in Object-Oriented Programming 
(OOP) using Java. 

A different syntax is required to create array objects than the syntax normally used to create ordinary 
objects. 

Array objects are accessed via references. Any of the methods of the Object class can be called on a 
reference to an array object. 

Array objects encapsulate a group of variables. The variables don’t have individual names. They are 
accessed using positive integer index values. The integer indices of a Java array object always extend from 
0 to (n-1) where n isthe length of the array encapsulated in the object. 

All array objects in Java encapsulate one-dimensional arrays. The component type of an array may itself 
be an array type. This makes it possible to create array objects whose individual components refer to other 
array objects. This is the mechanism for creating multi-dimensional or ragged arrays in Java. 


67This content is available online at <http://cnx.org/content /m44198/1.4/>. 
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3.2.23.4 Discussion and sample code 


Three kinds of objects 
In an earlier module, I told you that from a conceptual viewpoint, there are at least three kinds of objects 
involved in a Java program: 


e Ordinary objects 
e Class objects 
e Array objects 


Ordinary objects 

Most of the discussion up to that point in the collection dealt with what I have referred to in the above 
list as ordinary objects . 

These are the objects that you instantiate in you code by applying the new operator to a constructor 
for a class in order to create a new instance (object) of that class. 

Class objects 

In that module, I emphasized that my discussion of Class objects was conceptual in nature and did 
not necessarily represent an actual implementation. I went on to discuss the class named Class , and 
discussed how the use of that class fits into the grand scheme of OOP in Java. I explained how the existence 
of class variables and class methods tends to complicate the rather simple OOP structure consisting only 
of ordinary objects. 

Array objects 

I haven’t discussed array objects up to this point in this collection. That is the purpose of this module. 

Also tends to complicate 

The existence of array objects also tends to complicate the OOP structure of a Java program consisting 
only of ordinary objects. Even if you don’t consider array objects to be a different kind of object, you must 
at least consider them to be a special kind of object. A completely different syntax is required to create 
array objects than the syntax normally used to instantiate ordinary objects. 

References to array objects 

Arrays are objects in Java (at least, arrays are always encapsulated in objects). Array objects are 
dynamically created. Like ordinary objects, array objects are accessed via references. The reference to an 
array object may be assigned to a reference variable whose type is specified as: 


TypeName [] 


For example, Listing 1 (p. 394) shows some unrelated declarations for variables that are capable of storing 
references to array objects. 


Listing 1 . Sample variable declarations for array objects. 


int[] x1; 
Button[] x2; 


Object[] x3; 


Table 3.98 


Note the empty square brackets that are required in the variable declarations in Listing 1 (p. 394) . 

The special case of type Object 

In addition, a reference to an array object may be assigned to a reference variable of type Object as 
shown in Listing 2 (p. 396) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


393 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


394 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Listing 2 . The special case of type Object. 


Object x4; 


Table 3.99 


Note that there are no square brackets in the statement in Listing 2. 

What does this mean? 

This means that like ordinary objects, a reference to an array object can be treated as type Object 
(with no square brackets). 

This further means that any of the methods defined in the Object class (such as the toString and 
getClass methods) can be called on a reference to an array object. 

The String representation of an array object’s reference 

For example, when the toString method is called on a reference to an array object containing data of 
type int , the resulting string will be similar to the following: 


[1@73d6a5 


Pretty ugly, huh? 

You may recognize this as being similar to the default String returned by calling the toString method 
on an ordinary object with the name of the class for the ordinary object being replaced by [I 

For example, the String returned by calling the toString method on an object of the class named 
Array04 , (with no overridden toString method), looks something like the following. 


Array04073d6a5 


(Note that the hexadecimal numeric values following the @ in both of the above examples will change from 
one case to the next.) 

Calling the getClass method 

Similarly, calling the getClass method on references to arrays containing data of the types Array04 , 
Button ,and int , respectively, and then calling the toString method on the Class objects returned 
by the getClass method, produces the following: 


class [LArray04; 
class [Ljava.awt.Button; 
class [I 


Complicating the OOP structure 

I made the following statement in an earlier paragraph: 

"The existence of array objects also tends to complicate the OOP structure of a Java program consisting 
only of ordinary objects." 

Array object is not a subclass of class Object 

An array object can be treated as type Object for purposes of calling the methods of the Object 
class on the reference to the array object. However, it would probably be misleading to say that an array 
object is instantiated from a subclass of the Object. class. 

The new operator and the constructor name 

Ordinary objects are created by applying the new operator to the constructor for a class, where the 
name of the constructor is always the same as the name of the class. That is not the case with array objects. 
Array objects are created by applying the new operator to the name of the type of data to be encapsulated 
in the array object. 

Passing parameters versus square-bracket notation 
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In addition, whereas the instantiation of ordinary objects involves parameters passed in parentheses, a 
square-bracket notation is used instead of parentheses to create an array object. The value in the square 
brackets specifies the length of the array. 

Creating an array object 

Array objects (with default initialization values) are created by applying the new operator to the 
name of the data type to be stored in the array, using a square-bracket notation. An example is shown by 
the right-hand portion of the first statement in Listing 3 (p. 397) . 


Listing 3 . Creating array objects. 


int[] x1 = new int[5]; 


int[] x2 = {1,2,3,4,5}; 


Table 3.100 


A five-element array object 
The first statement in Listing 3 (p. 397) creates an array object capable of storing five values of type 
int . The statement also assigns the array object’s reference to the newly-declared reference variable named 
x1 
Default initial values 
Each element in the array is initialized to the default value zero. 

(All array elements created in this manner receive a default initial value. Numeric primitive types receive 
an initial value of zero. Elements of type boolean receive an initial value of false . Elements whose type 
is the name of a class or the name of an interface receive an initial value of null .) 

Explicit initialization 

The second statement in Listing 3 (p. 397) also creates an array object capable of storing five values of 
type int , but in this case, the values in the elements are explicitly initialized to the values shown. 

(Note that the new operator is not used in the second statement in Listing 3. This is also a significant 
departure from the syntax used to instantiate ordinary objects.) 

This array object’s reference is assigned to the reference variable named x2 
Note the empty square brackets in the variable declarations 
The syntax of the type specification for the reference variable in each statement in Listing 3 (p. 397) is 

different from the syntax used in the type specification for either a primitive variable or an ordinary class 
type reference variable (note the square brackets on the left in Listing 3) . In Listing 3 (p. 397) , the type 
specifications indicate that each variable is capable of holding a reference to an array object. 

The size of the array 

Furthermore, the empty square brackets (in the declaration of the reference variable) indicate that the 
reference variable doesn’t know (and doesn’t care) about the size of the array to which it may refer. Each of 
the reference variables declared in Listing 3 (p. 397) can refer to a one-dimensional array object of any size. 
Also, each of the reference variables can refer to different array objects at different points in time during the 
execution of the program. 


The Array class As an aside, let me mention that there is a class named Array , which provides 
static methods to dynamically create and access Java arrays. The use of the methods of this 
class makes it possible to handle arrays with a programming style similar to the programming style 
typically used with ordinary objects. However, the use of the methods of the Array class tends 
to require more programming effort than the square-bracket notation discussed in this module. I 
will discuss a sample program that illustrates the methods of the Array class in a future module. 
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Encapsulating a group of variables 

As is the case with other languages that support arrays, array objects in Java encapsulate a group of 
variables. 

Zero or more variables may be encapsulated in an array object. If the number is zero, the array object 
is said to be empty. 

(An example of an empty array object is the String[] array passed to the main method in a Java 
application when the user doesn’t enter any arguments at the command line.) 

No individual names 

Also, as with other languages that support arrays, the variables encapsulated in an array object don’t 
have individual names. Rather, they are referenced using positive integer index values. 

(Typically, in Java, the index is placed in square brackets, which are applied to the name of the reference 
variable holding a reference to the array object.) 

Elements or components? 

It is common in the literature to refer to the variables that make up an array as its elements . However, 
the Java specification refers to them as components. The specification ascribes a different meaning to the 
word element, as shown in the following quotation from the specification: 

"The value of an array component of type float is always an element of the float value set ...; 
similarly, the value of an array component of type double is always an element of the double value 
set." 

Another quotation from Sun (shown later in this module) provides a somewhat clearer distinction 
between the words component and element 

(However, from force of habit, I will probability use component and element interchangeably in this 
module.) 

The length of an array 

If an array has n components, the length of the array is n . The components of the array are 
referenced using integer indices from 0 to (n - 1), inclusive. 

Another quotation from Sun 

Here is another quotation from the Java specification that explains the type specifications for the variable 
declarations in Listing 1 (p. 394) and Listing 3 (p. 397) . 

"All the components of an array have the same type, called the component type of the array. If the 
component type of an array is T, then the type of the array itself is written T[]." 

Components may be of an array type 

As of the time that this object was originally written, all array objects in Java encapsulate one-dimensional 
arrays (I have read that this may change in the future). 

The component type of an array may itself be an array type. This makes it possible to create array 
objects whose individual components refer to other array objects. 

Multi-dimensional or ragged arrays 

One way to think of this is to think of the second level of array objects as being sub-arrays of the original 
array object. This construct can be used to create multi-dimensional array structures. 

(The geometry of such multi-dimensional array structures is not constrained to be rectangles, cubes, 
etc., as is the requirement in many other languages. Some authors may refer to this as ragged arrays.) 

Tree structures 

This process of having the components of an array contain references to sub-arrays can be continued 
indefinitely (well, maybe not indefinitely, but further than I care to contemplate). 

(This can be thought of as a tree structure where each array object containing references to other array 
objects is a node in the tree.) 

The leaves of the tree 

Eventually, the components (the leaves of the tree structure) must refer to a component type that is 
not an array type. According to Sun: 

".. this is called the element type of the original array, and the components at this level of the data 
structure are called the elements of the original array." 
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Component versus element 

Hopefully, the above quotation provides a somewhat clearer distinction between the use of the words 
component and element than was presented earlier. 

Generic references 

The reference to any array object can also be assigned to reference variables of the types Object , 
Cloneable , or Serializable 

( Object is the class at the top of the inheritance hierarchy. Cloneable and Serializable are 
interfaces, which are implemented by all array objects. Thus, a reference to an array object can be treated 
as any of these three types.) 

Generic array objects 

Therefore, if the element type of an array object is one of these types, the elements in the array can refer 
to: 


e Other array objects 
e Ordinary objects 
e A mixture of the two 


This is illustrated in the sample program named Array05 shown in Listing 9 (p. 405) near the end of the 
module. 

Will explain in fragments 

I will explain this program in fragments. Listing 4 (p. 399) shows the beginning of the controlling class 
and the beginning of the main method for the program named Array05 


Listing 4 . The beginning of the class named Array05. 


public class Array05{ 
public static void main(String[] args){ 
int vi = {1,2,3,4,5}; 
Object[] v2 = new Object[2]; 


Table 3.101 


Listing 4 (p. 399) creates two array objects. 

An array of type int 

The first array object is a five-element array of element type int , with the element values initialized as 
shown by the values within the curly brackets. The reference to this array object is assigned to the reference 
variable named vl 

An array of element type Object 

The second array object is a two-element array of element type Object , with each of the element values 
initialized to their default value of null . The reference to the array object is assigned to the reference 
variable named v2 

(Note that unlike the previous discussion of Object , the declaration of the reference variable in this 
case does include empty square brackets. I will have more to say about this later.) 

A new object of this class 

Listing 5 (p. 400) creates a new ordinary object of class Array05 . The code assigns the object’s 
reference to the first element in the array object of element type Object , referred to by the reference 
variable named v2 
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Listing 5 . A new ordinary object of class Array05. 


v2[0] = new Array05(); 


Table 3.102 


This is allowable because the reference to an object of any class can be assigned to a reference variable 
of type Object 
(The array object referred to by v2 contains two elements, each of which is a reference variable of type 
Object .) 
Populate the second element 
The code in Listing 6 (p. 400) assigns the reference to the existing array object of the element type int 
to the second element in the array object of element type Object 


Listing 6 . Populate the second element. 


v2[1] = vi; 


Table 3.103 


This is allowable because a reference to any array object can be assigned to a reference variable of type 
Object 

Array contains two references 

At this point, the array object of element type Object contains two references. 

(Each of the elements in an array of the declared type Object[] is a reference of type Object .) 

The first element refers to an ordinary object of the class Array05 

The second element refers to an array object of type int , having five elements, populated with the 
integer values of 1 through 5 inclusive. 

(Note that this is not a multi-dimensional array in the traditional sense. I will discuss the Java approach 
to such multi-dimensional arrays in the next module. This is simply a generic array of element type Object 
, one element of which happens to contain a reference to an array object of type int .) 

Print some data 

The code in Listing 7 (p. 400) passes each of the references to the println method of the PrintStream 
class. 


Listing 7 . Print some data. 


System. out .println(v2[0]); 
System. out .println(v2[1]); 


Table 3.104 
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The println method causes the toString method to be called on each reference. The String 
returned by the toString method is displayed on the computer screen in each case. 

This is allowable because any method defined in the Object class (including the toString method) 
can be called on any reference stored in a reference variable of type Object 

This is true regardless of whether that reference is a reference to an ordinary object or a reference to an 
array object. 

The output 

Listing 7 (p. 400) causes the following two lines of text to be displayed: 


Array05073d6a5 
[1@111f£71 


Pretty ugly, huh? 
In both cases, this is the value of the String returned by the default version of the toString method 
defined in the Object class. Here is what Sun has to say about that default behavior: 

"Returns a string representation of the object. In general, the toString method returns a string that 
"textually represents" this object. The result should be a concise but informative representation that is easy 
for a person to read. It is recommended that all subclasses override this method. 

The toString method for class Object returns a string consisting of the name of the class of which 
the object is an instance, the at-sign character ‘@’, and the unsigned hexadecimal representation of the hash 
code of the object." 

Doesn’t address array objects 

Obviously, this description of behavior doesn’t address the case where the object is an array object, unless 
the characters [I are considered to be the name of a class. (T will have a little more to say about this 
later.) 

Produce some more output 

Finally, Listing 8 (p. 401) shows the last statement in this simple program. 


Listing 8 . Produce some more output. 


System.out.printin( ( (int[])v2[1] )[4] ); 
}//end main 
}//end class Array05 


Table 3.105 


What does this mean? 

As you can see, the syntax of this statement is pretty ugly. 

Values are accessed from an array object by following the array’s reference with a pair of square brackets 
containing an integer index value as follows: 


v2[1] 


Get the value at index 1 as type Object 

This code begins by accessing the component at index value 1 of the array object referred to by the 
reference variable named v2 

The value retrieved is a reference, and is retrieved as type Object , (because the variable named v2 
was declared to be of type Object] ). 

A cast is required 

A cast is used to convert from type Object[] to type int] using the following code: 
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(int []) 


This produces a reference to an array object capable of containing values of type int 
Apply index to the int array 
After the type of the reference has been converted, the accessor [4] is applied to the reference. This 
causes the int value stored in the array object of type int (at index value 4) to be returned. 
(If you refer back to Listing 4 (p. 399) , you will see that the integer value 5 was stored in the element 
at index value 4 of this array object.) 
You should try to remember this syntax and compare it with the syntax used in the Java approach to 
traditional multi-dimensional arrays, which I will discuss in the next module. 
The output 
Thus, the code in Listing 8 (p. 401) causes the number 5 to be displayed on the computer screen. 
Let’s recap 
To recap, the program named Array05 creates a two-element array object capable of storing references 
of type Object 
Object is generic 
Because Object is a completely generic type, each of the elements in the array is capable of storing a 
reference to any ordinary object, or storing a reference to any array object. 
Store reference to ordinary object in generic array 
The first element in the array is populated with a reference to an ordinary object instantiated from the 
class named Array05 
(Important: The actual object does not occupy the array element. Rather, the actual object exists 
someplace else in memory, and a reference to the object occupies the array element.) 
Store a reference to an array object in the generic array 
The second element in the array of element type Object is populated with a reference to another array 
object capable of containing elements of type int 
As above, the actual array object of type int does not occupy the second element. Rather, that array 
object exists someplace else in memory, and a reference to the array object occupies the second element in 
the array of element type Object 
Display some data 
After the array object of element type Object is created and populated, three print statements are 
executed to display information about the array object and its contents (those print statements are shown 
in Listing 7 (p. 400) and Listing 8 (p. 401) ). 
The print statements produce the following output on the computer screen: 


Array05073d6a5 
[1@111f£71 
5 


Default textual representation of ordinary object 

The first line of output is the default textual representation of the ordinary object, achieved by calling 
the default toString method on the reference to the ordinary object. 

Default textual representation of array object 

The second line of output is the textual representation of the array object of type int[] , achieved by 
calling the default toString method on the reference to the array object. 

Primitive value stored in array object 

The third line of text is the value stored in element index 4 of the int] array object whose reference is 
stored in element index 1 of the array object of element type Object 

Primitive versus non-primitive array element contents 

References to objects are stored in the elements of non-primitive array objects. The objects themselves 
exist somewhere else in memory. 

Actual primitive values are stored in the elements of a primitive array object. 
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Thus, the elements of an array object contain actual primitive values, null references, or actual references 
to ordinary or array objects, depending on the type of the elements of the array object. 


3.2.23.5 Summary 


This module begins the discussion of array objects in Java. 

The existence of array objects tends to complicate the OOP structure of a Java program otherwise 
consisting only of ordinary objects. 

A completely different syntax is required to create array objects than the syntax normally used to 
instantiate ordinary objects. Ordinary objects are normally instantiated by applying the new operator to 
the constructor for the target class passing parameters between a pair of matching parentheses. 

Array objects (with default initialization) are created using the new operator, the type of data to be 
encapsulated in the array, and a square-bracket notation to specify the length of the array encapsulated 
in the object. 

Array objects with explicit initialization are created using a comma-separated list of expressions enclosed 
in curly brackets. 

Arrays in Java are objects, which are dynamically created and allocated to dynamic memory. 

Like ordinary objects, array objects are accessed via references. The type of such a reference is considered 
to be TypeName]] (note the empty square brackets in the type specification). 

A reference to an array object can also be assigned to a reference variable of type Object (note the 
absence of square brackets). Thus, any of the methods of the Object class can be called on a reference 
to an array object. 

As is the case with other languages that support arrays, array objects in Java encapsulate a group of 
zero or more variables. The variables encapsulated in an array object don’t have individual names. Rather, 
they are accessed using positive integer index values. 

The integer indices of a Java array object always extend from 0 to (n-1) where n isthe length 
of the array object. 

As of the time of this writing, all array objects in Java encapsulate one-dimensional arrays. However, the 
component type of an array may itself be an array type. This makes it possible to create array objects whose 
individual components refer to other array objects. This is the mechanism for creating multi-dimensional 
or ragged arrays in Java. 

The reference to any array object can be assigned to reference variables of the types Object , 
Cloneable , or Serializable . If the element type of an array object is one of these types, the elements 
in the array can refer to: 


e Other array objects 
e Ordinary objects 
e A mixture of the two 


3.2.23.6 What’s next? 


This module has barely scratched the surface in explaining how array objects fit into the grand scheme of 
things in OOP using Java. In the next module, I will continue the discussion, showing you some of the 
(often complex) aspects of using Java array objects to emulate traditional multi-dimensional arrays. I will 
also show you how to create ragged arrays in Java. 


3.2.23.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Array Objects, Part 1 
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e File: Javal622.htm 
e Published: 05/15/02 
e Revised: 12/06/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.23.8 Complete program listing 
A complete listing of the program is shown in Listing 9 (p. 405) below. 
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Listing 9 . Complete program listing. 


/*File Array05.java 
Copyright 2002, R.G.Baldwin 


This program illustrates storage of 
references to ordinary objects and 
references to array objects in the 
same array object of type Object. 


Program output is: 


Array05@73d6a5 

[1@111f£71 

5 

FEA I I A I IOI EE EEEE E EEEE EEEE EEEN 


public class Array05{ 
public static void main( 
String[] args) { 


int vi = {1,2,3,4,5}; 
Object[] v2 = new Object[2]; 
v2[0] = new Array05(); 

v2[1] = vi; 


System. out.println(v2[0]); 
System. out.println(v2[1]); 
System. out. print1n( 
(Cint [])v2[1])[4]); 
}//end main 
}//end class Array05 


Table 3.106 
-end- 
3.2.24 Javal622s Slides” 


3.2.24.1 Table of Contents 


e Instructions for viewing slides (p. 405) 
e Miscellaneous (p. 406) 


3.2.24.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Javal622: Array Objects, Part 1 °° . 


®8This content is available online at <http://cnx.org/content /m48930/1.2/>. 
*http://cnx.org/content /m44198 /latest /?collection=col11441/latest 
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Click here 7° to open an index to the slides. 


Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 


window in your browser. 


Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 


slides. 


You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 


the slides in sequence. 


3.2.24.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java1622s Slides: Array Objects, Part 1 
e File: Javal622s.htm 
e Published: 01/17/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.2.25 Javal624: Array Objects, Part 2” 
3.2.25.1 Table of Contents 


Preface (p. 407) 

Viewing tip (p. 407) 

x Listings (p. 407) 

Preview (p. 407) 
Discussion and sample code (p. 407) 
Summary (p. 425) 
What’s next? (p. 426) 
Miscellaneous (p. 426) 
Complete program listing (p. 426) 


“Ohttp://cnx.org/content /m48930/latest /a0-Index.htm 
“1 This content is available online at <http://cnx.org/content/m44199/1.4/>. 
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3.2.25.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 


3.2.25.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


3.2.25.2.1.1 Listings 


e Listing 1 (p. 408) . Reference variable declaration.. 

e Listing 2 (p. 409) . A three-dimensional array object of element type Button. 
e Listing 3 (p. 409) . The generic class Object. 

e Listing 4 (p. 409) . Primitive type conversions. 

e Listing 5 (p. 410) . Initialization. 

e Listing 6 (p. 411) . Placement of square brackets. 

e Listing 7 (p. 411) . Creating the actual array object. 

e Listing 8 (p. 412) . An array access expression. 

e Listing 9 (p. 413) . Explicit initialization of array elements. 

e Listing 10 (p. 414) . Create a two-dimensional rectangular array structure. 

e Listing 11 (p. 415) . Using length to populate the leaves of the tree structure. 
e Listing 12 (p. 416) . Display leaf object contents. 

e Listing 13 (p. 417) . Beginning of a ragged array with two rows and three columns. 
e Listing 14 (p. 417) . Create the leaf array objects. 

e Listing 15 (p. 418) . Create the array object. 

e Listing 16 (p. 419) . Populate the root object. 

e Listing 17 (p. 419) . Populate the leaf array objects. 

e Listing 18 (p. 420) . Display data in leaf array objects. 

e Listing 19 (p. 421) . A triangular array. 

e Listing 20 (p. 421) . Populate the leaf array objects. 

e Listing 21 (p. 422) . A more general approach. 

e Listing 22 (p. 423) . Populate the leaf objects. 

e Listing 23 (p. 424) . Beginning of a more general case. 

e Listing 24 (p. 424) . Populate the leaf array elements. 

e Listing 25 (p. 424) . Display the output. 

e Listing 26 (p. 427) . Complete program listing. 


3.2.25.3 Preview 


This module explains various details regarding the use of array objects in Java, and illustrates many of those 
details through the use of sample code. 

A sample program shows you three ways to emulate traditional two-dimensional rectangular arrays, and 
also shows you how to create and use ragged arrays. 


3.2.25.4 Discussion and sample code 


Array objects 

A different syntax is required to create array objects than the syntax normally used to create ordinary 
objects. 

Array objects are accessed via references. 
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Any of the methods of the Object class can be called on a reference to an array object. 

The indices of a Java array object 

Array objects encapsulate a group of variables, which don’t have individual names. They are accessed 
using positive integer index values. The integer indices of a Java array object always extend from 0 to 
(n-1) where n isthe length of the array encapsulated in the object. 

Multidimensional arrays 

Array objects in Java encapsulate one-dimensional arrays. However, the component type of an array may 
itself be an array type. This makes it possible to create array objects whose individual components refer to 
other array objects. This is the mechanism for creating multi-dimensional or ragged arrays in Java. 

Such a structure of array objects can be thought of as a tree of array objects, with the data being stored 
in the array objects that make up the leaves of the tree. 

Array types 

When declaring a reference variable capable of referring to an array object, the array type is declared 
by writing the name of an element type followed by some number of empty pairs of square brackets ||. This 
is illustrated in Listing 1 (p. 408) , which declares a reference variable named v1 , capable of storing a 
reference to a two-dimensional array of type int 


Listing 1 . Reference variable declaration. 


int[] [] v1; 


Table 3.107 


(Note that Listing 1 doesn’t really declare a two-dimensional array in the traditional sense of other 
programming languages. Rather, it declares a reference variable capable of storing a reference to a one- 
dimensional array object, which in turn is capable of storing references to one-dimensional array objects of 
type int .) 

Multiple pairs of square brackets are allowed 

The components in an array object may refer to other array objects. The number of bracket pairs used 
in the declaration of the reference variable indicates the depth of array nesting (in the sense that array 
elements can refer to other array objects). This is one of the ways that Java implements the concept of 
traditional multi-dimensional arrays (I will show you some other ways later in this module). 

The code in Listing 1 shows two levels of nesting for the reference variable of type 


int [0 0 


Length not part of variable declaration 

Note that an array’s length is not part of its type or reference variable declaration. 

Ragged arrays 

Note also that multi-dimensional arrays, when implemented in this fashion, are not required to represent 
rectangles, cubes, etc. For example, the number of elements in each row of a Java two-dimensional array 
can be different. Some authors refer to this as a ragged array 

Allowable types 

The specified element type of an array may be any primitive or reference type. Note, however, that all 
elements of the array must be of the same type (consistent with the type-conversion rules discussed below) 


Listing 2 (p. 409) shows the declaration of a reference variable capable of referring to a three -dimensional 
array object of element type Button ( Button is one of the classes in the standard class library). 
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Listing 2 . A three-dimensional array object of element type Button. 


Button ĝD 0O O v2; 


Table 3.108 


Rules of type conversion and assignment compatibility apply 

The normal rules of type conversion and assignment compatibility apply when creating and populating 
array objects. For example, if the specified type is the name of a non-abstract class, a null reference or a 
reference to any object instantiated from that class or any subclass of that class may be stored in the array 
element. 

The generic class Object 

For example, Listing 3 (p. 409) shows the declaration of a reference variable capable of referring to a 
one-dimensional array object of element type Object 

Since Object is the superclass of all other classes, this array object is capable of storing references to 
objects instantiated from any other class. (As we saw in the previous module, it is also capable of storing 
a reference to any other array object as well.) 


Listing 3 . The generic class Object. 


Object[] v3; 


Table 3.109 


Primitive type conversions 

Similarly, if the declared element type for the array object is one of the primitive types, the elements of 
the array can be used to store values of any primitive type that is assignment compatible with the declared 
type (without the requirement for a cast). 

For example, the code in Listing 4 (p. 409) shows the creation of a one-dimensional array object capable 
of storing values of type int . The array object has a length of 3 elements, and the object’s reference is 
stored in a reference variable named v1 


Listing 4 . Primitive type conversions. 


int{] vi; 

vi = new int[3]; 
byte x1 = 127; 
short x2 = 16384; 
int x3 = 32000; 


vifO] = x1; 
vili] = x2; 
vil[2] = x3; 


Table 3.110 
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Assignment-compatible assignments 

Values of the types byte , short , and int , are stored in the elements of the array object in Listing 
4 (p. 409) . 

Actual type is lost in the process 

It should be noted that the byte and short values are converted to type int as they are stored. 
When retrieved later, they will be retrieved as type int . Any indication that these values were ever of any 
type other than int is lost in the process of storing and retrieving the values. 

What about class types? 

If the declared element type is the name of a class, (which may or may not be abstract), a null reference 
or a reference to any object instantiated from the class or any subclass of the class may be stored in the 
array element. 

(Obviously you can’t store a reference to an object instantiated from an abstract class, because you can’t 
instantiate an abstract class.) 
What about an interface type? 

If the declared element type is an interface type, a null reference or a reference to any object instantiated 
from any class that implements the interface can be stored in the array element. 

(This is an extremely powerful concept, allowing references to objects instantiated from many different 
classes to be collected into an array as the interface type.) 
Array reference variables 

All array objects are accessed via references. A reference variable whose declared type is an array type 

does not contain an array. Rather, it contains either null, or a reference to an array object. 
Allocation of memory 

Declaring the reference variable does not create an array, nor does it allocate any space for the array 
components. It simply causes memory to be allocated for the reference variable itself, which may later 
contain a reference to an array object. 

Initialization 

In the same sense that it is possible to declare a reference variable for an ordinary object, and initialize it 
with a reference to an object when it is declared, it is also possible to declare a reference to an array object 
and initialize it with a reference to an array object when it is declared. This is illustrated in Listing 5 (p. 
410) , which shows the following operations combined into a single statement: 


e Declaration of a variable to contain a reference to an array object 
e Creation of the array object 
e Storage of the array object’s reference in the reference variable 


Listing 5 . Initialization. 


int[] vi = new int[3]; 


Table 3.111 


Can refer to different array objects 

The length of an array is not established when the reference variable is declared. As with references 
to ordinary objects, a reference to an array object can refer to different array objects at different points in 
the execution of a program. 

For example, a reference variable that is capable of referring to an array of type int[] can refer to an 
array object of a given length at one point in the program and can refer to a different array object of the 
same type but a different length later in the program. 

Placement of square brackets 
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When declaring an array reference variable, the square brackets || may appear as part of the type, or 
following the variable name, or both. This is illustrated in Listing 6 (p. 411) . 


Listing 6 . Placement of square brackets. 


int[] [] v1; 
intO] v2[]; 
int v30 0; 


Table 3.112 


Type and length 

Once an array object is created, its type and length never changes. A reference to a different array object 
must be assigned to the reference variable to cause the reference variable to refer to an array of different 
length. 

Creating the actual array object 

An array object is created by an array creation expression or an array initializer. 

An array creation expression (or an array initializer) specifies: 


e The element type 
e The number of levels of nested arrays 
e The length of the array for at least one of the levels of nesting 


Two valid array creation expressions are illustrated by the statements in Listing 7 (p. 411) . 


Listing 7 . Creating the actual array object. 


int[] [] v1; 
int] v2[]; 


vi 
v2 


new int [2] [3]; 
new int[10][]; 


Table 3.113 


A two-dimensional rectangular array 

The third statement in Listing 7 (p. 411) creates an array object of element type int with two levels of 
nesting. This array object can be thought of as a traditional two-dimensional rectangular array having two 
rows and three columns. (This is a somewhat arbitrary choice as to which dimension specifies the number 
of rows and which dimension specifies the number of columns. You may prefer to reverse the two.) 

A ragged array 

The fourth statement also creates an array object of element type int with two levels of nesting. 
However, the number of elements in each column is not specified at this point, and it is not appropriate to 
think of this as a two-dimensional rectangular array. In fact, once the number of elements in each column 
has been specified, it may not describe a rectangle at all. Some authors refer to an array of this type as a 
ragged array. 
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The length of the array 

The length of the array is always available as a final instance variable named length . I will show 
you how to use the value of length in a sample program later in this module. 

Accessing array elements 

An array element is accessed by an array access expression . The access expression consists of an 
expression whose value is an array reference followed by an indexing expression enclosed by matching square 
brackets. 

The expression in parentheses in Listing 8 (p. 412) illustrates an array access expression (or perhaps 
two concatenated array access expressions). 


Listing 8 . An array access expression. 


int[] [] vi = new int[2][3]; 
System. out .print1n(v1[0] [1]); 


Table 3.114 


First-level access 
This array access expression first accesses the contents of the element at index 0 in the array object 
referred to by the reference variable named v1 . This element contains a reference to a second array object 
(note the double matching square brackets, |||] in the declaration of the variable named v1 ). 
Second-level access 
The array access expression in Listing 8 (p. 412) uses that reference to access the value stored in the 
element at index value 1 in the second array object. That value is then passed to the println method for 
display on the standard output device. 
(In this case, the value 0 is displayed, because array elements are automatically initialized to default 
values when the array object is created. The default value for all primitive numeric values is zero.) 
Zero-based indexing 
All array indexes in Java begin with O . An array with length n can be indexed by the integers 0 to 
(n-1) . Array accesses are checked at runtime. If an attempt is made to access the array with any other 
index value, an ArrayIndexOutOfBoundsException will be thrown. 
Index value types 
Arrays must be indexed by integer values of the following types: int , short , byte ,or char 
For any of these types other than int , the value will be promoted to an int and used as the index. 
An array cannot be accessed using an index of type long . Attempting to do so results in a compiler 
error. 
Default initialization 
If the elements in an array are not purposely initialized when the array is created, the array elements 
will be automatically initialized with default values. The default values are: 


All reference types: null 

Primitive numeric types: 0 

Primitive boolean type: false 

Primitive char type: the Unicode character with 16 zero-valued bits 


Explicit initialization of array elements 

The values in the array elements may be purposely initialized when the array object is created using a 
comma-separated list of expressions enclosed by matching curly brackets. This is illustrated in Listing 9 (p. 
413) . 
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Listing 9 . Explicit initialization of array elements. 


int[] vi = {1,2,3,4,5}; 


Table 3.115 


No new operator 

Note that this format does not use the new operator. Also note that the expressions in the list may 

be much more complex than the simple literal values shown in Listing 9 (p. 413) . 
Length and order 

When this format is used, the length of the constructed array will equal the number of expressions in the 
list. 

The expressions in an array initializer are executed from left to right in the order that they occur in the 
source code. The first expression specifies the value at index value zero, and the last expression specifies the 
value at index value n-1 (where n is the length of the array). 

Each expression must be assignment-compatible with the array’s component type, or a compiler error 
will occur. 

A sample program 

The previous paragraphs in this module have explained some of the rules and characteristics regarding 

array objects. They have also illustrated some of the syntax involved in the use of array objects in Java. 
More powerful and complex 

Many aspiring Java programmers find the use of array objects to be something less than straightforward, 
and that is understandable. In fact, Java array objects are somewhat more powerful than array structures 
in many other programming languages, and this power often manifests itself in additional complexity. 

A traditional two-dimensional rectangular array 

Some of that complexity is illustrated by the program named Array07_ , shown in Listing 26 (p. 427) 
near the end of this module. This program illustrates three different ways to accomplish essentially the same 
task using array objects in Java. That task is to emulate a traditional two-dimensional rectangular array as 
found in other programming languages. Two of the ways that are illustrated are essentially ragged arrays 
with sub-arrays having equal length. 

Ragged arrays 
The program also illustrates two different ways to work with array objects and ragged arrays. 
Will discuss in fragments 

As is my practice, I will discuss and explain the program in fragments. 

All of the interesting code in this program is contained inthe main method, so I will begin my discussion 
with the first statement in the main method. 

Create a two-dimensional rectangular array structure 

Listing 10 (p. 414) creates an array structure that emulates a traditional rectangular array with two rows 

and three columns. 


Listing 10 . Create a two-dimensional rectangular array structure. 


Object[][] vi = new Object[2] [3]; 


Table 3.116 
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(Note that unlike the ragged array structures to be discussed later, this approach requires all rows to be 
the same length and all columns to be the same length.) 

Reference variable declaration 

The code to the left of the equal sign (=) in Listing 10 (p. 414) declares a reference variable named 
v1 . This reference variable is capable of holding a reference to an array object whose elements are of the 
type Object]] .. 

In other words, this reference variable is capable of 


e holding a reference to an array object, 
e whose elements are capable of holding references to other array objects, 
e whose elements are of type Object 


Two levels of nesting 

The existence of double matching square brackets in the variable declaration in Listing 10 (p. 414) 

indicates two levels of nesting. 
Restrictions 

The elements in the array object referred to by v1 can only hold references to other array objects whose 
element type is Object (or references to array objects whose element type is a subclass of Object ). 

The elements in the array object referred to by v1 cannot hold references to ordinary objects instantiated 
from classes, or array objects whose element type is a primitive type. 

In other words, the elements in the array object referred to by v1 can only hold references to other 
array objects. The element types of those array objects must be assignment compatible with the type 
Object (this includes interface types and class types but not primitive types). 

A tree of empty array objects 

The code to the right of the equal sign (=) in Listing 10 (p. 414) creates a tree structure of array 
objects. The object at the root of the tree is an array object of type Object[] , having two elements (a 
length of two). 

The reference variable named v1 refers to the array object that forms the root of the tree. 

Each of the two elements in the root array object is initialized with a reference to another array object. 

(These two objects might be viewed as sub-arrays, or as child nodes in the tree structure). 

Each of the child nodes is an array object of type Object ,,and has a length of three. 

Each element in each of the two child node array objects is initialized to the value null (this is the 
default initialization for array elements of reference types that don’t yet refer to an object). 

Recap 

To recap, the reference variable named v1 contains a reference to a two-element, one-dimensional array 
object. Each element in that array object is capable of storing a reference of type Object[] (a reference 
to another one-dimensional array object of type Object ). 

Two sub-array objects 

Two such one-dimensional sub-array (or child node) objects, of element type Object , are created. 
References to the two sub-array objects are stored in the elements of the two-element array object at the 
root of the tree. 

Each of the sub-array objects has three elements. Each element is capable of storing a reference to an 
object as type Object 

The leaves of the tree 

These two sub-array objects might be viewed as the leaves of the tree structure. 

Initialize elements to null 

However, the objects of type Object don’t exist yet. Therefore, each element in each of the sub-array 
objects is automatically initialized to null 

Arrays versus sub-arrays 

Note that there is no essential difference between an array object and a sub-array object in the above 
discussion. The use of the sub prefix is used to indicate that an ordinary array object belongs to another 
array object, because the reference to the sub-array object is stored in an element of the owner object. 
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Many dimensions are possible 

Multi-dimensional arrays of any (reasonable) depth can be emulated in this manner. An array object 
may contain references to other array objects, which may contain references to other array objects, and so 
on. 

The leaves of the tree structure 

Eventually, however, the elements of the leaves in the tree structure must be specified to contain either 
primitive values or references to ordinary objects. This is where the data is actually stored. 

(Note however, that if the leaves are specified to contain references of type Object , they may contain 
references to other array objects of any type, and the actual data could be stored in those array objects.) 

The length of an array 

Every array object contains a public final instance variable named length , which contains an integer 
value specifying the number of elements in the array. 

Once created, the length of the array encapsulated in an array object cannot change. Therefore, the 
value of length specifies the length of the array throughout the lifetime of the array object. 

Using length to populate the leaves of the tree structure 

The value of length is very handy when processing array objects. This is illustrated in Listing 11 (p. 
415) , which uses a nested for loop to populate the elements in the leaves of the tree structure referred to 
by v1 . (The elements in the leaf objects are populated with references to objects of type Integer .) 


Listing 11 . Using length to populate the leaves of the tree structure. 


for(int i=0;i<vi.length;i++){ 
for(int j=0;j<vi[i].length; j++) { 
vi[i][j] = 
new Integer((it1)*(jt+1)); 
}//end inner loop 
}//end outer loop 


Table 3.117 


Using length in loop’s conditional expressions 

Hopefully by now you can read and understand this code without a lot of help from me. I will point out, 
however, that the value returned by vi.length (in the conditional expression for the outer loop) is the 
number of leaves in the tree structure (this tree structure has two leaves). 

I will also point out that the value returned by vi1[i].length (in the conditional expression for the 
inner loop) is the number of elements in each leaf array object (each leaf object in this tree structure has 
three elements). 

Finally, I will point out that the expression v1[il][j] accesses the jth element inthe ith leaf, or 
sub-array. In the traditional sense of a rectangular array, this could be thought of as the jth column of 
the ith row. This mechanism is used to store object references in each element of each of the leaf array 
objects. 

Populate with references to Integer objects 

Thus, each element in each leaf array object is populated with a reference to an object of the type 
Integer . Each object of the type Integer encapsulates an int value calculated from the current values 
of the two loop counters. 

Display leaf object contents 

In a similar manner, the code in Listing 12 (p. 416) uses the length values in the conditional expressions 

of nested for loops to access the references stored in the elements of the leaf array objects, and to use 
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those references to access and display the values encapsulated in the Integer objects whose references are 
stored in those elements. 


Listing 12 . Display leaf object contents. 


for(int i=0;i<vi.length;i++){ 
for(int j=0;j<vi[i].length; j++) { 
System. out.print ( 
vi[i] [j] +" "); 
}//end inner loop 
System.out.println();//new line 
}//end outer loop 


Table 3.118 


The rectangular output 
The code in Listing 12 (p. 416) produces the following output on the screen. 


123 
246 


As you can see, this emulates a traditional two-dimensional array having two rows and three columns. 

A ragged array with two rows and three columns 

The second approach to emulating a traditional two-dimensional rectangular array will create a ragged 
array where each row is the same length. 

(It is very important to note that, unlike this case, with a ragged array, the number of elements in each 

row or the number of elements in each column can be different.) 

The most significant thing about this approach is the manner in which the tree of array objects is created 
(see Listing 13 (p. 417) ). 


Listing 13 . Beginning of a ragged array with two rows and three columns. 


Object [] [] v2 = new Object[2][]; 


Table 3.119 


Three statements required 
With this approach, three statements are required to replace one statement from the previous approach. 
(Two additional statements are shown in Listing 14 (p. 417) .) 

A single statement in the previous approach ( Listing 10 (p. 414) ) created all three array objects 
required to construct the tree of array objects, and initialized the elements in the leaf array objects with 
null values. 

Create only the root array object 

However, the boldface code in Listing 13 (p. 417) creates only the array object at the root of the tree. 

That array object is an array object having two elements capable of storing references of type Object] . 
Empty square brackets 
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If you compare this statement with the statement in Listing 10 (p. 414) , you will notice that the right- 
most pair of square brackets in Listing 13 (p. 417) is empty. Thus, Listing 13 (p. 417) creates only the array 
object at the root of the tree, and initializes the elements in that array object with null values. 

Leaf array objects don’t exist yet 

The leaf array objects don’t exist at the completion of execution of the statement in Listing 13 (p. 417) . 
Create the leaf array objects 

The statements in Listing 14 (p. 417) create two array objects of element type Object 


Listing 14 . Create the leaf array objects. 


v2[0] 
v2[1] 


new Object([3]; 
new Object([3]; 


Table 3.120 


Save the references to the leaves 
References to these two leaf objects are stored in the elements of the array object at the root of the tree, 
(which was created in Listing 13 (p. 417) ). Thus, these two array objects become the leaves of the tree 

structure of array objects. 

This completes the construction of the tree structure. Each element in each leaf object is initialized with 
null 

Why bother? 

You might ask why I would bother to use this approach, which requires three statements in place of only 
one statement in the previous approach. 

The answer is that I wouldn’t normally use this approach if my objective were to emulate a traditional 
rectangular array. However, this approach is somewhat more powerful than the previous approach. 

The lengths of the leaf objects can differ 

With this approach, the length values of the two leaf array objects need not be the same. Although I 
caused the length value of the leaf objects to be the same in this case, I could just as easily have caused 
them to be different lengths (I will illustrate this capability later in the program). 

Populate and display the data 

If you examine the complete program in Listing 26 (p. 427) near the end of the module, you will see that 
nested for loops, along with the value of length was used to populate and display the contents of the 
leaf array objects. Since that portion of the code is the same as with the previous approach, I won’t show 
and discuss it here. 

The rectangular output 

This approach produced the following output on the screen, (which is the same as before): 


123 
246 


Now for something really different 

The next approach that I am going to show you for emulating a two-dimensional rectangular array is 
significantly different from either of the previous two approaches. 

Not element type Object]| 

In this approach, I will create a one-dimensional array object of element type Object (not element 
type Object]] ) . I will populate the elements of that array object with references to other array objects 
of element type Object . In doing so, I will create a tree structure similar to those discussed above. 

The length of the leaf objects 
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As with the second approach above, the array objects that make up the leaves of the tree can be any 
length, but I will make them the same length in order to emulate a traditional rectangular two-dimensional 
array. 

Create the array object 

First consider the statement shown in Listing 15 (p. 418) . Compare this statement with the statements 

shown earlier in Listing 10 (p. 414) and Listing 13 (p. 417) . 


Listing 15 . Create the array object. 


Object[] v3 = new Object[2]; 


Table 3.121 


No double square brackets 

Note in particular that the statement in Listing 15 (p. 418) does not make use of double square brackets, 
as was the case in Listing 10 (p. 414) and Listing 13 (p. 417) . Thus, the statement show in Listing 15 (p. 
418) is entirely different from the statements shown in Listing 10 (p. 414) and Listing 13 (p. 417) . 

Declare a reference variable 

That portion of the statement to the left of the equal sign (=) declares a reference variable capable of 
storing a reference to an array object whose elements are capable of storing references of the type Object 
(not type Object]] as in the previous examples). 

Refer to the root object 

This reference variable will refer to an array object that forms the root of the tree structure. However, 
the root object in this case will be considerably different from the root objects in the previous two cases. 

In the previous two cases, the elements of the root object were required to store references of type 
Object|| (note the square brackets). In other words, an array object whose elements are of type 
Object]] can only store references to other array objects whose elements are of type Object 

A more general approach 

However, an array object whose elements are of type Object (as is the case here), can store: 


e References to any object instantiated from any class 
e References to array objects whose elements are of any type (primitive or reference) 
e A mixture of the two kinds of references 


Therefore, this is a much more general, and much more powerful approach. 

A price to pay 

However, there is a price to pay for the increased generality and power. In particular, the programmer who 
uses this approach must have a much better understanding of Java object-oriented programming concepts 
than the programmer who uses the two approaches discussed earlier in this module. 

Particularly true relative to first approach 

This is particularly true relative to the first approach discussed earlier. That approach is sufficiently 
similar to the use of multi-dimensional arrays in other languages that a programmer with little understanding 
of Java object-oriented programming concepts can probably muddle through the syntax based on prior 
knowledge. However, it is unlikely that a programmer could muddle through this approach without really 
understanding what she is doing. 

Won’t illustrate true power 

Although this approach is very general and very powerful, this sample program won’t attempt to illustrate 
that power and generality. Rather, this sample program will use this approach to emulate a traditional two- 
dimensional rectangular array just like the first two approaches discussed earlier. (Later, I will also use this 
approach for a couple of ragged arrays.) 
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Populate the root object 

The two statements in Listing 16 (p. 419) create two array objects, each having three elements. Each 
element is capable of storing a reference to any object that is assignment compatible with the Object 
type. 

(Assignment compatibility includes a reference to any object instantiated from any class, or a reference 
to any array object of any type (including primitive types), or a mixture of the two.) 


Listing 16 . Populate the root object. 


v3[0] 
v3[1] 


new Object([3]; 
new Object(3]; 


Table 3.122 


References to the two new array objects are stored in the elements of the array object that forms the 
root of the tree structure. The two new array objects form the leaves of the tree structure. 

Populate the leaf array objects 

As in the previous two cases, the code in Listing 17 (p. 419) uses nested for loops to populate the array 
elements in the leaf objects with references to new Integer objects. (The Integer objects encapsulate 
int values based on the loop counter values for the outer and inner loops.) 


Listing 17 . Populate the leaf array objects. 


for(int i=0;i<v3.length;i++){ 
for(int j=0;j<((Object[])v3[i]) .length; j++) { 
((Object[])v3[i])[j] = new Integer((it1)*(j+1)); 
}//end inner loop 
}//end outer loop 


Table 3.123 


Added complexity 
The added complexity of this approach manifests itself in 


e The cast operators shown in boldface Italics in Listing 17 (p. 419) 
e The attendant required grouping of terms within parentheses 


Inside and outside the parentheses 

Note that within the inner loop, one of the square-bracket accessor expressions is inside the parentheses 
and the other is outside the parentheses. 

Why are the casts necessary? 

The casts are necessary to convert the references retrieved from the array elements from type Object 
to type Object|] . For example, the reference stored in v3[i] is stored as type Object 

Get length of leaf array object 

The cast in the following expression converts that reference to type Object|] before attempting to get 

the value of length belonging to the array object whose reference is stored there. 
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((Object [])v3[i]) .length 


Assign a value to an element in the leaf array object 
Similarly, the following expression converts the reference stored in v3[i] from type Object to type 
Object|| . Having made the conversion, it then accesses the jth element of the array object whose 
reference is stored there (in order to assign a value to that element). 


((Object [])v3il) [j]= 


Display data in leaf array objects 
Listing 18 (p. 420) uses similar casts to get and display the values encapsulated in the Integer objects 
whose references are stored in the elements of the leaf array objects. 


Listing 18 . Display data in leaf array objects. 


for(int i=0;i<v3.length;i++){ 
for(int j=0;j<((Object[])v3[i]) .length; j++) { 
System. out . print (((0bject[])v3[i]) [j] + " "); 
}//end inner loop 
System.out.println();//new line 
}//end outer loop 


Table 3.124 


The rectangular output 
This approach produced the following output on the screen, (which is the same as the previous two 
approaches): 


123 
246 


Ragged arrays 

All the code in the previous three cases has been used to emulate a traditional rectangular two-dimensional 
array. In the first case, each row was required to have the same number of elements by the syntax used to 
create the tree of array objects. 

In the second and third cases, each row was not required to have the same number of elements, but they 
were programmed to have the same number of elements in order to emulate a rectangular two-dimensional 
array. 

A triangular array, sort of ... 

Now I am going to show you some cases that take advantage of the ragged-array capability of Java 
array objects. In the next case, (beginning with Listing 19 (p. 421) ), I will create a ragged array having 
two rows. The first row will have two elements and the second row will have three elements. (This array 
object might be thought of as being sort of triangular.) 


Listing 19 . A triangular array. 


Object[][] v4 = new Object [2] (1; 
v4[0] = new Object[2]; 
v4[1] = new Object[3]; 
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Table 3.125 


You have seen this before 

You saw code like this in the second case discussed earlier. However, in that case, the second and third 
statements created new array objects having the same length. In this case, the second and third statements 
create array objects having different lengths. This is one of the ways to create a ragged array in Java (you 
will see another way in the next case that I will discuss). 

Populate the leaf array objects 

Listing 20 (p. 421) populates the elements of the leaf array objects with references to objects of the class 
Integer 


Listing 20 . Populate the leaf array objects. 


for(int i=0;i<v4.length;i++){ 
for(int j=0;j<v4[i].length; j++) { 
v4[i][j] = 
new Integer ((i+1)*(j+1)); 
}//end inner loop 
}//end outer loop 


Table 3.126 


You have seen this before also 

You have also seen the code in Listing 20 (p. 421) before. I repeated it here because this case clearly 
emphasizes the value of the length constant that is available in all Java array objects. In the earlier case, 
the length of the two leaf array objects was the same, so it would have been feasible to simply hard-code 
that value into the conditional expression of the inner for loop. 

The length is not the same now 

However, in this case, the length of the two leaf array objects is not the same. Therefore, it wouldn’t 
work to hard-code a limit into the conditional expression of the inner for loop. However, because the 
length of each leaf array object is available as a public member of the array object, that value can be used 
to control the number of iterations of the inner loop for each separate leaf array object. 

The triangular output 

The next section of code in the program shown in Listing 26 (p. 427) near the end of the module uses 
the same code as before to display the int values encapsulated in the Integer objects whose references 
are stored in the leaf array objects. Since it is the same code as before, I won’t repeat it here. 

The output produced by this case is shown below: 


12 
246 


Note that this is not the same as before, and this output does not describe a rectangular array. Rather, it 
describes a ragged array where the rows are of different lengths. 
(As I indicated earlier, it is sort of triangular. However, it could be any shape that you might want it 

to be.) 

A more general approach 

The next case, shown in Listing 21 (p. 422) , is the same as the third case discussed earlier, except that 
the lengths of the leaf array objects are not the same. 

As before, this case creates a one-dimensional array object of type Object (having two elements) that 
forms the root of a tree. Each element in the root object contains a reference to another array object of type 
Object 
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One of those leaf objects has two elements and the other has three elements, thus producing a ragged 
array (you could make the lengths of those objects anything that you want them to be). 


Listing 21 . A more general approach. 


Object[] v5 = new Object[2]; 
v5[0] = new Object[2]; 
v5[1] = new Object[3]; 


Table 3.127 


Populate the leaf objects 
As before, the elements in the leaf array objects are populated with references to objects of the class 


Integer , which encapsulate int values based on the current value of the loop counters. This is shown in 
Listing 22 (p. 423) . 


Listing 22 . Populate the leaf objects. 


for(int i=0;i<v5.length;i++){ 
for(int j=0; 
j<((Object[])v5[il) .length; 
j++){ 
((0bject [])v5[i]) [j] = 
new Integer((i+1)*(j+1)); 
}//end inner loop 
}//end outer loop 


Table 3.128 


Same code as before 


This is the same code that you saw in Listing 17 (p. 419) . I repeated it here to emphasize the requirement 
for casting . 


Display the data 
This case uses the same code as Listing 18 (p. 420) to display the int values encapsulated by the 


Integer objects whose references are stored in the elements of the leaf array objects. I won’t repeat that 
code here. 


The triangular output 
The output produced by this case is shown below: 


12 
246 


Note that this is the same as the case immediately prior to this one. Again, it does not describe a rectangular 
array. Rather, it describes a ragged array where the rows are of different lengths. 

A more general case 

I’m going to show you one more general case for a ragged array. This case illustrates a more general 
approach. In this case, I will create a one-dimensional array object of element type Object . I will populate 
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the elements of that array object with references to other array objects. These array objects will be the 
leaves of the tree. 

Leaf array objects are type int 

In this case, the leaves won’t be of element type Object . Rather, the elements in the leaf objects will 
be designed to store primitive int values. 

(An even more general case would be to populate the elements of the root object with references to 

a mixture of objects of class types, interface types, and array objects where the elements of the array 
objects are designed to store primitives of different types, and references of different types. Note, however, 
each leaf array object must be designed to store a single type, but will accept for storage any type that is 
assignment-compatible with the specified type for the array object.) 

This case begins in Listing 23 (p. 424) , which creates the root array object, and populates its elements 
with references to leaf array objects of type int 


Listing 23 . Beginning of a more general case 


Object[] v6 = new Object[2]; 
v6[0] = new int[7]; 
v6[1] = new int[3]; 


Table 3.129 


Leaf objects are different lengths 

One of the leaf array objects has a length of 7. The other has a length of 3. 

Populate the leaf array elements 

Listing 24 (p. 424) populates the elements in the leaf array objects with values of type int 


Listing 24 . Populate the leaf array elements. 


for(int i=0;i<v6.length;i++) { 
for(int j=0;j<((int[])v6[i]).length; j++) { 
(Cint[])v6[i]) [j] = (41+2)*(j+2); 
}//end inner loop 
}//end outer loop 


Table 3.130 


Similar to previous code 
The code in Listing 24 (p. 424) is similar to code that you saw earlier. The differences are: 


e Cast is to type intl] instead of object]| 
e Values assigned are type int instead of references to Integer objects 


Display the output 
Finally, Listing 25 (p. 424) displays the int values stored in the elements of the leaf array objects. 
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Listing 25 . Display the output. 


for(int i=0;i<v6.length;it++){ 
for(int j=0;j<((int[])v6[i]) .length; j++) { 
System. out.print (( (int [] 


Table 3.131 


The code in Listing 25 (p. 424) is very similar to what you have seen before, and there should be no 
requirement for an explanation of this code. 
The code in Listing 25 (p. 424) produces the following output: 


468 10 12 14 16 
6 9 12 


I will leave it as an exercise for the student to correlate the output with the code. 


3.2.25.5 Summary 


When declaring a reference variable capable of referring to an array object, the array type is declared by 
writing the name of an element type followed by some number of empty pairs of square brackets |]. 

The components in an array object may refer to other array objects. The number of bracket pairs used 
in the declaration of the reference variable indicates the depth of array nesting (in the sense that array 
elements can refer to other array objects). 

An array’s length is not part of its type or reference variable declaration. 

Multi-dimensional arrays are not required to represent rectangles, cubes, etc. They can be ragged. 

The normal rules of type conversion and assignment compatibility apply when creating and populating 
array objects. 

Object is the superclass of all other classes. Therefore, an array of element type Object is capable 
of storing references to objects instantiated from any other class. The type declaration for such an array 
object would be Object] . 

An array of element type Object is also capable of storing references to any other array object. 

If the declared element type for the array object is one of the primitive types, the elements of the array 
can be used to store values of any primitive type that is assignment compatible with the declared type 
(without the requirement for a cast). 

If the declared element type is the name of a class, (which may or may not be abstract), a null reference 
or a reference to any object instantiated from the class or any subclass of the class may be stored in the 
array element. 

If the declared element type is an interface type, a null reference or a reference to any object instantiated 
from any class that implements the interface can be stored in the array element. 

A reference variable whose declared type is an array type does not contain an array. Rather, it contains 
either null, or a reference to an array object. Declaring the reference variable does not create an array, nor 
does it allocate any space for the array components. 

It is possible to declare a reference to an array object and initialize it with a reference to an array object 
when it is declared. 

A reference to an array object can refer to different array objects (of the same element type and different 
lengths) at different points in the execution of a program. 

When declaring an array reference variable, the square brackets || may appear as part of the type, or 
following the variable name, or both. 

Once an array object is created, its type and length never changes. 

An array object is created by an array creation expression or an array initializer. 

An array creation expression (or an array initializer) specifies: 
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e The element type 
e The number of levels of nested arrays 
e The length of the array for at least one of the levels of nesting 


The length of the array is always available as a final instance variable named length 

An array element is accessed by an expression whose value is an array reference followed by an indexing 
expression enclosed by matching square brackets. 

If an attempt is made to access the array with an invalid index value, an ArrayIndexOutOfBound- 
sException will be thrown. 

Arrays must be indexed by integer values of the types int , short , byte ,or char . An array 
cannot be accessed using an index of type long 

If the elements in an array are not purposely initialized when the array is created, the array elements 
will be automatically initialized with default values. 

The values in the array elements may be purposely initialized when the array object is created using a 
comma-separated list of expressions enclosed by matching curly brackets. 

The program in this module illustrated three different ways to emulate traditional rectangular two- 
dimensional arrays. 

The program also illustrated two different ways to create and work with ragged arrays. 


3.2.25.6 What’s next? 


In the next module, I will provide so additional information about array objects, and then illustrate the use 
of the classes named Array and Arrays for the creation and manipulation of array objects. 


3.2.25.7 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java OOP: Array Objects, Part 2 
e File: Javal624.htm 

e Published: 05/22/02 

e Revised: 12/06/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 

In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.25.8 Complete program listing 
A complete listing of the program is shown in Listing 26 (p. 427) below. 
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Listing 26 . Complete program listing. 


/*File Array07.java 
Copyright 2002, R.G.Baldwin 


This program illustrates three 
different ways to emulate a traditional 
rectangular array in Java. Two of 
those ways are essentially ragged 
arrays with equal-length sub arrays. 


The program also illustrates two ways 
to create ragged arrays in Java. 


Tested using JDK 1.3 under Win 2000. 
FE I A I IAI I ICI AI ICI I I AK aK EEEE EEEN 


public class Array07{ 
public static void main( 
String[] args) { 


//Create an array structure that 
// emulates a traditional 
// rectangular array with two rows 
// and three columns. This 
// approach requires all rows to 
// be the same length. 
Object[][] vi = new Object [2] [3]; 
//Populate the array elements with 
// references to objects of type 
// Integer. 
for(int i=0;i<vi.length;i++){ 
for(int j=0;j<vi[i].length; j++) { 
vi[i][j] = 
new Integer((i+1)*(j+1)); 
}//end inner loop 
}//end outer loop 
//Display the array elements 
for(int i=0;i<vi.length;i++){ 
for(int j=0;j<vi[i].length; j++) { 
System. out. print ( 
vi[i][j] +" "); 
}//end inner loop 
System.out.println();//new line 
}//end outer loop 
System. out .println();//new line 


//Create a ragged array with two 
// rows. The first row has three 
// columns and the second row has 
// three columns. The length of 
// each row could be, any ything, b 
eee ee Available for free at C ‘hyexions <http://cnx.org/content /col11441/1.181> 
// above array structure. 

Object [] [] v2 = new Object[2][]; 

v2[0] = new Object [3]; 
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Table 3.132 


-end- 


3.2.26 Javal624s Slides” 
3.2.26.1 Table of Contents 


e Instructions for viewing slides (p. 428) 
e Miscellaneous (p. 428) 


3.2.26.2 Instructions for viewing slides 
This module contains lecture slides keyed to the module titled Javal624: Array Objects, Part 27° . 

Click here ™ to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 


the slides in sequence. 


3.2.26.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java1624s Slides: Array Objects, Part 2 
e File: Javal624s.htm 
e Published: 01/17/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


“This content is available online at <http://cnx.org/content /m48931/1.2/>. 
T3http://cnx.org/content /m44199/latest /?collection=col1 1441 /latest 
“4http://cnx.org/content /m48931/latest /a0-Index.htm 
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3.2.27 Javal626: Array Objects, Part 3” 
3.2.27.1 Table of Contents 


e Preface (p. 429) 


Viewing tip (p. 429) 
x Listings (p. 429) 


Preview (p. 429) 


3.2.27.2 Preface 


Discussion and sample code (p. 430) 
Summary (p. 438) 

What’s next? (p. 439) 
Miscellaneous (p. 439) 

Complete program listing (p. 439) 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 


using Java. 


3.2.27.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


3.2.27.2.1.1 Listings 


Listing 3 (p 
Listing 4 (p 


Listing 6 (p 
Listing 7 (p 
Listing 8 (p 
Listing 9 


435 
. 437 


Listing 11 (p 


3.2.27.3 Preview 


Listing 1 (p. 431) . 

Listing 2 (p. 433) . 
(p. 433) . 
(p. 434) . 

Listing 5 (p. 434) . 
(p. 435) . 
(p. 
(p. 
( 


Using the newInstance method. 
Populate the array object. 

Display the data. 

An array object of type int. 

The two-dimensional array object tree. 
Populate the leaf elements. 


) . Display the data. 
436) . 
) 


Create, populate, and display an array object. 


p . Sort and display the data. 
Listing 10 (p. 437) . Search for an existing string. 

(p. 438) . Search for a non-existing string. 
Listing 12 (p. 441) . Complete program listing. 


This module discusses various details regarding the use of array objects in Java, including: 


The members of an array object 

The interfaces implemented by array objects 
Class objects and array objects 

The classes named Array and Arrays 


“5This content is available online at <http://cnx.org/content/m44200/1.5/>. 
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3.2.27.4 Discussion and sample code 


Members of an array object 
An array object has the following members (in addition to the data stored in the object): 


e A public final variable named length , which contains the number of components of the array (length 
may be positive or zero) 

e A public method named clone . This method overrides the method of the same name in Object 
class. 

e Default versions of all the methods inherited from the class named Object , (other than clone , 
which is overridden as described above). 


Implements Cloneable and Serializable 
Also, every array object implements the Cloneable and Serializable interfaces. (Note that neither 
of these interfaces declares any methods.) 

What is the Cloneable interface? 

Here is what Sun has to say about the Cloneable interface: 

"A class implements the Cloneable interface to indicate to the Object.clone() method that it is 
legal for that method to make a field-for-field copy of instances of that class. Attempts to clone instances 
that do not implement the Cloneable interface result in the exception CloneNotSupportedException 
being thrown." 

Thus, the fact than an array object implements the Cloneable interface makes it possible to clone 
array objects. 

A cloned array is shallow 

While it is possible to clone arrays, care must be exercised when cloning multidimensional arrays. That 
is because a clone of a multidimensional array is shallow. 

What does shallow mean? 

Shallow means that the cloning process creates only a single new array. 
Subarrays are shared between the original array and the clone. 

(Although I’m not certain, I suspect that this may also be the case for cloning array objects containing 
references to ordinary objects. I will leave that determination as an exercise for the student. In any event, 
be careful if you clone array objects.) Serialization 

Serialization of an object is the process of decomposing the object into a stream of bytes, which can later 
be recomposed into a copy of the object. Here is what Sun has to say about the Serializable interface: 

"Serializability of a class is enabled by the class implementing the java.io.Serializable interface. 
Classes that do not implement this interface will not have any of their state serialized or deserialized. 

All subtypes of a serializable class are themselves serializable. 

The serialization interface has no methods or fields and serves only to identify the semantics of being 
serializable." 

Even though this quotation from Sun doesn’t address array objects, because array objects implement the 
Serializable interface, they can be serialized and later reconstructed. 
Class objects representing array objects 
An object of the class named Class can be obtained (by calling the getClass method of the Object 
class) to represent the class from which an ordinary object was instantiated. 
The Class object is able to answer certain questions about the class that it represents (such as the 
name of the superclass), and has other uses as well. 

(One of the other uses is to specify the type as a parameter to the methods of the Array class, which 
I will illustrate later in this module.) 

Every array also has an associated Class object. 

That Class object is shared with all other arrays with the same component type. 
The superclass of an array type is Object . (Think about this!) 

An array of characters is not a string 
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For the benefit of the C/C++ programmers in the audience, an array of char is not a String 

(In Java, a string is an object of the String class or the StringBuffer class). 

Not terminated by null 
Also, neither a String object nor an array of type char is terminated by ’\u0000’ (the NUL character) 


(This information is provided for the benefit of C programmers who are accustomed to working with 
so-called null-terminated strings. If you’re not a C programmer, don’t worry about this.) 
A String object in Java is immutable 

Once initialized, the contents of a Java String object never change. 

On the other hand, an array of type char has mutable elements. The String class provides a method 
named toCharArray , which returns an array of characters containing the same character sequence as a 
String 

StringBuffer objects 

The class named StringBuffer also provides a variety of methods that work with arrays of characters. 

The contents of a StringBuffer object are mutable. 
The Array and Arrays classes 

The classes named Array and Arrays provide methods that you can use to work with array objects. 

The Array class provides static methods to dynamically create and access Java arrays. 

The Arrays class contains various methods for manipulating arrays (such as sorting and searching). 
It also contains a static factory method that allows arrays to be viewed as lists. 

A sample program named Array08 

The sample program named Array08 (shown in Listing 12 (p. 441) near the end of the module) 

illustrates the use of some of these methods. 
Will discuss in fragments 

As usual, I will discuss this program in fragments. Essentially all of the interesting code is in the method 
named main , so I will begin my discussion there. The first few fragments will illustrate the creation, 
population, and display of a one-dimensional array object whose elements contain references to objects of 
type String 

The newlInstance method of the Array class 

The code in Listing 1 (p. 431) calls the static method of the Array class named newlnstance to 
create the array object and to store the object’s reference in a reference variable of type Object named 
vl 

(Note that there are two overloaded versions of the newInstance method in the Array class. I will 
discuss the other one later.) 


Listing 1 . Using the newInstance method. 


Object vi = Array.newInstance(Class.forName("java.lang.String"), 
3); 


Table 3.133 


Two parameters required 

This version of the newInstance method requires two parameters. The first parameter specifies the 
component type. This must be a reference toa Class object representing the component type of the new 
array object. 


The second parameter, of type int , specifies the length of the new array object. 
The Class object 
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The second parameter that specifies the array length is fairly obvious. However, you may need some help 
with the first parameter. Here is part of what Sun has to say about a Class object. 

"Instances of the class Class represent classes and interfaces in a running Java application. Every 
array also belongs to a class that is reflected as a Class object that is shared by all arrays with the same 
element type and number of dimensions. The primitive Java types (boolean, byte, char, short, int, long, 
float, and double), and the keyword void are also represented as Class objects." 

Getting a reference to a Class object 

I know of three ways to get (or refer to) a Class object. 


e Class objects for primitive types 
e The getClass method 
e The forName method 


Class objects for primitive types 

There are nine predefined Class objects that represent the eight primitive types and void. These are 
created by the Java Virtual Machine, and have the same names as the primitive types that they represent: 
boolean , byte , char , short , int , long , float ,and double . You can refer to these class 
objects using the following syntax: 


e boolean.class, 
e int.class, 
e float.class, etc. 


I will illustrate this later in this module. 
The getClass method 
If you have a reference to a target object (ordinary object or array object), you can gain access to 
a Class object representing the class from which that object was instantiated by calling the getClass 
method of the Object class, on that object. 
The getClass method returns a reference of type Class that refers toa Class object representing 
the class from which the target object was instantiated. 
The forName method 
The static forName method of the Class class accepts the name of a class or interface as an incoming 
String parameter, and returns the Class object associated with the class or interface having the given 
string name. 
(The forName method cannot be used with primitive types as a parameter.) 
Class object for the String class 
Referring back to Listing 1 (p. 431) , you will see that the first parameter passed to the newInstance 
method was a reference to a Class object representing the String class. 
Thus, the statement in Listing 1 (p. 431) creates a one-dimensional array object, of component type 
String , three elements in length. 
The reference to the array object is saved in the generic reference variable of type Object 
(In case you haven’t recognized it already, this is an alternative to syntax such as 
new String[3] . 
Note that there are no square brackets in this alternative approach. Thus, it might be said that this 
approach is more mainstream OOP than the approach that requires the use of square brackets. ) 
Populate the array object 
The code in Listing 2 (p. 433) uses two static methods of the Array class to populate the three 
elements of the array object with references to objects of type String 
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Listing 2 . Populate the array object. 


for(int i = 0; i < Array.getLength(v1);i++){ 
Array.set(v1, i, "a"+i); 
}//end for loop 


Table 3.134 


The getLength method 

The getLength method of the Array class is used in Listing 2 (p. 433) to get the length of the 
array for use in the conditional expression of a for loop. 

Note that unlike the sample programs in the previous module (that stored the array object’s reference 
as type Object ), it was not necessary to cast the reference to type String|| in order to get the length 


The set method 

The set method of the Array class is used in Listing 2 (p. 433) to store references to String objects 
in the elements of the array object. 

Again, unlike the programs in the previous module, it was not necessary to cast the array reference to 
type String] to access the elements. In fact, there are no square brackets anywhere in Listing 2 (p. 433) . 

Display the data 

Listing 3 (p. 433) uses asimilar for loop to display the contents of the String objects whose references 
are stored in the elements of the array object. 


Listing 3 . Display the data. 


for(int i = 0; i < Array.getLength(v1); i++){ 
System. out.print (Array.get(v1, i) +" "); 
}//end for loop 


Table 3.135 


No square brackets 

Once again, note that no casts, and no square brackets were required in Listing 3 (p. 433) . In fact, 
this approach makes it possible to deal with one-dimensional array objects using a syntax that is completely 
devoid of square brackets. 

Rather than using square brackets to access array elements, this is a method-oriented approach to the 
use of array objects. This makes it possible to treat array objects much the same as we treat ordinary objects 
in Java. 

A two-dimensional rectangular array object tree 

Next, I will use the methods of the Array class to create, populate, and display a rectangular two- 

dimensional array object tree, whose elements contain references to objects of the class String 
Another overloaded version of newInstance 

To accomplish this, I will use the other overloaded version of the newInstance method. This version 
requires a reference to an array object of type int as the second parameter. 

(Note that the Sun documentation describes two different behaviors for this method, depending on the 
whether the first parameter represents a non-array class or interface, or represents an array type. This 
sample program illustrates the first possibility.) 
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The second parameter 
As mentioned above, the version of the newInstance method that I am going to use requires a reference 
to an array object of type int as the second parameter. 

(The length of the array object of type int specifies the number of dimensions of the multi-dimensional 
array object. The contents of the elements of the array object of type int specify the sizes of those 
dimensions.) 

Thus, my first task is to create and populate an array object of type int 

An array object of type int 

Listing 4 (p. 434) shows the code required to create and populate the array object of type int . This is 
a one-dimensional array object having two elements (length equals 2). The first element is populated with 
the int value 2 and the second element is populated with the int value 3. 


Listing 4 . An array object of type int. 


Object v2 = Array.newInstance(int.class,2); 
Array.setInt(v2, 0, 2); 
Array.setInt(v2, 1, 3); 


Table 3.136 


Why do we need this array object? 

When this array object is used later, in conjunction with the version of the newInstance method that 
requires a reference to an array object of type int as the second parameter, this array object will specify 
an array object having two dimensions (a rectangular array). The rectangular array will have two rows 
and three columns. 

Same newlInstance method as before 

Note that Listing 4 (p. 434) uses the same version of the newInstance method that was used to create 

the one-dimensional array object in Listing 1 (p. 431) . 
Class object representing int 

Note the syntax of the first parameter passed to the newInstance method in Listing 4 (p. 434) . As 
mentioned earlier, this is a reference to the predefined Class object that represents the primitive type int 
. This causes the component type of the array object to be type int 

The setInt method 

You should also note the use of the setInt method of the Array class to populate each of the two 

elements in the array in Listing 4 (p. 434) (with int values of 2 and 3 respectively). 
The two-dimensional array object tree 

Listing 5 (p. 434) uses the other overloaded version of the newlInstance method to create a two- 

dimensional array object tree, having two rows and three columns. 


Listing 5 . The two-dimensional array object tree. 


Object v3 = Array.newInstance(Class.forName("java.lang.String"), 
(int []) v2); 


Table 3.137 
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A reference to the array object at the root of the tree is stored in the reference variable of type Object 

named v3 . Note that the tree is designed to store references to objects of type String 
(The number of dimensions and the size of each dimension are specified by the reference to the array 

object of type int passed as the second parameter.) 

Square-bracket cast is required here 

The required type of the second parameter for this version of the newInstance method is int]| 
Therefore, there was no way for me to avoid the use of square brackets. I could either store the reference to 
the array object as type Object and cast it before passing it to the method, (which I did), or save it 
originally as type int[] , (which I didn’t). Either way, I would have to know about the type int[] . 

Populate the leaf elements 

The nested for loop in Listing 6 (p. 435) uses the various methods of the Array class to populate 
the elements in the leaf array objects with references to objects of the class String 


Listing 6 . Populate the leaf elements. 


for(int i=0;i < Array.getLength(v3) ;i++){ 
for(int j=0;j < Array.getLength(Array.get(v3,i));j++){ 
Array.set (Array.get(v3,i),j,"b" + (it1)*(j+1)); 
}//end inner loop 
}//end outer loop 


Table 3.138 


Admittedly, the code in Listing 6 (p. 435) is a little complex. However, there is really nothing new there, 
so I won’t discuss it further. 

Display the data 

Similarly, the code in Listing 7 (p. 435) uses the methods of the Array class in a nested for loop to 
get and display the contents of the String objects whose references are stored in the elements of the leaf 
array objects. Again, there is nothing new here, so I won’t discuss this code further. 


Listing 7 . Display the data. 


for(int i=0;i < Array.getLength(v3) ;i++){ 
for(int j=0;j < Array.getLength(Array.get(v3,i));j++){ 
System. out.print (Array.get (Array.get(v3,i),j) + " "); 
}//end inner loop 
System.out.println(Q); 
}//end outer loop 
System.out.println(); 


Table 3.139 


Very few square brackets 

I will point out that with the exception of the requirement to create and pass an array object as type 
int[] , it was possible to write this entire example without the use of square brackets. This further illustrates 
the fact that the Array class makes it possible to create and work with array objects in a method-oriented 
manner, almost devoid of the use of square-bracket notation. 
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Sorting and Searching 
Many college professors require their students to spend large amounts of time reinventing algorithms for 
sorting and searching (and for various collections and data structures as well). There was probably a time 
in history when that was an appropriate use of a student’s time. However, in my opinion, that time has 
passed. 
Reuse, don’t reinvent 
Through a combination of the Arrays class, and the Java Collections Framework , most of the 
sorting, searching, data structures, and collection needs that you might have are readily available without a 
requirement for you to reinvent them. 
(One of the most important concepts in OOP is reuse, don’t reinvent .) 
I will now illustrate sorting and searching using static methods of the Arrays class. 
(Note that the Arrays class is different from the Array class discussed earlier.) 
Create, populate, and display an array object 
To give us something to work with, Listing 8 (p. 436) creates, populates, and displays the contents of an 
array object. Note that the array object is populated with references to String objects. There is nothing 
new here, so I won’t discuss the code in Listing 8 (p. 436) in detail. 


Listing 8 . Create, populate, and display an array object. 


Object v4 = Array.newInstance(Class.forName("java.lang.String"), 
8); 
//Populate the array object. 
// Create a gap in the data. 
for(int i = 0; i < Array.getLength(v4); i++){ 
if(i < 4)f 
Array .set (v4,i,"c"+(8-i)) ;} 
else{ 
Array .set(v4,i,"c"+(18-i));} 
}//end for loop 


//Display the raw data 

for(int i = 0; i < Array.getLength(v4); i++){ 
System. out.print (Array.get(v4,i)+ " "); 

}//end for loop 


Table 3.140 


The output 
The code in Listing 8 (p. 436) produces the following output on the screen: 


c8 c7 c6 c5 c14 c13 c12 c11 


Note that the order of this data is generally descending, and there is no string encapsulating the characters 
c4. 

Sort and display the data 

The code in Listing 9 (p. 437) uses the sort method of the Arrays class to sort the array data into 
ascending order. 
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Listing 9 . Sort and display the data. 


Arrays.sort ((Object[])v4) ; 


//Display the sorted data 

for(int i = 0; i < Array.getLength(v4); i++){ 
System.out.print(Array.get(v4, i) + " "); 

}//end for loop 


Table 3.141 


The output 
The code in Listing 9 (p. 437) displays the sorted contents of the array object, producing the following 
output on the computer screen 


c11 c12 c13 c14 c5 c6 c7 c8 


Note that the order of the data in the array object has been modified, and the array data is now in ascending 
order. 

(This order is based on the natural ordering of the String data. I discuss other ways to order sorted 
data in conjunction with the Comparable and Comparator interfaces in my modules on the Java 
Collections Framework.) 

Binary search 

A binary search is a search algorithm that can very quickly find an item stored in a sorted collection of 
items. In this case, the collection of items is stored in an array object, and the data is sorted in ascending 
order. 

Search for an existing string 

Listing 10 (p. 437) uses the binarySearch method of the Arrays class to perform a search for an 
existing String object whose reference is stored in the sorted array. The code searches for the reference to 
the String object encapsulating the characters c5 


Listing 10 . Search for an existing string. 


System.out.println(Arrays.binarySearch((Object[])v4,"c5")); 


Table 3.142 


The result of the search 

The code in Listing 10 (p. 437) displays the numeral 4 on the screen. 

When the binarySearch method finds a match, it returns the index value of the matching element. If 
you go back and look at the sorted contents (p. 437) of the array shown earlier, you will see that this is the 
index of the element containing a reference to a String object that encapsulates the characters c5 

Search for a non-existing string 

The code in Listing 11 (p. 438) uses the binarySearch method to search for a reference to a String 
object that encapsulates the characters c4 . As I indicated earlier, a String object that encapsulates 
these characters is not represented in the sorted array object. 
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Listing 11 . Search for a non-existing string. 


System.out.println(Arrays.binarySearch((Object[])v4,"c4")); 


Table 3.143 


The result of the search 

The code in Listing 11 (p. 438) produces the following negative numeral on the screen: -5 

Here is Sun’s explanation for the value returned by the binarySearch method: 

"Returns: index of the search key, if it is contained in the list; otherwise, (-(insertion point) - 1). The 
insertion point is defined as the point at which the key would be inserted into the list: the index of the first 
element greater than the key, or list.size(), if all elements in the list are less than the specified key. Note 
that this guarantees that the return value will be >= 0 if and only if the key is found." 

Thus, the negative return value indicates that the method didn’t find a match. The absolute value of 
the return value can be used to determine the index of the reference to the target object if it did exist in the 
sorted list. I will leave it as an exercise for the student to interpret Sun’s explanation beyond this simple 
explanation. 

Other capabilities 

In addition to sorting and searching, the Arrays class provides several other methods that can be used 
to manipulate the contents of array objects in Java. 


3.2.27.5 Summary 


An array object has the following members (in addition to the data stored in the object): 


e A public final variable named length 
e An overridden version of the public method named clone 
e Default versions of all the other methods inherited from the class named Object 


Every array object implements the Cloneable and Serializable interfaces. 

A clone of a multidimensional array is shallow. Therefore, you should exercise caution when cloning array 
objects. 

Because array objects implement the Serializable interface, they can be serialized and later recon- 
structed. 

Every array also has an associated Class object. 

The classes named Array and Arrays provide methods that you can use to work with array objects. 

The Array class provides static methods to dynamically create and access Java array objects. 

The Arrays class contains various methods for manipulating arrays (such as sorting and searching). 
It also contains a static factory method that allows arrays to be viewed as lists. 

Class objects are required when using the methods of the Array class to dynamically create Java array 
objects. 

There are nine predefined Class objects that represent the eight primitive types and void. They are 
accessed using the following syntax: boolean.class, int.class, etc. 

Three ways to get a Class object are: 


e Class objects for primitive types: int.class , etc. 


e The getClass method 
e The forName method 
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The methods of the Array class make it possible to deal with one-dimensional array objects using a syntax 
that is completely devoid of square brackets. This is a method-oriented approach to the use of array 
objects. This makes it possible to treat array objects much the same as we treat ordinary objects in Java. 
The required syntax for multi-dimensional array objects is mostly devoid of square brackets. 

The Arrays class provides methods for sorting and searching array objects as well as performing other 
operations on array objects as well. 

Through a combination of the Arrays class and the Java Collections Framework, most of the sort- 
ing, searching, data structures, and collection needs that you might have are readily available without a 
requirement for you to reinvent them. 

One of the most important concepts in OOP is reuse, don’t reinvent. 


3.2.27.6 What’s next? 


The next module will explain the use of the this and super keywords. 


3.2.27.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Array Objects, Part 3 
e File: Javal626.htm 

e Published: 08/08/12 

e Revised: 12/06/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.2.27.8 Complete program listing 
A complete listing of the program is shown in Listing 12 (p. 441) below. 


Listing 12 . Complete program listing. 


continued on next page 
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/*File Array08. java 
Copyright 2002, R.G.Baldwin 
Rev 2/10/02 


This program illustrates the use of 
static methods of the Array class to 
dynamically create and access Java 
arrays. 


It also illustrates the use of static 
methods of the Arrays class to sort 
and search array objects. 


Tested using JDK 1.3 under Win 2000. 
FEA I IO I IOC I ICI AI I E EEEE EEEE EEEN 
import java.lang.reflect.Array; 

import java.util.Arrays; 


public class Array08{ 
public static void main( 
String[] args) { 


tryf 
//Create, populate, and display a 
// one-dimensional array object 
// whose elements contain 
// references to objects of type 
// String. 


//Create the array object 
Object vi = Array.newInstance( 
Class .forName( 
“java.lang.String"), 3); 
//Populate the array object 
for(int i= 0; i < 
Array.getLength(v1); i++){ 
Array.set(v1, i, "a"+i); 
}//end for loop 
//Display the data 
for(int i= 0; i < 
Array.getLength(v1); i++){ 
System.out.print( 
Array.get(vi, i) +" "); 
}//end for loop 
System. out.println() ; 
System. out.println() ; 


//Create, populate, and display a 
// rectangular two-dimensional 
// array object tree whose 
// elements contain references 
// to objects of type String. . 
vailable for free at Connexions <http://cnx.org/content/col11441/1.181> 
//First create an array object of 
// type int required as a 
// parameter to the newInstance 
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Table 3.144 


-end- 


3.2.28 Javal628: The this and super Keywords” 
3.2.28.1 Table of Contents 


e Preface (p. 442) 
Viewing tip (p. 442) 

x Images (p. 442) 

x Listings (p. 442) 
Preview (p. 442) 
Discussion and sample code (p. 443) 
Summary (p. 456) 
What’s next? (p. 456) 
Miscellaneous (p. 456) 


3.2.28.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 


3.2.28.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.2.28.2.1.1 Images 
e Image 1 (p. 444) . The extends keyword. 


3.2.28.2.1.2 Listings 


e Listing 1 (p. 445) . The program named This01. 
e Listing 2 (p. 447) . The program named This02. 
e Listing 3 (p. 449) . The program named This03. 
e Listing 4 (p. 452) . The program named Super3. 
e Listing 5 (p. 455) . The program named Super4. 


3.2.28.3 Preview 


This module explains the use of the keywords this and super . Short sample programs illustrate 
how you can use these keywords for several purposes. 
I will discuss and illustrate the use of the this keyword in the following situations: 


e To bypass local variables or parameters that hide member variables having the same name, in order to 
access the member variable. 

e To make it possible for one overloaded constructor to call another overloaded constructor in the same 
class. 


“6This content is available online at <http://cnx.org/content/m44201/1.5/>. 
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e To pass a reference to the current object to a method belonging to a different object (as in implementing 
callbacks, for example). 


I will also discuss and illustrate the use of the super keyword in the following situations: 


e To bypass the overridden version of a method in a subclass and execute the version in the superclass. 

e To bypass a member variable in a subclass in order to access a member variable having the same name 
in a superclass. 

e To cause a constructor in a subclass to call a parameterized constructor in the immediate superclass. 


3.2.28.4 Discussion and sample code 


You already know quite a lot about OOP 

By now you know that an object is an instance of a class . You know that all variables and methods 
in Java must be contained in a class or an object. You know that the three primary characteristics of an 
object-oriented programming language are: 


e encapsulation 
e inheritance 
e polymorphism . 


If you have been studying this series of modules on the Essence of OOP in Java, you already know quite a 
lot about OOP in general, and the implementation of OOP in Java in particular. 

A few more important OOP /Java concepts 

However, there are a few more important concepts that I haven’t previously discussed in this series of 
modules. In this module, I will explain the use of the keywords this and super 

Data and methods 

The class provides the plan from which objects are built. This plan defines the data that is to be 
stored in an object, and the methods for manipulating that data. The data is variously referred to as data 
members, fields , and variables , depending on which book you are reading. 

Non-static and static 

The data can be further sub-divided into non-static and static , often referred to asi nstance variables 
and class variables respectively. 

The methods are also often referred to as member methods , and they can also be static or non-static 
. Static methods are often referred to as class methods while non-static methods are often referred to as 
instance methods 

Instance variables and instance methods 

The class body contains the declarations for, and possibly the initialization of all data members (both 
class variables and instance variables) as well as the full definition of all methods 

In this module, we will be particularly interested in instance variables and instance methods. 

Every class is a subclass of Object 

By default, every class in Java extends (either directly or indirectly) the class named Object . A new 
class may either extend Object , or extend another class that extends Object , or extend another class 
further down the inheritance hierarchy. 

The immediate parent class of a new class is known as its superclass , and the new class is known as 
the subclass . 

(Sometimes we use the word superclass to indicate the collection of classes in the inheritance hierarchy 

from which a specific class is derived.) 

If you do not specify the superclass for a new class, it will extend Object by default. 

The extends keyword 

The keyword extends is used in the class declaration to specify the immediate superclass of the new 
class using the syntax shown in Image 1 (p. 444) . 
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Image 1 . The extends keyword. 


class NewClass extends SuperClassNamef{ 
//body of class 
}//end class definition 


Table 3.145 


Inheritance 

A class inherits the variables and methods of its superclass, and of the superclass of that class, etc., all 
the way back up the family tree to the single class Object , which is the root of all inheritance. 

Thus, an object that is instantiated from a class contains all the instance variables and all the instance 
methods defined by that that class and defined by all its ancestors. 

However, the methods may have been overridden one or more times along the way. Also, access to 
those variables and methods may have been restricted through the use of the public , private , and 
protected keywords. 

(There is another access level, often referred to as package private , which is what you get when you 
don’t use an access keyword.) 
The this keyword 

Every instance method in every object in Java receives a reference named this when the method is 
called. The reference named this is a reference to the object on which the method was called. It can be 
used for any purpose for which such a reference is needed. 

Three common situations 
There are at least three common situations where such a reference is needed: 


e To bypass local variables or parameters that hide member variables having the same name, in order to 
access the member variable. 

e To make it possible for one overloaded constructor to call another overloaded constructor in the same 
class. 

e To pass a reference to the current object to a method belonging to a different object (as in implementing 
callbacks, for example). 


Normally, instance methods belonging to an object have direct access to the instance variables belonging to 
that object, and to the class variables belonging to the class from which that object was instantiated. 
(Class methods never have access to instance variables or instance methods.) 

Name can be duplicated 

However, the name of a method parameter or constructor parameter can be the same as the name of an 
instance variable belonging to the object or a class variable belonging to the class. It is also allowable for 
the name of a local variable to be the same as the name of an instance variable or a class variable. In this 
case, the local variable or the parameter is said to hide the member variable having the same name. 

Reference named this is passed to instance methods 

As mentioned above, whenever an instance method is called on an object, a hidden reference named this 
is always passed to the method. The this reference always refers to the object on which the method was 
called. This makes it possible for the code in the method to refer back to the object on which the method 
was called. 

The reference named this can be used to access the member variables hidden by the local variables or 
parameters having of the same name. 

The sample program named This01 

The sample program shown in Listing 1 (p. 445) illustrates the use of the this reference to access a 
hidden instance variable named myVar and a hidden class variable named yourVar 
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Listing 1 . The program named This01. 


/*File ThisO1.java 
Copyright 2002, R.G.Baldwin 
Illustrates use of this keyword to 
access hidden member variables. 


Tested using JDK 1.4.0 under Win2000 
The output from this program is: 


myVar parameter = 20 

local yourVar variable = 1 

Instance variable myVar = 5 

Class variable yourVar = 10 

FE aK 3K 3K 3K 3K 3K ak ak I I I ICICI ICI ak II IK 3K a 3K 3K 3 K K K KK ÞK / 


class This01 { 
int myVar = 0; 
static int yourVar = 0; 


//Constructor with parameters named 
// myVar and yourVar 
public ThisO1(int myVar,int yourVar){ 
this.myVar = myVar; 
this.yourVar = yourVar; 
}//end constructor 


//Method with parameter named myVar 
// and local variable named yourVar 
void myMethod(int myVar){ 
int yourVar = 1; 
System. out .print1n( 
"myVar parameter = " + myVar); 
System. out. print1n( 
"local yourVar variable = " 
+ yourVar) ; 
System. out .print1n( 
"Instance variable myVar = " 
+ this.myVar) ; 
System. out .print1n( 
"Class variable yourVar = " 
+ this.yourVar) ; 
}//end myMethod 


public static void main( 
String[] args) { 
ThisO1 obj = new This01(5,10); 
obj .myMethod (20) ; 
d i thod 
}//end main me Avaliable 


}//End This01 class ini 
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Table 3.146 


The key points 
The key points to observe in the program is Listing 1 (p. 445) are: 


e When the code refers to myVar or yourVar , the reference resolves to either an incoming parameter 
or to a local variable having that name. 

e When the code refers to thissmyVar or this.yourVar , the reference resolves to the corresponding 
instance variable and class variable having that name. 


To summarize this situation, every time an instance method is called, it receives a hidden reference named 
this . That is a reference to the object on which the method was called. 

The code in the method can use that reference to access any instance member of the object on which it 
was called, or any class member of the class from which the object was instantiated. 

However, when class methods are called, they do not receive such a hidden reference, and therefore, they 
cannot refer to any instance members of any object instantiated from the class. They can only access class 
members of the same class. 

Calling other constructors of the same class 

Now I am going to discuss and illustrate the second common situation listed earlier. 

A class can define two or more overloaded constructors having the same name and different argument 
lists. Sometimes it is useful for one overloaded constructor to call another overloaded constructor in the 
same class. When this is done, the constructor being called is referred to as though it were a method whose 
name is this , and whose argument list matches the argument list of the constructor being called. 

The sample program named This02 
This situation is illustrated in the program named This02 shown in Listing 2 (p. 447) . 
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Listing 2 . The program named This02. 


/*File This02. java 
Copyright 2002, R.G.Baldwin 
Illustrates use of this keyword for one 
overloaded constructor to access 
another overloaded constructor of the 
same class. 


Tested using JDK 1.4.0 under Win2000 
The output from this program is: 


Instance variable myVar = 15 
LEETE EEEE EEEE EEEE EEE EE EEEE E EEEE EEEE EEEN 


class This02 { 
int myVar = 0; 


public static void main( 
String[] args) { 
This02 obj = new This02(); 
obj .myMethod() ; 
}//end main method 


//Constructor with no parameters 
public This02(){ 
//Call parameterized constructor 
this(15); 
}//end constructor 


//Constructor with one parameter 
public ThisO2(int var){ 

myVar = var; 
}//end constructor 


//Method to display member variable 
// named myVar 
void myMethod(){ 
System. out .print1n( 
"Instance variable myVar = " 
+ myVar); 
}//end myMethod 


}//End This02 class definition. 


Table 3.147 
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Calling a noarg constructor 
The main method in Listing 2 (p. 447) instantiates a new object by applying the new operator to 
the noarg constructor for the class named This02 
(The common jargon for a constructor that doesn’t take any parameters is a noarg constructor.) 
The noarg constructor calls a parameterized constructor 
The code in the noarg constructor uses the this keyword to call the other overloaded constructor, 
passing an int value of 15 as a parameter. 
That constructor stores the value of the incoming parameter (15) in the instance variable named my Var 
. Then control returns to the noarg constructor, which in turn returns control to the main method. 
When control returns to the main method, the new object has been constructed, and the instance variable 
named myVar_ belonging to that object contains the value 15. 
Display the value of the instance variable 
The next statement in the main method calls the method named myMethod on the object, which 
causes the value stored in the instance variable (15) to be displayed on the screen. 
The most important statement 
For purposes of this discussion, the most important statement in the program is the statement that reads: 


this(15); 


This is the statement used by one overloaded constructor to call another overloaded constructor. 

Callbacks 

An extremely important concept in programming is the third situation mentioned in the earlier list (p. 
444) . This is a situation where a method in one object calls a method in another object and passes a 
reference to itself as a parameter. 

(This is sometimes referred to as registration. That is to say, one object registers itself on another 

object.) 

The method in the second object saves the reference that it receives as an incoming parameter. This 
makes it possible for a method in the second object to make a callback to the first object sometime later. 
This is illustrated in the program named This03 , shown in Listing 3 (p. 449) . 
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Listing 3 . The program named This03 . 


/*File This03.java 
Copyright 2002, R.G.Baldwin 
Illustrates using the this keyword in 
a callback scenario. 


Tested using JDK 1.4.0 under Win2000 
The output from this program is: 


Instance variable myVar = 15 
FA A I IO EEE EEEE EEEE E EEEE EEEE EEEN 


class This03 { 
public static void main( 
String[] args){ 
ClassA objA = new ClassA(); 
ClassB objB = new ClassB(); 
objA. goRegister (objB) ; 
objB.callHimBack () ; 
objA.showData() ; 
3//end main method 
}//End This03 class definition. 


class ClassA{ 
int myVar; 


void goRegister(ClassB refTo0bj) { 
refTo0bj .registerMe(this) ; 


}//end goRegister 


void callMeBack(int var) { 
myVar = var; 
}//end callMeBack 


void showData(){ 
System. out .print1n( 
"Instance variable myVar = " 


3//end showData 
}//end ClassA 


class ClassB{ 
ClassA ref; 


void registerMe(ClassA_ var) { 


ref = var; 
}//end registerMe 
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Table 3.148 


Not intended to be useful 

Note that the program in Listing 3 (p. 449) is intended solely to illustrate the concept of a callback, and 
is not intended to do anything useful. This is a rather long and convoluted explanation, so please bear with 
me. 

The main method begins by instantiating two objects, one each from the classes named ClassA and 
ClassB 

Go register yourself 

Then the main method sends a message to objA telling it to go register itself on objB . A reference 
to objB is passed as a parameter to the method named goRegister belonging to objA 

The code in objA_ uses this reference to call the method named registerMe on objB , passing 
this as a parameter. In other words, the code in objA calls a method belonging to objB passing a 
reference to itself as a parameter. The code in objB saves that reference in an instance variable for later 
use. 

Make a callback 

Then the main method sends a message to objB asking it to use the saved reference to make a 
callback to objA . The code in the method named callHimBack uses the reference to objA saved 
earlier to call the method named callMeBack on objA , passing 15 as a parameter. The method named 
callMeBack belonging to objA saves that value in an instance variable. 

Show the data 

Finally, the main method calls the showData method on objA_ to cause the value stored in the 
instance variable belonging to objA to be displayed on the computer screen. 

Callbacks are important 

Again, this program is provided solely to illustrate the concept of a callback using the this keyword. 
In practice, callbacks are used throughout Java, but they are implemented in a somewhat more elegant way, 
making use of interfaces. 

For example, interfaces with names like Observer and MouseListener are commonly used to register 
observer objects on observable objects (sometimes referred to as listeners and sources). Then later in 
the program, when something of interest happens on the observable object (the source), all registered 
observer objects (the listeners), are notified of the event. 

The main point regarding the this reference 

The main point of this discussion is that the this reference is available to all instance methods belonging 
to an object, and can be used whenever there is a need for a reference to the object on which the method is 
called. 

To disambiguate something 

At least one prominent author uses the word disambiguate to describe the process described by the 
first item in the earlier list (p. 444) , where the this keyword is used to bypass one variable in favor of a 
different variable having the same name. I will also use that terminology in the following discussion. 

Three uses of the super keyword 
Here are three common uses of the super keyword: 


e If your class overrides a method in a superclass, you can use the super keyword to bypass the 
overridden version in the class and execute the version in the superclass. 

e Ifa local variable in your method or a member variable in your class hides a member variable in the 
superclass (having the same name), you can use the super keyword to access the member variable 
in the superclass. 

e You can also use super in a constructor of your class to call a parameterized constructor in the 
superclass. 


The program named Super3 
The program in Listing 4 (p. 452) uses super to call a parameterized constructor in the superclass 
from the subclass constructor. This is an important use of super 
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The program also uses this and super to disambiguate a local variable, an instance variable of the 
subclass, and an instance variable of the superclass. All three variables have the same name. 
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Listing 4 . The program named Super3. 


/*File Super3.java 
Copyright 2002, R.G.Baldwin 
Illustrates use of super reference to 
access constructor in superclass. Also 
illustrates use of super to 
disambiguate instance variable in 
subclass from instance variable in 
superclass. Illustrates use of this 
to disambiguate local variable from 
instance variable in subclass. 


Tested using JDK 1.4.0 under Win2000 
The output from this program is: 


In SuperClass constructor. 
Setting superclass instance var to 500 


In subclass constructor. 
Setting subclass instance var to 400 


In main 
Subclass instance var = 400 


In method myMeth 
Local var = 300 
Subclass instance var = 400 
SuperClass instance var = 500 
FE A I IO I IOI EE EEEE E EEEE EEEE EEEN 
class SuperClass{ 
int data; 


//Parameterized superclass 
// constructor 
public SuperClass(int val)f{ 
System. out .print1n( 
"In SuperClass constructor. "); 
System. out .print1n( 
"Setting superclass instance " 
+ "var to " + val); 
data = val; 
System. out .println();//blank line 
}//end SuperClass constructor 
}//end SuperClass class definition 


class Super3 extends SuperClass{ 
//Instance var in subclass has same 
// name as instance var in superclass 
int data; 
Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
//Subclass constructor 
public Super3(){ 
//Call parameterized SuperClass 
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Table 3.149 


The keyword super is used twice in the program in Listing 4 (p. 452) 

Call a parameterized constructor 

The first usage of the keyword super appears as the first executable statement in the noarg constructor 
for the class named Super3 . This statement reads as follows: 


super (500) ; 


This statement causes the parameterized constructor for the immediate superclass (the class named Su- 
perClass ) of the class named Super3_, to be executed before the remaining code in the constructor for 
Super3 is executed. 

This is the mechanism by which you can cause a parameterized constructor in the immediate superclass 
to be executed. 

What if you don’t do this? 

If you don’t do this, an attempt will always be made to call a noarg constructor on the superclass before 
executing the remaining code in the constructor for your class. 

(That is why you should almost always make certain that the classes that you define have a noarg 
constructor in addition to any parameterized constructors that you may define.) 
First executable statement in constructor 

When super(parameters) is used to call the superclass constructor, it must always be the first 
executable statement in the constructor. 

Whenever you call the constructor of a class to instantiate an object, if your constructor doesn’t have a 
call to super as the first executable statement in the constructor, the call to the noarg constructor in 
the superclass is made automatically. 

In other words, in order to construct an object of a class, it is necessary to first construct that part of the 
object attributable to the superclass. That normally happens automatically, making use of the superclass 
constructor that doesn’t take any parameters. 

Calling a parameterized constructor 

If you want to use a version of the superclass constructor that takes parameters, you can make your own 
call to super(parameters) as the first executable statement in your constructor (as was done in this 
program). 

Accessing a superclass member variable 

The second use of the super keyword in the program shown in Listing 4 (p. 452) uses the keyword to 
bypass an instance variable named data in the class named Super3 , to access and display the value of 
an instance variable named data in the superclass named SuperClass 

Note that in that same section of code, the this keyword is used to bypass a local variable named 
data in order to display the value of an instance variable named data in the class named Super3 

Similarly, a statement without the use of either this or super is used to display the value of a local 
variable named data 

To disambiguate 

Therefore, as stated earlier, the program uses this and super to disambiguate a local variable, an 
instance variable of the subclass, and an instance variable of the superclass, where all three variables have 
the same name. 

Accessing overridden superclass method 

As mentioned earlier (p. 450) , if your method overrides a method in its superclass, you can use 
the keyword super to call the overridden version in the superclass, possibly completely bypassing the 
overridden version in the subclass. 

The program named Super4 

This is illustrated by the program in Listing 5 (p. 455) . This program contains an overridden version 
of a superclass method named meth . The subclass version uses the value of an incoming parameter to 
decide whether to call the superclass version and then to call some of its own code, or to execute its own 
code exclusively. 
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Listing 5 . The program named Super4. 


/*File Super4. java 
Copyright 2002, R.G.Baldwin 
Illustrates calling the superclass 
version of an overridden method from 
code in the subclass version. 


Tested using JDK 1.4.0 under Win 2000. 
The output from this program is: 


In main 

Entering overridden method in subclass 
Incoming parameter is false 

Subclass version only is called 

Back in or still in subclass version 
Goodbye from subclass version 


Entering overridden method in subclass 
Incoming parameter is true 

SuperClass method called 

Back in or still in subclass version 
Goodbye from subclass version 


Back in main 
FOSSA IOI AI I I I I I I I I EEEE EEE 212k 2 ak ak ak ak / 
class SuperClass{ 
//Following method is overridden in 
// the subclass. 
void meth(boolean par) { 
System. out .print1n( 
"Incoming parameter is " + par); 
System. out .print1n( 
"SuperClass method called"); 
3//end meth 
}//end SuperClass class definition 


class Super4 extends SuperClass{ 
//Following method overrides method 
// in the superclass 
void meth(boolean par) { 
System. out .print1n( 
"Entering overridden method " 
+ "in subclass"); 
//Decide whether to call 
// superclass version 
if (par) 
//Call superclass version 
super .meth (par) ; 
else{ 
//Don?t caina beto 
System.out.println( 
"Incoming parameter is " + par); 
System.out.println( 
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Table 3.150 


Only one statement contains super 
The super keyword is used in only one statement in the program in Listing 5 (p. 455) . That statement 
appears in the subclass version of an overridden method, and is as follows: 


super .meth (par) ; 


This statement is inside the body of an if statement. If the value of par is true, then this statement is 
executed, causing the superclass version of the method named meth to be executed (passing the value 
of par as a parameter to the superclass method). When the method returns, the remaining code in the 
subclass version of the method is executed. 

If the value of par is false, the above statement is bypassed, and the superclass version of the method 
doesn’t get executed. In this case, only the code in the subclass version is executed. 


3.2.28.5 Summary 


I have discussed and illustrated the use of the this keyword in the following common situations: 


e To bypass local variables or parameters that hide member variables having the same name, in order to 
access the member variable. 

e To make it possible for one overloaded constructor to call another overloaded constructor in the same 
class. 

e To pass a reference to the current object to a method belonging to a different object (as in implementing 
callbacks, for example). 


I have also discussed and illustrated the use of the super keyword in the following situations: 


To bypass the overridden version of a method in a subclass and execute the version in the superclass. 
To bypass a member variable in a subclass in order to access a member variable having the same name 
in a superclass. 

e To cause a constructor in a subclass to call a parameterized constructor in the immediate superclass. 


3.2.28.6 What’s next? 


The next module in this collection will teach you how to use exception handling in Java. 


3.2.28.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: The this and super Keywords 
e File: Javal628.htm 

e Published: 08/08/13 

e Revised: 12/06/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 
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I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.2.29 Java1628s Slides” 
3.2.29.1 Table of Contents 


e Instructions for viewing slides (p. 457) 
e Miscellaneous (p. 457) 


3.2.29.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Javal628: The this and super Keywords "8 . 

Click here 7° to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.2.29.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Javal628s Slides: The this and super Keywords 
e File: Javal628s.htm 
e Published: 01/17/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 


“TThis content is available online at <http://cnx.org/content /m48932/1.2/>. 
“8http://cnx.org/content /m44201/latest /?collection=col1 1441 /latest 
“9http://cnx.org/content /m48932/latest /a0-Index.htm 
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compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.2.30 Javal630: Exception Handling” 
3.2.30.1 Table of Contents 


e Preface (p. 458) 
Viewing tip (p. 458) 

x Images (p. 458) 

x Listings (p. 459) 
Preview (p. 459) 
Discussion and sample code (p. 459) 
Summary (p. 482) 
What’s next? (p. 482) 
Miscellaneous (p. 482) 


3.2.30.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 


3.2.30.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.2.30.2.1.1 Images 


e Image 1 (p. 461) . Throwable constructors. 

e Image 2 (p. 462) . Methods of the Throwable class. 

e Image 3 (p. 466) . Compiler error from an unhandled checked exception. 
e Image 4 (p. 467) . Another compiler error. 

e Image 5 (p. 471) . Output from program that throws ArithmeticException. 
e Image 6 (p. 472) . Syntax of a try block. 

e Image 7 (p. 473) . Syntax of a catch block. 

e Image 8 (p. 476) . Output produced by the finally block. 

e Image 9 (p. 476) . Syntax for declaring that a method throws exceptions. 
e Image 10 (p. 477) . Example of a throw statement. 

e Image 11 (p. 479) . Output from the for loop. 

e Image 12 (p. 480) . Output from the exception handler. 

e Image 13 (p. 480) . Output from code following the catch block. 


8°This content is available online at <http://cnx.org/content /m44202/1.5/>. 
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3.2.30.2.1.2 Listings 


Listing 1 (p. 465) . Sample program with no exception handling code. 
Listing 2 (p. 466) . Sample program that fixes one compiler error. 
Listing 3 (p. 468) . Sample program that fixes the remaining compiler error. 


Listing 4 (p. 470) . A sample program that throws an exception. 
Listing 6 (p. 478) . The class named MyException. 
Listing 7 (p. 478) . The try block. 


( 
( 
( 
Listing 5 (p. 475) . The power of the finally block. 
( 
( 
( 
( 


) 
) 
Listing 8 (p. 479) . A matching catch block. 
Listing 9 (p. 480) . Code following the catch block. 
Listing 10 (p. 481) . Complete program listing for Excep16. 


3.2.30.3 Preview 


This module explains Exception Handling in Java. The discussion includes the following topics: 


What is an exception? 

How do you throw and catch exceptions? 

What do you do with an exception once you have caught it? 

How do you make use of the exception class hierarchy provided by the Java development environment? 


This module will cover many of the details having to do with exception handling in Java. By the end of the 
module, you should know that the use of exception handling is not optional in Java, and you should have a 
pretty good idea how to use exception handling in a beneficial way. 


3.2.30.4 Discussion and sample code 


Introduction 
Stated simply, the exception-handling capability of Java makes it possible for you to: 


Monitor for exceptional conditions within your program 
Transfer control to special exception-handling code (which you design) if an exceptional condition 
occurs 


The basic concept 
This is accomplished using the keywords: try , catch , throw , throws , and finally . The 
basic concept is as follows: 


You try to execute the statements contained within a block of code. (A block of code is a group of 
one or more statements surrounded by curly brackets.) 

If you detect an exceptional condition within that block, you throw an exception object of a specific 
type. 

You catch and process the exception object using code that you have designed. 

You optionally execute a block of code, designated by finally , which needs to be executed whether 
or not an exception occurs. (Code in the finally block is normally used to perform some type of 
cleanup.) 


Exceptions in code written by others 

There are also situations where you don’t write the code to throw the exception object, but an 
exceptional condition that occurs in code written by someone else transfers control to exception-handling 
code that you write. 
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For example, the read method of the InputStream class throws an exception of type IOException 
if an exception occurs while the read method is executing. In this case, you are responsible only for the 
code in the catch block and optionally for the code in the finally block. 

(This is the reason that you must surround the call to System.in.read() with a try block followed 
by a catch block, or optionally declare that your method throws an exception of type IOException 
; 

Exception hierarchy, an overview 

When an exceptional condition causes an exception to be thrown , that exception is represented by an 
object instantiated from the class named Throwable or one of its subclasses. 

Here is part of what Sun has to say about the Throwable class: 

"The Throwable class is the superclass of all errors and exceptions in the Java language. Only objects 
that are instances of this class (or one of its subclasses) are thrown by the Java Virtual Machine or can be 
thrown by the Java throw statement. Similarly, only this class or one of its subclasses can be the argument 
typeina catch clause." 

Sun goes on to say: 

"Instances of two subclasses, Error and Exception , are conventionally used to indicate that 
exceptional situations have occurred. Typically, these instances are freshly created in the context of the 
exceptional situation so as to include relevant information (such as stack trace data)." 

The Error and Exception classes 

The virtual machine and many different methods in many different classes throw exceptions and errors 
. I will have quite a lot more to say about the classes named Error and Exception later in this module. 

Defining your own exception types 

You may have concluded from the Sun quotation given above that you can define and throw exception 
objects of your own design, and if you did, that is a correct conclusion. (Your new class must extend 
Throwable or one of its subclasses.) 

The difference between Error and Exception 

As mentioned above, the Throwable class has two subclasses: 


e Error 
e Exception 


What is an error? 

What is the difference between an Error and an Exception ? Paraphrasing David Flanagan and 
his excellent series of books entitled Java in a Nutshell , an Error indicates that a non-recoverable error 
has occurred that should not be caught. Errors usually cause the Java virtual machine to display a message 
and exit. 

Sun says the same thing in a slightly different way: 

"An Error is asubclass of Throwable that indicates serious problems that a reasonable application 
should not try to catch. Most such errors are abnormal conditions." 

For example, one of the subclasses of Error is named VirtualMachineError . This error is "Thrown 
to indicate that the Java Virtual Machine is broken or has run out of resources necessary for it to continue 
operating. " 

What is an exception? 

Paraphrasing Flanagan again, an Exception indicates an abnormal condition that must be properly 
handled to prevent program termination. 

Sun explains it this way: 

"The class Exception and its subclasses are a form of Throwable that indicates conditions that a 
reasonable application might want to catch." 

As of JDK 1.4.0, there are more than fifty known subclasses of the Exception class. Many of these 
subclasses themselves have numerous subclasses, so there is quite a lot of material that you need to become 
familiar with. 

The RuntimeException class 
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One subclass of Exception is the class named RuntimeException As of JDK 1.4.0, this class has 
about 30 subclasses, many which are further subclassed. The class named RuntimeException is a very 
important class. 

Unchecked exceptions 

The RuntimeException class, and its subclasses, are important not so much for what they do, but 
for what they don’t do. I will refer to exceptions instantiated from RuntimeException and its subclasses 
as unchecked exceptions. 

Basically, an unchecked exception is a type of exception that you can optionally handle, or ignore. If you 
elect to ignore the possibility of an unchecked exception, and one occurs, your program will terminate as a 
result. If you elect to handle an unchecked exception and one occurs, the result will depend on the code that 
you have written to handle the exception. 

Checked exceptions 

All exceptions instantiated from the Exception class, or from subclasses of Exception other than 

RuntimeException and its subclasses must either be: 


e Handled with a try block followed by a catch block, or 
e Declared ina throws clause of any method that can throw them 


In other words, checked exceptions cannot be ignored when you write the code in your methods. According 
to Flanagan, the exception classes in this category represent routine abnormal conditions that should be 
anticipated and caught to prevent program termination. 

Checked by the compiler 

Your code must anticipate and either handle or declare checked exceptions. Otherwise, your program 
won’t compile. (These are exception types that are checked by the compiler.) 

Throwable constructors and methods 

As mentioned above, all errors and exceptions are subclasses of the Throwable class. As of JDK 1.4.0, 
the Throwable class provides four constructors and about a dozen methods. The four constructors are 
shown in Image 1 (p. 461) . 


Image 1 . Throwable constructors. 


Throwable() 

Throwable(String message) 
Throwable(String message,Throwable cause) 
Throwable(Throwable cause) 


Table 3.151 


The first two constructors have been in Java for a very long time. Basically, these two constructors allow 
you to construct an exception object with, or without a String message encapsulated in the object. 

New to JDK 1.4 

The last two constructors are new in JDK 1.4.0. These two constructors are provided to support the 

cause facility. The cause facility is new in release 1.4. It is also known as the chained exception 8! 

facility. (I won’t cover this facility in this module. Rather, I plan to cover it in a series of future modules.) 

Methods of the Throwable class 

Image 2 (p. 462) shows some of the methods of the Throwable class. (I omitted some of the methods 
introduced in JDK 1.4 for the reasons given above.) 


81http://softwaredev.earthweb.com/java/article/0,,12082 _1431531_ 1,00-html 
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Image 2 . Methods of the Throwable class. 


fillInStackTrace() 

getStackTrace() 

printStackTrace(). 
setStackTrace(StackTraceElement[] stackTrace) 


getLocalizedMessage() 
getMessage() 
toString() 


Table 3.152 


The Stack Trace 
The first four methods in Image 2 (p. 462) deal with the StackTrace . In case you are unfamiliar with 
the term StackTrace, this is a list of the methods executed in sequence that led to the exception. (This 
is what you typically see on the screen when your program aborts with a runtime error that hasn’t been 
handled.) 
Messages 
The two methods dealing with messages provide access to a String message that may be encapsulated 
in the exception object. The getMessage class simply returns the message that was encapsulated when 
the object was instantiated. (If no message was encapsulated, this method returns null.) 
The getLocalizedMessage method is a little more complicated to use. According to Sun, "Subclasses 
may override this method in order to produce a locale-specific message." 
The toString method 
The toString method is inherited from the Object class and overridden in the exception subclass 
to "return a short description of the Throwable ". 
Inherited methods 
All exception objects inherit the methods of the Throwable class, which are listed in Image 2 (p. 462) 
. Thus, any of these methods may be called by the code in the catch block in its attempt to successfully 
handle the exception. 
For example, exceptions may have a message encapsulated in the exception object, which can be accessed 
using the getMessage method. You can use this to display a message describing the error or exception. 
You can also use other methods of the Throwable class to: 


e Display a stack trace showing where the exception or error occurred 
e Produce a String representation of the exception object 


So, what is an exception? 

According to the online book entitled The Java Tutorial 8 by Campione and Walrath: 

"The term exception is shorthand for the phrase "exceptional event". It can be defined as follows: 
Definition: An exception is an event that occurs during the execution of a program that disrupts the 
normal flow of instructions." 

When an exceptional condition occurs within a method, the method may instantiate an exception object 
and hand it off to the runtime system to deal with it. This is accomplished using the throw keyword. 
(This is called throwing an exception.) 

To be useful, the exception object should probably contain information about the exception, including 
its type and the state of the program when the exception occurred. 


82 http://java.sun.com/docs/books/tutorial/ 
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Handling the exception 

At that point, the runtime system becomes responsible for finding a block of code designed to handle the 
exception. 

The runtime system begins its search with the method in which the exception occurred and searches 
backwards through the call stack until it finds a method that contains an appropriate exception handler 
(catch block). 

An exception handler is appropriate if the type of the exception thrown is the same as the type of 
exception handled by the handler, or is a subclass of the type of exception handled by the handler. 

Thus, the requirement to handle an exception that has been thrown progresses up through the call stack 
until an appropriate handler is found to handle the exception. If no appropriate handler is found, the runtime 
system and the program terminate. 

(If you have ever had a program terminate with a NullPointerException , then you know how 
program termination works). 

According to the jargon, the exception handler that is chosen is said to catch the exception. 

Advantages of using exception handling 

According to Campione and Walrath, exception handling provides the following advantages over "tradi- 

tional" error management techniques: 


e Separating Error Handling Code from "Regular" Code 
e Propagating Errors Up the Call Stack 
e Grouping Error Types and Error Differentiation 


Separating error handling code from regular code 

I don’t plan to discuss these advantages in detail. Rather, I will simply refer you to The Java Tutorial 
83 and other good books where you can read their discussions. However, I will comment briefly. 

Campione and Walrath provide a good illustration where they show how a simple program having about 
six lines of code get "bloated" into about 29 lines of very confusing code through the use of traditional error 
management techniques. Not only does the program suffer bloat, the logical flow of the original program 
gets lost in the clutter of the modified program. 

They then show how to accomplish the same error management using exception handling. Although the 
version with exception handling contains about seventeen lines of code, it is orderly and easy to understand. 
The additional lines of code do not cause the original logic of the program to get lost. 

You must still do the hard work 

However, the use of exception handling does not spare you from the hard work of detecting, reporting, 
and handling errors. What it does is provide a means to separate the details of what to do when something 
out-of-the-ordinary happens from the normal logical flow of the program code. 

Propagating exceptions up the call stack 

Sometimes it is desirable to propagate exception handling up the call stack and let the corrective action 
be taken at a higher level. 

For example, you might provide a class with methods that implement a stack . One of the methods of 
your class might be to pop an element off the stack. 

What should your program do if a using program attempts to pop an element off an empty stack? That 
decision might best be left to the user of your stack class, and you might simply propagate the notification 
up to the calling method and let that method take the corrective action. 

Grouping exception types 

When an exception is thrown, an object of one of the exception classes is passed as a parameter. Objects 
are instances of classes, and classes fall into an inheritance hierarchy in Java. Therefore, a natural hierarchy 
can be created, which causes exceptions to be grouped in logical ways. 

For example, going back to the stack example, you might create an exception class that applies to all 
exceptional conditions associated with an object of your stack class. Then you might extend that class into 


83http://java.sun.com/docs/books/tutorial/ 
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other classes that pertain to specific exceptional conditions, such as push exceptions, pop exceptions, and 
initialization exceptions. 

When your code throws an exception object of a specific type, that object can be caught by an exception 
handler designed either to: 


e Catch on the basis of a group of exceptions, or 
e Catch on the basis of a subgroup of that group, or 
e Catch on the basis of one of the specialized exceptions. 


In other words, an exception handler can catch exceptions of the class specified by the type of its parameter, 
or can catch exceptions of any subclass of the class specified by the type of its parameter. 

More detailed information on exception handling 

As explained earlier, except for Throwable objects of type Error and for Throwable.Exception 
objects of type RuntimeException , Java programs must either handle or declare all Exception 
objects that are thrown. Otherwise, the compiler will refuse to compile the program. 

In other words, all exceptions other than those specified above are checked by the compiler, and the 
compiler will refuse to compile the program if the exceptions aren’t handled or declared. As a result, 
exceptions other than those specified above are often referred to as checked exceptions. 

Catching an exception 

Just to make certain that we are using the same terminology, amethod catches an exception by providing 
an exception handler whose parameter type is appropriate for that type of exception object. (I will more 
or less use the terms catch block and exception handler interchangeably.) 

The type of the parameter in the catch block must be the class from which the exception was instan- 
tiated, or a superclass of that class that resides somewhere between that class and the Throwable class 
in the inheritance hierarchy. 

Declaring an exception 

If the code in a method can throw a checked exception, and the method does not provide an exception 
handler for the type of exception object thrown, the method must declare that it can throw that exception. 
The throws keyword is used in the method declaration to declare that it throws an exception of a 
particular type. 

Any checked exception that can be thrown by a method is part of the method’s programming interface 

(see the read method of the InputStream class, which throws IOException , for example). Users 
of a method must know about the exceptions that a method can throw in order to be able to handle them. 
Thus, you must declare the exceptions that the method can throw in the method signature. 

Checked exceptions 

Checked exceptions are all exception objects instantiated from subclasses of the Exception class other 
than those of the RuntimeException class. 

Exceptions of all Exception subclasses other than RuntimeException are checked by the compiler 
and will result in compiler errors if they are neither caught nor declared . 

You will learn how you can create your own exception classes later. Whether your exception objects 
become checked or not depends on the class that you extend when you define your exception class. 

(If you extend a checked exception class, your new exception type will be a checked exception. Otherwise, 
it will not be a checked exception.) 

Exceptions that can be thrown within the scope of a method 

The exceptions that can be thrown within the scope of a method include not only exceptions which are 
thrown by code written into the method, but also includes exceptions thrown by methods called by that 
method, or methods called by those methods, etc. 

According to Campione and Walrath, 

"This ... includes any exception that can be thrown while the flow of control remains within the method. 
Thus, this ... includes both exceptions that are thrown directly by the method with Java’s throw statement, 
and exceptions that are thrown indirectly by the method through calls to other methods." 

Sample programs 
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Now it’s time to take a look at some sample code designed to deal with exceptions of the types delivered 
with the JDK. Initially I won’t include exception classes that are designed for custom purposes. However, I 
will deal with exceptions of those types later in the module. 

The first three sample programs will illustrate the successive stages of dealing with checked exceptions 
by either catching or declaring those exceptions. 

Sample program with no exception handling code 

The first sample program shown in Listing 1 (p. 465) neither catches nor declares the InterruptedEx- 

ception which can be thrown by the sleep method of the Thread class. 


Listing 1 . Sample program with no exception handling code. 


/*File Excepi1.java 
Copyright 2002, R.G.Baldwin 
Tested using JDK 1.4.0 under Win2000 
FE A I I IO I IOI EE EEEE E EEEE EEEE EEEN 
import java.lang.Thread; 


class Excep1li{ 
public static void main( 
String[] args) { 
Excep11 obj = new Excep11(); 
obj .myMethod() ; 
}//end main 


void myMethod(){ 
Thread. currentThread().sleep(1000) ; 
}//end myMethod 
}//end class Excepi1 


Table 3.153 


A possible InterruptedException 

The code in the main method of Listing 1 (p. 465) calls the method named myMethod . The 
method named myMethod calls the method named sleep of the Thread class. The method named 
sleep declares that it throws InterruptedException 

InterruptedException is a checked exception. The program illustrates the failure to either catch or 
declare InterruptedException in the method named myMethod 

As a result, this program won’t compile. The compiler error is similar to that shown in Image 3 (p. 466) 
. Note the caret in the last line that points to the point where the compiler detected the problem. 


Image 3 . Compiler error from an unhandled checked exception. 


continued on next page 
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unreported exception 
java.lang.InterruptedException; 
must be caught or declared to be thrown 
Thread. currentThread().sleep(1000) ; 


Table 3.154 


As you can see, the compiler detected a problem where the sleep method was called, because the 
method named myMethod failed to deal properly with an exception that can be thrown by the sleep 
method. 

Sample program that fixes one compiler error 

The next version of the program, shown in Listing 2 (p. 466) , fixes the problem identified with the call 

tothe sleep method, by declaring the exception in the signature for the method named myMethod 


Listing 2 . Sample program that fixes one compiler error. 


/*File Excep12. java 
Copyright 2002, R.G.Baldwin 
Tested using JDK 1.4.0 under Win2000 
FEA I IO I IGA EE EEEE E EEEE EEEE EEEN 
import java.lang.Thread; 


class Excep12{ 
public static void main( 
String[] args) { 
Excep12 obj = new Excep12(); 
obj .myMethod() ; 
}//end main 


void myMethod() 
throws InterruptedException{ 
Thread. currentThread().sleep(1000) ; 
}//end myMethod 
}//end class Excep12 


Table 3.155 


Another possible InterruptedException 
As was the case in the previous program, this program also illustrates a failure to catch or declare an 


InterruptedException . However, in this case, the problem has moved up one level in the call stack 
relative to the problem with the program in Listing 1 (p. 465) . 


This program also fails to compile, producing a compiler error similar to that shown in Image 4 (p. 467) 
. Note that the caret indicates that the problem is associated with the call to myMethod 
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Image 4 . Another compiler error. 


unreported exception 
java.lang.InterruptedException; 
must be caught or declared to be thrown 
obj .myMethod() ; 


Table 3.156 


Didn’t solve the problem 

Simply declaring a checked exception doesn’t solve the problem. Ultimately, the exception must be 
handled if the compiler problem is to be solved. 

(Note, however, that it is possible to declare that the main method throws a checked exception, which 
will cause the compiler to ignore it and allow your program to compile.) 

The program in Listing 2 (p. 466) eliminated the compiler error identified with the call to the method 
named sleep . This was accomplished by declaring that the method named myMethod throws 
InterruptedException . However, this simply passed the exception up the call stack to the next higher-level 
method in the stack. This didn’t solve the problem, it simply handed it off to another method to solve. 

The problem still exists, and is now identified with the call to myMethod where it will have to be 
handled in order to make the compiler error go away. 

Sample program that fixes the remaining compiler error 

The version of the program shown in Listing 3 (p. 468) fixes the remaining compiler error. This program 

illustrates both declaring and handling a checked exception. This program compiles and runs successfully. 
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Listing 3 . Sample program that fixes the remaining compiler error. 


/*File Excep13.java 
Copyright 2002, R.G.Baldwin 


Tested using JDK 1.4.0 under Win2000 
FE AG IG I IO EE EEEE E EEEE EEEE EEEN 


import java.lang.Thread; 


class Excep13{ 
public static void main( 
String[] args) { 
Excep13 obj = new Excep13(); 
try{//begin try block 
obj .myMethod() ; 
}catch(InterruptedException e){ 
System.out .print1n( 
"Handle exception here"); 
}//end catch block 
}//end main 


void myMethod() 
throws InterruptedException{ 
Thread. currentThread().sleep(1000) ; 
}//end myMethod 
}//end class Excep13 


Table 3.157 


The solution to the problem 

This solution to the problem is accomplished by surrounding the call to myMethod witha try block, 
which is followed immediately by an appropriate catch block. In this case, an appropriate catch block is 
one whose parameter type is either InterruptedException , or a superclass of InterruptedException 


(Note, however, that the superclass cannot be higher than the Throwable class in the inheritance 

hierarchy. ) 

The myMethod method declares the exception 

As in the previous version, the method named myMethod (declares the exception and passes it up 
the call stack to the method from which it was called. 

The main method handles the exception 

In the new version shown in Listing 3 (p. 468) , the main method provides a try block with an 
appropriate catch block for dealing with the problem (although it doesn’t actually deal with it in any 
significant way). This can be interpreted as follows: 


Try to execute the code within the try block. 
If an exception occurs, search for a catch block that matches the type of object thrown by the 
exception. 

e Ifsucha catch block can be found, immediately transfer control to the catch block without executing 
any of the remaining code in the try block. 
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(For simplicity, this program didn’t have any remaining code. Some later sample programs will illustrate 

code being skipped due to the occurrence of an exception.) 

Not a method call 

Note that this transfer of control is not a method call. It is an unconditional transfer of control. There 
is no return from a catch block. 

Matching catch block was found 

In this case, there was a matching catch block to receive control. In the event that an Interrupt- 
edException is thrown, the program would execute the statement within the body of the catch block, 
and then transfer control to the code following the final catch block in the group of catch blocks (in 
this case, there was only one catch block). 

No output is produced 

It is unlikely that you will see any output when you run this program, because it is unlikely that an 
InterruptedException will be thrown. (I didn’t provide any code that will cause such an exception to 
occur.) 

A sample program that throws an exception 

Now let’s look at the sample program in Listing 4 (p. 470) , which throws an exception and deals with 
it. This program illustrates the implementation of exception handling using the try/catch block structure. 
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Listing 4 . A sample program that throws an exception. 


/*File Excep14. java 
Copyright 2002, R. G. Baldwin 


Tested with JDK 1.4.0 under Win2000 
FO CIC OR a ak kk ak kak ak / 


class Excep14{ 
public static void main( 
String[] args) { 
try{ 
for(int cnt = 2; cnt >-1; cnt--)f{ 
System. out. print1n( 
"Running. Quotient is: " 
+ 6/cnt); 
}//end for-loop 
}//end try block 
catch(ArithmeticException e){ 
System.out .print1n( 
"Exception message is: " 
+ e.getMessage() 
+ "\nStacktrace shows:"); 
e.printStackTrace() ; 
System.out .print1n( 
"String representation is\n " + 
e.toString()); 
System.out .print1n( 
"Put corrective action here"); 
}//end catch block 
System. out .print1n( 
"Out of catch block"); 
}//end main 


}//end class Excep14 


Table 3.158 


Keeping it simple 

I try to keep my sample programs as simple as possible, introducing the minimum amount of complexity 
necessary to illustrate the main point of the program. It is easy to write a really simple program that 
throws an unchecked ArithmeticException . Therefore, the program in Listing 4 (p. 470) was written 
to throw an ArithmeticException . This was accomplished by trying to perform an integer divide by 
zero. 

The try/catch structure is the same ... 

It is important to note that the try/catch structure illustrated in Listing 4 (p. 470) would be the same 
whether the exception is checked or unchecked. The main difference is that you are not required by the 
compiler to handle unchecked exceptions and you are required by the compiler to either handle or declare 
checked exceptions. 

Throwing an ArithmeticException 
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The code in Listing 4 (p. 470) executes a simple counting loop inside a try block. During each iteration, 
the counting loop divides the integer 6 by the value of the counter. When the value of the counter goes to 
zero, the runtime system tries to perform an integer divide by zero operation, which causes it to throw an 
ArithmeticException 

Transfer control immediately 

At that point, control is transferred directly to the catch block that follows the try block. This is 
an appropriate catch block because the type of parameter declared for the catch block is Arith- 
meticException . It matches the type of the object that is thrown. 

(It would also be appropriate if the declared type of the parameter were a superclass of ArithmeticEx- 
ception , up to and including the class named Throwable . Throwable is a direct subclass of Object 
. If you were to declare the parameter type for the catch block as Object , the compiler would produce 
an incompatible type error.) 

Calling methods inside the catch block 

Once control enters the catch block, three of the methods of the Throwable class are called to 
cause information about the situation to be displayed on the screen. The output produced by the program 
is similar to that shown in Image 5 (p. 471) . 


Image 5 . Output from program that throws ArithmeticException. 


Running. Quotient is: 3 
Running. Quotient is: 6 
Exception message is: / by zero 
Stacktrace shows: 
java.lang.ArithmeticException: 

/ by zero 

at Excep14.main(Excep14. java:35) 
String representation is 
java.lang.ArithmeticException: 
/ by zero 
Put corrective action here 
Out of catch block 


Table 3.159 


Key things to note 
The key things to note about the code in Listing 4 (p. 470) and the output in Image 5 (p. 471) are: 


The code to be protected is contained in a try block. 
The try block is followed immediately by an appropriate catch block. 
When an exception is thrown within the try block, control is transferred immediately to the catch 
block with the matching or appropriate parameter type. 

e Although the code in the catch block simply displays the current state of the program, it could 
contain code that attempts to rectify the problem. 

e Once the code in the catch block finishes executing, control is passed to the next executable statement 
following the catch block, which in this program is a print statement. 


Doesn’t attempt to rectify the problem 

This program doesn’t attempt to show how an actual program might recover from an exception of this 
sort. However, it is clear that (rather than experiencing automatic and unconditional termination) the 
program remains in control, and in some cases, recovery might be possible. 
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This sample program illustrates try and catch . The use of finally , will be discussed and illustrated 
later. 

A nuisance problem explained 

While we are at it, I would be remiss in failing to mention a nuisance problem associated with exception 
handling. 

As you may recall, the scope of a variable in Java is limited to the block of code in which it is declared. 
A block is determined by enclosing code within a pair of matching curly brackets: {...}. 

Since a pair of curly brackets is required to define a try block, the scope of any variables or objects 
declared inside the try block is limited to the try block. 

While this is not an insurmountable problem, it may require you to modify your programming style in 
ways that you find distasteful. In particular, if you need to access a variable both within and outside the 
try block, you must declare it before entering the try block. 

The process in more detail 

Now that you have seen some sample programs to help you visualize the process, lets discuss the process 
in more detail. 

The try block 

According to Campione and Walrath, 

"The first step in writing any exception handler is putting the Java statements within which an exception 
can occur into a try block. The try block is said to govern the statements enclosed within it and defines the 
scope of any exception handlers (established by subsequent catch blocks) associated with it." 

Note that the terminology being used by Campione and Walrath treats the catch block asthe "excep- 
tion handler" and treats the try block as something that precedes one or more exception handlers. I don’t 
disagree with their terminology. I mention it only for the purpose of avoiding confusion over terminology. 

The syntax of a try block 

The general syntax of a try block, as you saw in the previous program, has the keyword try followed 
by one or more statements enclosed in a pair of matching curly brackets, as shown in Image 6 (p. 472) . 


Image 6 . Syntax of a try block. 


try{ 
//java statements 
}//end try block 


Table 3.160 


Single statement and multiple exceptions 
You may have more than one statement that can throw one or more exceptions and you will need to deal 
with all of them. 
You could put each such statement that might throw exceptions within its own try block and provide 
separate exception handlers for each try block. 
(Note that some statements, particularly those that call other methods, could potentially throw many 
different types of exceptions. ) 
Thus a try block consisting of a single statement might require many different exception handlers or 
catch blocks following it. 
Multiple statements and multiple exceptions 
You could put all or several of the statements that might throw exceptions within a single try block 
and associate multiple exception handlers with it. There are a number of practical issues involved here, and 
only you can decide in any particular instance which approach would be best. 
The catch blocks must follow the try block 
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However you decide to do it, the exception handlers associated with a try block must be placed 
immediately following their associated try block. If an exception occurs within the try block, that 
exception is handled by the appropriate exception handler associated with the try block. If there is no 
appropriate exception handler associated with the try block, the system attempts to find an appropriate 
exception handler in the next method up the call stack. 

A try block must be accompanied by at least one catch block (or one finally block). Otherwise, 
a compiler error that reads something like ’try’ without ’catch’ or ‘finally’ will occur. 

The catch block(s) 

Continuing with what Campione and Walrath have to say: 

"Next, you associate exception handlers with a try block by providing one or more catch blocks directly 
after the try block." 

There can be no intervening code between the end of the try block and the beginning of the first 
catch block, and no intervening code between catch blocks. 

Syntax of a catch block 
The general form of a catch block is shown in Image 7 (p. 478) . 


Image 7 . Syntax of a catch block. 


catch(ThrowableObjectType paramName) { 
//Java statements to handle the 
// exception 
}//end catch block 


Table 3.161 


The declaration for the catch block requires a single argument as shown. The syntax for the argument 
declaration is the same as an argument declaration for a method. 

Argument type specifies type of matching exception object 

The argument type declares the type of exception object that a particular catch block can handle. The 
type must be Throwable , or a subclass of the Throwable class discussed earlier. 

A parameter provides the local name 

Also, as in a method declaration, there is a parameter, which is the name by which the handler can refer 
to the exception object. For example, in an earlier program, I used statements such as e.getMessage() to 
access an instance method of an exception object caught by the exception handler. In that case, the name 
of the parameter was e 

You access the instance variables and methods of exception objects the same way that you access the 
instance variables and methods of other objects. 

Proper order of catch blocks 

According to Campione and Walrath: 

"The catch block contains a series of legal Java statements. These statements are executed if and when 
the exception handler is called. The runtime system calls the exception handler when the handler is the first 
one in the call stack whose type matches that of the exception thrown." 

Therefore, the order of your exception handlers is very important, particularly if you have some handlers, 
which are further up the exception hierarchy than others. 

Those handlers that are designed to handle exception types furthermost from the root of the hierarchy 
tree ( Throwable ) should be placed first in the list of exception handlers. 

Otherwise, an exception handler designed to handle a specific type of object may be preempted by another 
handler whose exception type is a superclass of that type, if the superclass exception handler appears earlier 
in the list of exception handlers. 
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Catching multiple exception types with one handler 

Exception handlers that you write may be more or less specialized. In addition to writing handlers for 
very specialized exception objects, the Java language allows you to write general exception handlers that 
handle multiple types of exceptions. 

A hierarchy of Throwable classes 

Java exceptions are Throwable objects (instances of the Throwable class or a subclass of the 
Throwable class). 

The Java standard library contains numerous classes that are subclasses of Throwable and thus build 
a hierarchy of Throwable classes. 

According to Campione and Walrath: 

"Your exception handler can be written to handle any class that inherits from Throwable . If you 
write a handler for a "leaf" class (a class with no subclasses), you’ve written a specialized handler: it will only 
handle exceptions of that specific type. If you write a handler for a "node" class (a class with subclasses), 
you’ve written a general handler: it will handle any exception whose type is the node class or any of its 
subclasses. " 

You have a choice 

Therefore, when writing exception handlers, you have a choice. You can write a handler whose exception 
type corresponds to a node in the inheritance hierarchy, and it will be appropriate to catch exceptions of 
that type, or any subclass of that type. 

Alternately, you can write a handler whose exception type corresponds to a leaf, in which case, it will 
be appropriate to catch exceptions of that type only. 

And finally, you can mix and match, writing some exception handlers whose type corresponds to a node, 
and other exception handlers whose type corresponds to a leaf. In all cases, however, be sure to position 
your exception handlers in reverse subclass order, with the furthermost subclass from the root appearing 
first, and the root class appearing last. 

The finally block 

And finally (no pun intended), Campione and Walrath tell us: 

"Java’s finally block provides a mechanism that allows your method to clean up after itself regardless of 
what happens within the try block. Use the finally block to close files or release other system resources." 

To elaborate, the finally block can be used to provide a mechanism for cleaning up open files, etc., 
before allowing control to be passed to a different part of the program. You accomplish this by writing the 
cleanup code within a finally block. 

Code in finally block is always executed 

It is important to remember that the runtime system always executes the code within the finally block 
regardless of what happens within the try block. 

If no exceptions are thrown, none of the code in catch blocks is executed, but the code in the finally 
block is executed. 

If an exception is thrown and the code in an exception handler is executed, once the execution of that 
code is complete, control is passed to the finally block and the code in the finally block is executed. 

(There is one important exception to the above. If the code in the catch block terminates the program 
by executing System.exit(0) , the code in the finally block will not be executed.) 

The power of the finally block 

The sample program shown in Listing 5 (p. 475) illustrates the power of the finally block. 


Listing 5 . The power of the finally block. 


continued on next page 
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/*File Excep15.java 
Copyright 2002, R. G. Baldwin 


Tested with JDK 1.4.0 under Win2000 


EEEE EEEE EEEE EEEE EEEE EEEE EEEE EEEE EE EE ake // 


class Excep15{ 
public static void main( 
String[] args){ 
new Excep15().aMethod(); 
}//end main 


void aMethod(){ 

try{ 
int x = 5/0; 

}//end try block 

catch(ArithmeticException e){ 
System.out .print1n( 
"In catch, terminating aMethod") ; 
return; 

}//end catch block 


finallyf 
System.out .print1n( 
"Executing finally block"); 
}//end finally block 


System. out. print1n( 
"Out of catch block"); 
}//end aMethod 


}//end class Excep15 


Table 3.162 


Execute return statement in catch block 


The code in Listing 5 (p. 475) forces an ArithmeticException by attempting to do an integer divide 


by zero. Control is immediately transferred to the matching catch block, which prints a message and then 
executes a return statement. 


Normally, execution of a return statement terminates the method immediately. In this case, however, 
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before the method terminates and returns control to the calling method, the code in the finally block is 
executed. Then control is transferred to the main method, which called this method in the first place. 
Image 8 (p. 476) shows the output produced by this program. 
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Image 8 . Output produced by the finally block. 


In catch, terminating aMethod 
Executing finally block 


Table 3.163 


This program demonstrates that the finally block really does have the final word. 
Declaring exceptions thrown by a method 

Sometimes it is better to handle exceptions in the method in which they are detected, and sometimes it 
is better to pass them up the call stack and let another method handle them. 

In order to pass exceptions up the call stack, you must declare them in your method signature. 

To declare that a method throws one or more exceptions, you add a throws clause to the method 
signature for the method. The throws clause is composed of the throws keyword followed by a 
comma-separated list of all the exceptions thrown by that method. 

The throws clause goes after the method name and argument list and before the curly bracket that 
defines the scope of the method. 

Image 9 (p. 476) shows the syntax for declaring that a method throws four different types of exceptions. 


Image 9 . Syntax for declaring that a method throws exceptions. 


void myMethod() throws 

InterruptedException, 
MyException, 
HerException, 
UrException 

{ 

//method code 
}//end myMethod() 


Table 3.164 


Assuming that these are checked exceptions, any method calling this method would be required to either 
handle these exception types, or continue passing them up the call stack. Eventually, some method must 
handle them or the program won’t compile. 

(Note however that while it might not represent good programming practice, it is allowable to declare 
that the main method throws exceptions. This is a way to avoid handling checked exceptions and still 
get your program to compile.) 

The throw keyword 

Before your code can catch an exception, some Java code must throw one. The exception can be 
thrown by code that you write, or by code that you are using that was written by someone else. 

Regardless of who wrote the code that throws the exception, it’s always thrown with the Java throw 
keyword. At least that is true for exceptions that are thrown by code written in the Java language. 

(Exceptions such as ArithmeticException are also thrown by the runtime system, which is probably 
not written using Java source code.) 

A single argument is required 
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When formed into a statement, the throw keyword requires a single argument, which must be a 
reference to an object instantiated from the Throwable class, or any subclass of the Throwable class. 
Image 10 (p. 477) shows an example of such a statement. 


Image 10 . Example of a throw statement. 


throw new myThrowableClass ("Message") ; 


Table 3.165 


If you attempt to throw an object that is not instantiated from Throwable or one of its subclasses, 

the compiler will refuse to compile your program. 
Defining your own exception classes 

Now you know how to write exception handlers for those exception objects that are thrown by the runtime 
system, and thrown by methods in the standard class library. 

It is also possible for you to define your own exception classes, and to cause objects of those classes to be 
thrown whenever an exception occurs. In this case, you get to decide just what constitutes an exceptional 
condition. 

For example, you could write a data-processing application that processes integer data obtained via a 
TCP/IP link from another computer. If the specification for the program indicates that the integer value 10 
should never be received, you could use an occurrence of the integer value 10 to cause an exception object 
of your own design to be thrown. 

Choosing the exception type to throw 
Before throwing an exception, you must decide on its type. Basically, you have two choices in this regard: 


e Use an exception class written by someone else, such as the myriad of exception classes defined in the 
Java standard library. 
e Define an exception class of your own. 


An important question 

So, an important question is, when should you define your own exception classes and when should you 
use classes that are already available. Because this is only one of many design issues, I’m not going to try 
to give you a ready answer to the question. However, I will refer you to The Java Tutorial °4 by Campione 
and Walrath where you will find a checklist to help you make this decision. 

Choosing a superclass to extend 

If you decide to define your own exception class, it must be a subclass of Throwable . You must decide 
which class you will extend. 

The two existing subclasses of Throwable are Exception and Error . Given the earlier description 
of Error and its subclasses, it is not likely that your exceptions would fit the Error category. (In 
concept, errors are reserved for serious hard errors that occur deep within the system.) 

Checked or unchecked exception 

Therefore, your new class should probably be a subclass of Exception . If you make it a subclass of 
RuntimeException , it won’t be a checked exception. If you make it a subclass of Exception , but not 
a subclass of RuntimeException , it will be a checked exception. 

Only you can decide how far down the Exception hierarchy you want to go before creating a new 
branch of exception classes that are unique to your application. 

Naming conventions 

Many Java programmers append the word Exception to the end of all class names that are subclasses 

of Exception , and append the word Error to the end of all class names that are subclasses of Error . 


§4http://java.sun.com/docs/books/tutorial/ 
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One more sample program 

Let’s wrap up this module with one more sample program named Excep16 . We will define our own 
exception class in this program. Then we will throw , catch and process an exception object instantiated 
from that class. 

Discuss in fragments 

This program is a little longer than the previous programs, so I will break it down and discuss it in 
fragments. A complete listing of the program is shown in Listing 10 (p. 481) . 

The class definition shown in Listing 6 (p. 478) is used to construct a custom exception object that 
encapsulates a message. Note that this class extends Exception . (Therefore, it is a checked exception.) 


Listing 6 . The class named MyException . 


class MyException extends Exception{ 
MyException(String message) {//constr 
super (message) ; 
}//end constructor 
}//end MyException class 


Table 3.166 


The constructor for this class receives an incoming String message parameter and passes it to the 
constructor for the superclass. This makes the message available for access by the getMessage method 
called in the catch block. 

The try block 
Listing 7 (p. 478) shows the beginning of the main method, including the entire try block 


Listing 7 . The try block. 


class Excepi6{//controlling class 
public static void main( 
String[] args) { 
try{ 
for(int cnt = 0; cnt < 5; cnt++)f{ 
//Throw a custom exception, and 
// pass message when cnt == 
if(cnt == 3) throw 
new MyException("3") ; 
//Transfer control before 
// processing for cnt == 
System. out. print1n( 
"Processing data for cnt = 
+ cnt); 


}//end for-loop 
}//end try block 


Table 3.167 
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The main method executes a for loop (inside the try block) that guarantees that the variable 


named cnt will reach a value of 3 after a couple of iterations. 
Once during each iteration, (until the value of cnt reaches 3) a print statement inside the for loop 


displays the value of cnt . This results in the output shown in Image 11 (p. 479) . 


Image 11 . Output from the for loop. 


Processing data for cnt = 0 
Processing data for cnt = 1 
Processing data for cnt = 2 


Table 3.168 


What happens when cnt equals 3? 

However, when the value of cnt equals 3, the throw statement in Listing 7 (p. 478) is executed. This 
causes control to transfer immediately to the matching catch block following the try block (see Listing 
8 (p. 479) ). During this iteration, the print statement following the throw statement is not executed. 
Therefore, the output never shows a value for cnt greater than 2, as shown in Image 11 (p. 479) . 

The catch block 
Listing 8 (p. 479) shows a catch block whose type matches the type of exception thrown in Listing 7 


(p. 478) . 


Listing 8 . A matching catch block. 


catch(MyException e){ 
System.out .print1n( 
"In exception handler, " 
+ "get the message\n" 
+ e.getMessage()); 
}//end catch block 


Table 3.169 


When the throw statement is executed in Listing 7 (p. 478) , control is transferred immediately to the 

catch block in Listing 8 (p. 479) . No further code is executed within the try block. 

A reference to the object instantiated as the argument to the throw keyword in Listing 7 (p. 478) is 
passed as a parameter to the catch block. That reference is known locally by the name e inside the 
catch block. 

Using the incoming parameter 

The code in the catch block calls the method named getMessage (inherited from the Throwable 

class) on the incoming parameter and displays that message on the screen. This produces the output shown 


in Image 12 (p. 480) . 
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Image 12 . Output from the exception handler. 


In exception handler, get the message 


Table 3.170 


When the catch block finishes execution ... 
When the code in the catch block has completed execution, control is transferred to the first executable 
statement following the catch block as shown in Listing 9 (p. 480) . 


Listing 9 . Code following the catch block. 


System. out. print1n( 
"Out of catch block"); 
}//end main 
}//end class Excep16 


Table 3.171 


That executable statement is a print statement that produces the output shown in Image 13 (p. 480) . 


Image 13 . Output from code following the catch block. 


Out of catch block 


Table 3.172 


Complete program listing 
A complete listing of the program named Excep16 is shown in Listing 10 (p. 481) . 
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Listing 10 . Complete program listing for Excep16. 


/*File Excep16.java 
Copyright 2002, R. G. Baldwin 
Illustrates defining, throwing, 
catching, and processing a custom 
exception object that contains a 
message. 


Tested using JDK 1.4.0 under Win 2000 


The output is: 


Processing data for cnt = 0 
Processing data for cnt = 1 
Processing data for cnt = 2 


In exception handler, get the message 

3 

Out of catch block 

LEE EEEE EEEE EE EEEE EEEE EE E EE EEE EEE E E E E 34 E / 


//The following class is used to 

// construct a customized exception 

// object containing a message 

class MyException extends Exception{ 
MyException(String message) {//constr 

super (message) ; 

}//end constructor 

}//end MyException class 


class Excepi6{//controlling class 
public static void main( 
String[] args) { 
try{ 
for(int cnt = 0; cnt < 5; cnt++)f{ 
//Throw a custom exception, and 
// pass message when cnt == 
if(cnt == 3) throw 
new MyException("3") ; 
//Transfer control before 
// processing for cnt == 
System. out. print1n( 
"Processing data for cnt = " 
+ cnt); 
}//end for-loop 
}//end try block 
catch(MyException e){ 
System.out .print1n( 
"In exception handler, " 
+ "get the message\n" 
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Table 3.173 


3.2.30.5 Summary 


This module has covered many of the details having to do with exception handling in Java. By now, you 
should know that the use of exception handling is not optional in Java, and you should have a pretty good 


idea how to use exception handling in a beneficial way. 
Along the way, the discussion has included the following topics: 


What is an exception? 
How do you throw and catch exceptions? 
What do you do with an exception once you have caught it? 


How do you make use of the exception class hierarchy provided by the Java development environment? 


3.2.30.6 What’s next? 


That concludes the "Essence of OOP" portion of the ITSE 2321 sub-collection. The series is continued in 


the ITSE 2317 sub-collection. 


3.2.30.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Exception Handling 
e File: Java1630.htm 

e Published: 09/03/02 

e Revised: 12/06/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.3 Multimedia 


3.3.1 Java3000: The Guzdial-Ericson Multimedia Class Library” 
3.3.1.1 Table of Contents 


Preface (p. 483) 
Images and listings (p. 483) 


Images (p. 483) 
Listings (p. 484) 


Preview (p. 484) 
Discussion (p. 495) 
Two versions of Hello World (p. 497) 


A text version of Hello World (p. 497) 
A graphic version of Hello World (p. 498) 


e Miscellaneous (p. 500) 


3.3.1.2 Preface 


I have published a large number of modules that use a multimedia class library developed and made available 
by Mark Guzdial °° and Barbara Ericson 8” of the Georgia Institute of Technology. The purpose of this 
module is to provide the information that you will need to obtain and use a copy of that library. 

If you find that you don’t understand the material in this module, you probably need to go back and 
review the material in the following earlier modules: 


e Jb0110: Java OOP: Programming Fundamentals, Getting Started 88 
e Jb0110r Review 8° 
e Jb0115: Java OOP: First Program °° 


In addition, you may find it useful to search the web for and study a few tutorials on the Windows "command 
prompt" as well as a few tutorials on Windows batch files. Here are a couple of possibilities that I found 
with a rudimentary search: 


e Windows Command Prompt in 15 Minutes °! 
e Windows Batch Scripting: Getting Started % 


If you are using a different operating system, you will need to find similar tutorials that match up with the 
operating system that you are using. 

3.3.1.3 Images and listings 

3.3.1.3.1 Images 


e Image 1 (p. 487) . Result of merging two images. 
e Image 2 (p. 491) . Input image #1. 


85This content is available online at <http://cnx.org/content/m44148/1.11/>. 
86http://www.cc.gatech.edu/~guzdial/ 

87http://coweb.cc.gatech.edu/ice-gt/8 
88http://cnx.org/contents/920d091d-ea72-478f-986f-eab814c2d992 
8®http://cnx.org/contents/6d86f0£3-bd le-4a3d-b339-1c98154dfa64 
*°http://cnx.org/contents/b2760098-4 1f2-4b62-bb27-38005881c827 
®lhttp://www.cs.princeton.edu /courses/archive/spr05/cos126/cmd-prompt-html 
®2http://steve-jansen.github.io/guides/windows-batch-scripting/part-1-getting-started-html 
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e Image 3 (p. 495) . Input image #2. 

e Image 4 (p. 496) . Putting the library on the classpath. 

e Image 5 (p. 497) . Batch file for text version of Hello World. 

e Image 6 (p. 499) . Hello World in graphics. 

e Image 7 (p. 500) . Batch file for graphic version of Hello World. . 


3.3.1.3.2 Listings 


e Listing 1 (p. 497) . A text version of Hello World. 
e Listing 2 (p. 498) . A graphic version of Hello World. 


3.3.1.4 Preview 


Among other things, the Guzdial-Ericson multimedia class library makes it practical to write object-oriented 
programs for the manipulation of images in an interesting and educational way. For example, the image in 
Image 1 (p. 487) was produced by manipulating and merging the images shown in Image 2 (p. 491) and 
Image 3 (p. 495) . 


R: 119 G: 100 B: 100 Color at location: Ba 


lame here. 
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Image 1 . Result of merging two images. 


R: 119 G: 100 B: 100 Color at location: By 


f Your name here. 


Table 3.174 


One of the input images is shown in Image 2 (p. 491) . 
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Image 2 . Input image #1. 


) | 
| 
| 
| 
| 


Table 3.175 


The other input image is shown in Image 3 (p. 495) . 
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Image 3 . Input image #2. 


x| 
Take Picture | 


Table 3.176 


3.3.1.5 Discussion 


The Guzdial-Ericson library was originally published by Guzdial and Ericson in conjunction with their book 
Introduction to Computing and Programming with Java: A Multimedia Approach °? . While the book isn’t 
free, the library is freely available and is published under a Creative Commons Attribution 3.0 United States 
License ™ . 

As of July, 2012, the latest version of the library can be downloaded in a zip file named bookClasses- 
3-9-10-with-doc.zip at http://home.cc.gatech.edu/TeaParty/47. °° Additional information is available 
at http://coweb.cc.gatech.edu/mediaComp-plan/101 °° . 

Download the library 

In order to work with the programs in the modules that use the library, you will need to download a 
copy of the latest version of the library from the site listed above. To guard against the possibility of that 
link becoming broken at some point in the future, I am depositing a backup copy of the zip file containing 
the library on the cnx.org site and you can download it here 9%” . 


°3http://www.pearsonhighered.com/educator/academic/product/0,3110,0131496980,00.html 
°4http://creativecommons.org/licenses/by /3.0/us/ 
®*5http://home.cc.gatech.edu/TeaParty /47. 
*6http://coweb.cc.gatech.edu/mediaComp-plan/101 
®Thttp://cnx.org/content /m44148 /latest /bookClasses-3-9-10-with-doc.zip 
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Prepare the library for use 

Once you have downloaded the zip file, you will need to extract the folder named bookClasses from 
the zip file and store it somewhere on your computer’s disk. 

Library documentation 

When you examine the contents of the bookClasses folder, you will see that in addition to source code 
and compiled class files for the library, the folder also contains javadoc documentation for the library in 
a folder named doc and some other material as well. Go to the doc folder and open the file named 
index.html in your browser to view the documentation. 

Put the library on the classpath 

You will need to put the path to the bookClasses folder on your classpath in order to incorporate 
classes from the library into your programs. 


Image 4 . Putting the library on the classpath. 


del *.class 
javac -cp .;M:\bookClasses *.java 
java -cp .;M:\bookClasses Prob01 


Table 3.177 


For example, Image 4 (p. 496) shows three commands that you can execute at a Windows command 
prompt to 


e delete the class files from the current folder or current directory — Google current directory if you 
don’t recognize the term, 
compile the source-code files in the current folder , and 
execute the compiled version of a program named Prob01 in the current folder 


(The commands shown in Image 4 (p. 496) assume that the bookClasses folder is in the 
root directory on the M-drive. The bookClasses folder will likely be in a different location 
on your computer. They also assume that you are compiling and running a program having its 
main method in a class named Prob01 ina file named ProbO1.java_ .) 


Be sure to include the period and the semicolon shown before the M in Image 4 (p. 496) . This tells the 
Java compiler and the Java Virtual Machine to search first in the current folder before searching elsewhere 
on the disk for the required files. 

You can also put the three commands in a batch file and run the batch file to avoid having to type the 
three commands each time you need to compile and run the program. In that case, you should add a pause 
command following the other three commands. 


(Note that this batch file must be placed in the same folder that contains the file named 
ProbOl.java_, and that folder must be your "current directory. DO NOT attempt to 
execute the commands shown in Image 4 (p. 496) from inside the bookClasses folder." 


If you are using an IDE such as DrJava, JCreator, or JGrasp, see the instructions for the IDE to learn how 
to set the classpath in the IDE. 
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3.3.1.6 Two versions of Hello World 


It is often useful to have the code for a simple program to test your system. This section presents two 
versions of the classical Hello World program. The first version is a simple text version that doesn’t use 
Ericson’s library. This version can be used to confirm that the Java Development Kit (JDK) is properly 
installed on your computer. 

The second version is a graphic version that does require Ericson’s library. This version can be used to 
confirm proper installation and use of the library. 


3.3.1.6.1 A text version of Hello World 


The simple program shown in Listing 1 (p. 497) causes the words Text Hello World to be displayed 
on the standard output device when the program is compiled and executed. 


Listing 1 . A text version of Hello World. 


class TextHelloWorld{ 
public static void main(String[] args){ 
System.out.println("Text Hello World"); 
}//end main 
}//end class 


Table 3.178 


As mentioned above, this program does not require the use of Ericson’s library. It can be compiled and 
executed using a batch file containing the commands shown in Image 5 (p. 497) . You should make certain 
that you can compile and execute this program before progressing to the graphic version. 


(Note that this batch file must be placed in the same folder that contains the file named 
TextHelloWorld.java _, and that folder must be your "current directory." 


Also note that the term "-cp . " (note the space followed by a period) is probably superfluous 
on most computers. According to PATH and CLASSPATH °° , "The default value of the 
classpath is "." (note the period), meaning that ..." 


Therefore, it should not be necessary to specify the classpath as "-cp . " to compile and execute 
the program on most computers. However, on 09/10/14, I encountered a student’s computer that 
did not comply with the default described above and this prevented the student from being able 
to compile and execute the program. Including "-cp . "in the javac and java commands 
doesn’t cause any harm. Therefore, I have updated the batch file commands shown in Image 5 
(p. 497) to include it. You can omit it if your computer doesn’t need it.) 


Image 5 . Batch file for text version of Hello World. 


continued on next page 


*8http://docs.oracle.com/javase/tutorial/essential /environment/paths.html 
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echo off 

del *.class 

javac -cp . TextHelloWorld.java 
java -cp . TextHelloWorld 

pause 


Table 3.179 


3.3.1.6.2 A graphic version of Hello World 


Listing 2 (p. 498) contains the code for a graphic version of Hello World. 


Listing 2 . A graphic version of Hello World. 


import java.awt.Color; 


class GraphicHelloWorld{ 
public static void main(String[] args){ 
Picture pix = new Picture(200,100); 
pix.setAl1PixelsToAColor(Color.RED) ; 
pix.addMessage("Graphic Hello World",15,50); 
pix.show() ; 
}// end main 
}//end class 


Table 3.180 


The program shown in Listing 2 (p. 498) causes the image shown in Image 6 (p. 499) to be displayed 
when the program is compiled and executed. 


Graphic Hello World 
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Graphic Hello World 


Image 6 . Hello World in graphics. 


Graphic Hello World 


Table 3.181 


As mentioned above, this program does require the use of Ericson’s library. It can be compiled and 
executed using a batch file containing the commands shown in Image 7 (p. 500) . You should make certain 
that you can compile and execute this program before progressing to more complex programs involving 
Ericson’s library. 


(Note that this batch file must be placed in the same folder that contains the file named 
GraphicHelloWorld.java_, and that folder must be your "current directory." 
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Image 7 . Batch file for graphic version of Hello World. . 


echo off 


del *.class 

javac -cp .;M:\bookClasses GraphicHelloWorld. java 
java -cp .;M:\bookClasses GraphicHelloWorld 

pause 


Table 3.182 


(Once again, the commands shown in Image 7 (p. 500) assume that the bookClasses 
folder is in the root directory on the M-drive. The bookClasses folder will likely be in a 
different location on your computer.) 


3.3.1.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: The Guzdial-Ericson Multimedia Class Library 
e File: Java3000.htm 

e Published: 07/27/12 

e Revised: 09/02/15 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have misappropriated copies of my modules from cnx.org, con- 
verted them to Kindle books, and placed them for sale on Amazon.com showing me as the author. 
I receive no compensation for those sales and don’t know who does receive compensation. If you 
purchase such a book, please be aware that it is a bootleg copy of a module that is freely available 
on cnx.org. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.3.2 Java3000r Review” 
3.3.2.1 Table of Contents 


e Preface (p. 501) 
e Questions (p. 501) 


1 (p. 501) , 2 (p. 501) , 3 (p. 501) , 4 (p. 501) , 5 (p. 501) , 6 (p. 502) , 7 (p. 502) , 8 (p. 502) , 
9 (p. 502) , 10 (p. 502) , 11 (p. 503) , 12 (p. 504) 


Images (p. 505) 
Listings (p. 505) 
Answers (p. 506) 
Miscellaneous (p. 508) 


3.3.2.2 Preface 


This module contains review questions and answers keyed to the module titled Java3000: The Guzdial- 
Ericson Multimedia Class Library 10° . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.2.3 Questions 

3.3.2.3.1 Question 1 

True or false? The multimedia library used in this course originated at MIT. 
Answer 1 (p. 508) 


3.3.2.3.2 Question 2 


True or false? Among other things, the Guzdial-Ericson multimedia class library makes it practical to write 
object-oriented programs for the manipulation of images in an interesting and educational way. 
Answer 2 (p. 508) 


3.3.2.3.3 Question 3 


True or false? The textbook for the course is available at no cost. 
Answer 3 (p. 508) 


3.3.2.3.4 Question 4 


True or false? Once you have downloaded the zip file containing the library, you will need to extract the 
folder named MediaComp from the zip file and store it somewhere on your computer’s disk. 
Answer 4 (p. 507) 


3.3.2.3.5 Question 5 


True or false? The bookClasses folder contains javadoc documentation for the library in a folder 
named doc . You can view the documentation by going to the doc folder and opening the file named 
index.html in your browser. 

Answer 5 (p. 507) 


99This content is available online at <http://cnx.org/content /m45761/1.5/>. 
100http://cnx.org/content /m44148 
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3.3.2.3.6 Question 6 


True or false? You will need to put the path to the bookClasses folder on your path in order to 
incorporate classes from the library into your programs. 
Answer 6 (p. 507) 


3.3.2.3.7 Question 7 


True or false? Commands similar to those shown in Listing 1 (p. 502) can be used to put the bookClasses 
library on the classpath : 


Listing 1 . Question 7. 


javac -cp .;M:\bookClasses *.java 
java -cp .;M:\bookClasses Prob01 


Table 3.183 
Answer 7 (p. 507) 


3.3.2.3.8 Question 8 
True or false? Commands similar to those shown in Listing 2 (p. 502) can be used to: 


e delete the class files from the current folder, 
e compile the source-code files in the current folder, and 
e execute the compiled version of a program named Prob0O1 in the current folder 


Listing 2 . Question 8. 


del *.class 
javac -cp .;M:\bookClasses *.java 
java -cp .;M:\bookClasses Prob01 


Table 3.184 


Answer 8 (p. 507) 


3.3.2.3.9 Question 9 


True or false? You can put commands in a batch file and run the batch file to avoid having to type the 
commands each time you need to perform a specific operation from the command line. In that case, you 
should add a pause command as the last command in the sequence. 

Answer 9 (p. 507) 


3.3.2.3.10 Question 10 


True or false? The program shown in Listing 3 (p. 503) causes the words Text Hello World to be 
displayed on the standard output device when the program is compiled and executed. 
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Listing 3 . Question 10. 


class TextHelloWorld{ 
public static void main(String[] args){ 
System.out.println("Text Hello World"); 
}//end main 
}//end class 


Table 3.185 
Answer 10 (p. 507) 


3.3.2.3.11 Question 11 


True or false? The code shown in Listing 4 (p. 503) can be compiled and run to produce the graphic output 
shown in Image 1 (p. 504) . 


Listing 4 . Question 11. 


import java.awt.Color; 


class GraphicHelloWorld{ 
public static void main(String[] args){ 
PictureExplorer pix = new PictureExplorer (200,100) ; 
pix.setAl1PixelsToAColor(Color.RED) ; 
pix.addMessage("Graphic Hello World",15,50); 
pix.show() ; 
}// end main 
}//end class 


Table 3.186 


Graphic Hello World 
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Graphic Hello World 


Image 1 . Question 11. 


Graphic Hello World 


Table 3.187 
Answer 11 (p. 506) 


3.3.2.3.12 Question 12 


True or false? The program shown (incorrectly) in Listing 4 (p. 503) and correctly in Listing 5 (p. 507) 
requires the use of Ericson’s multimedia library plus a jpg image file. 
Answer 12 (p. 506) 
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e Image 1 (p. 504) . Question 11. 


3.3.2.5 Listings 


What is the meaning of the following two images? 


Listing 1 (p. 
Listing 2 (p. 
Listing 3 (p. 
( 
( 


Listing 4 


p- 
Listing 5 (p. 


. Question 7. 
. Question 8. 
. Question 10. 
. Question 11. 
. Answer 11. 
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This image was inserted here simply to insert some space between the questions and the answers to keep 


them from being visible on the screen at the same time. 


The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 


Oriented Programming. 


None 


Display your name 


aet 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


502 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Prob05a.jpg 


Put your name here 


3.3.2.6 Answers 
3.3.2.6.1 Answer 12 


False. The program does require the use of Ericson’s multimedia library but it does not require a jpg image 
file. 
Back to Question 12 (p. 504) 


3.3.2.6.2 Answer 11 


False. The correct code is shown in Listing 5 (p. 507) . 
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Listing 5 . Answer 11. 


import java.awt.Color; 


class GraphicHelloWorld{ 
public static void main(String[] args){ 
Picture pix = new Picture(200,100); 
pix.setAl1PixelsToAColor(Color.RED) ; 
pix.addMessage("Graphic Hello World",15,50); 
pix.show() ; 
}// end main 
}//end class 


Table 3.188 
Back to Question 11 (p. 503) 


3.3.2.6.3 Answer 10 
True 
Back to Question 10 (p. 502) 
3.3.2.6.4 Answer 9 
True. 
Back to Question 9 (p. 502) 
3.3.2.6.5 Answer 8 
True. 
Back to Question 8 (p. 502) 
3.3.2.6.6 Answer 7 
True. 
Back to Question 7 (p. 502) 
3.3.2.6.7 Answer 6 
False. You will need to put the path to the bookClasses folder on your classpath in order to incorporate 
classes from the library into your programs. 
Back to Question 6 (p. 502) 
3.3.2.6.8 Answer 5 
True 
Back to Question 5 (p. 501) 
3.3.2.6.9 Answer 4 


False. Once you have downloaded the zip file containing the library, you will need to extract the folder 
named bookClasses from the zip file and store it somewhere on your computer’s disk. 
Back to Question 4 (p. 501) 
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3.3.2.6.10 Answer 3 


False. The Guzdial-Ericson library was originally published by Guzdial and Ericson in conjunction with 
their book Introduction to Computing and Programming with Java: A Multimedia Approach 1°! . While 
the book isn’t free, the library is freely available and is published under a Creative Commons Attribution 
3.0 United States License 1° . 

Back to Question 3 (p. 501) 


3.3.2.6.11 Answer 2 


True. 
Back to Question 2 (p. 501) 


3.3.2.6.12 Answer 1 


103 and Barbara 


False. The multimedia class library was developed and made available by Mark Guzdial 
Ericson !% of the Georgia Institute of Technology. 


Back to Question 1 (p. 501) 


3.3.2.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3000r Review: Java3000: The Guzdial-Ericson Multimedia Class Library 
e File: Java3000r-htm 

e Published: 02/09/13 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


101http://www.-pearsonhighered.com/educator/academic/product/0,3110,0131496980,00.html 
102http://creativecommons.org/licenses/by /3.0/us/ 

103http://www.cc.gatech.edu/~guzdial/ 

104http://coweb.cc.gatech.edu/ice-gt/8 
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3.3.3 Java3000s Slides” 
3.3.3.1 Table of Contents 


e Instructions for viewing slides (p. 509) 
e Miscellaneous (p. 509) 


3.3.3.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3000: The Guzdial-Ericson Multimedia 
Class Library 10 . 

Click here 107 to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.3.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3000s Slides: The Guzdial-Ericson Multimedia Class Library 
e File: Java3000s.htm 
e Published: 01/05/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


105This content is available online at <http://cnx.org/content /m45620/1.3/>. 
106http://cnx.org/content /m44148 
107http://cnx.org/content /m45620/latest /a0-Index.htm 
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3.3.4 Java3002: Creating and Manipulating Turtles and Pictures in a World 
Object”? 


3.3.4.1 Table of Contents 


e Preface (p. 510) 
Viewing tip (p. 510) 

x Images (p. 510) 

x Listings (p. 510) 
Preview (p. 511) 
Discussion and sample code (p. 515) 
Run the program (p. 532) 
Summary (p. 532) 
What’s next? (p. 532) 
Online video links (p. 532) 
Miscellaneous (p. 533) 
Complete program listings (p. 533) 


3.3.4.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 1 . 


3.3.4.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.3.4.2.1.1 Images 


Image 1 (p. 514) . Graphic screen output. 
Image 2 (p ) . Command-line output. 
Image 3 (p. 516) . Commands to compile and execute the application. 
Image 4 (p. 521) . Constructors for the World class. 
Image 5 (p. 523) . Constructors for the Turtle class. 
( ) 


Image 6 (p. 528) . Constructors for the Picture class. 


3.3.4.2.1.2 Listings 


e Listing 1 (p. 515) . The driver class. 

e Listing 2 (p. 518) . Beginning of the class named Prob01Runner. 
e Listing 3 (p. 524) . The constructor for the Prob01Runner class. 
e Listing 4 (p. 525) . Three accessor methods. 

e Listing 5 (p. 526) . The beginning of the run method. 

e Listing 6 (p. 529) . Add text to the image. 

e Listing 7 (p. 530) . Manipulate the turtle named joe. 


108 This content is available online at <http://cnx.org/content /m44149/1.8/>. 
109http://cnx.org/content /m44148/latest / 
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e Listing 8 (p. 531) . Manipulate the turtle named sue. 
e Listing 9 (p. 533) . Source code for Prob01. 


3.3.4.3 Preview 


In this module, I will explain a program that uses Java and Ericson’s media library to (see Image 1 (p. 514) 


js 


e Add a picture and two turtles to a world. 
e Manipulate the turtles, their colors, and their pens. 


Stated in more detail, the program will: 


e Create a Picture object from an image file and replace the default white Picture in a World 
object with the new Picture object. 
Place two Turtle objects ina World object. 
Apply a series of operations to manipulate the two turtle objects so as to produce a specific graphic 
output. 

e Provide accessor methods to get references to two Turtle objects and the World object. 
Use the references to get information from the World and ‘Turtle objects and display that 
information on the command-line screen. 

e Display text ona Picture ina World object. 


Program output 
Image 1 (p. 514) 


E43 world =o | x 
Dick Baldwin 


shows the graphic screen output produced by this program. 
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World 
Dick Baldwin 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


B World 
Dick Baldwin 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


509 


510 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Image 1 . Graphic screen output. 


Dick Baldwin 


Table 3.189 


Image 2 (p. 514) shows the text output produced by the program on the command line screen. 


Image 2 . Command-line output. 


javac 1.6.0_14 
java version "1.6.0_14" 
Java(TM) SE Runtime Environment (build 1.6.0_14-b08) 
Java HotSpot(TM) Client VM (build 14.0-b16, mixed mode, 
sharing) 
Dick Baldwin. 
A 300 by 274 world with 2 turtles in it. 
joe turtle at 44, 143 heading -135.0. 
sue turtle at 250, 237 heading 0.0. 


Table 3.190 


Output produced by the system 
Image 2 (p. 514) not only shows the output produced by the program. It also shows information produced 
by the Java compiler and the Java virtual machine as a result of executing the following commands at runtime: 
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javac -version 
java -version 


3.3.4.4 Discussion and sample code 


Will explain in fragments 

I will explain this program in fragments. A complete listing of the program is provided in Listing 9 (p. 
533) near the end of the module. 

I will begin with the driver class named Prob01 , which is shown in its entirety in Listing 1 (p. 515) . 


Listing 1 . The driver class. 


import java.awt.Color; 


public class Prob01{//Driver class 
public static void main(String[] args){ 
//Instantiate an object and call its method named run. 
Prob01Runner obj = new Prob0iRunner() ; 
obj.run(); 


//Get information from the object and display it on 
// the command-line screen. 
System. out.println(obj.getMars()); 
System. out.println(obj.getJoe()); 
System. out.println(obj.getSue()); 
}//end main 
3//end class Prob01 


Table 3.191 


The import directive 

Note the import directive at the very beginning of Listing 1 (p. 515) . This is a directive to the compiler 
and the virtual machine notifying them that the class named Color can be found in the package named 
java.awt 

What is a package? 

Boiled down to its simplest description, a package is nothing more than the specification of a particular 
folder on the disk relative to a standard root folder. (Think of it as a disk-path specification with the 
periods representing \ characters on a Windows machine and representing / characters on a Unix machine.) 

The public class named Prob01 

Every Java application (not true for Java applets) must include the definition of a class that contains 
the definition of a method named main with a method signature having the syntax shown in Listing 1 (p. 
515) . 

The name of the class/application 

The name of the class containing the main method is also the name of the application insofar as being 
able to compile and execute the application is concerned. In this case, the name of the class, and hence the 
name of the application is Prob01 

Source code file name 

The name of the source code file containing this class must match the name of the class. In this case, 

the source code file must be named ProbO1.java . (Note the java extension.) 
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Compiling the application 
In its simplest form, this application can be compiled by executing the following command at the com- 
mand prompt: 


javac Prob01.java 


Note however that it is often necessary to specify the path to various library files on the command line when 
compiling the application. In that case, the simplest form given above is not sufficient. 

Compiler output file names 

When the application is successfully compiled, it will produce one or more output files with an extension 
of .class . In this case, one of those files will be named Prob01.class 

Execution of the application 

The execution of C and C++ programs begins and ends in the main function. The execution of Java 
applications begin and end in the method named main 

Once again, in its simplest form, this application can be executed by entering the following command at 
the command prompt: 


java Prob01 


Again, it is often necessary to specify the path to various library files on the command line when executing 
the application. In that case, the simplest form is not sufficient. 

Compilation and execution on my machine 

This application can be compiled and executed on my machine by entering the two commands shown in 
Image 3 (p. 516) at the command prompt. (Note that artificial line breaks were inserted into Image 3 
(p. 516) to force the long commands to fit this narrow format.) 


Image 3 . Commands to compile and execute the application. 


javac -cp .;M:\Baldwin\AA-School\Itse2321Intro00P\ 
MediaCompBookMaterial\bookClasses Prob01.java 


java -cp .;M:\Baldwin\AA-School\Itse2321Intro00P\ 
MediaCompBookMaterial\bookClasses Prob01 


Table 3.192 


The compiler and the virtual machine 

The javac portion of the first command causes the Java compiler to run. 

The java portion of the second command causes the Java virtual machine to run. 

The input files 

The Prob0l.java and Prob01 at the ends of the two commands specify the files being operated on 
by the compiler and the virtual machine respectively. 

A classpath 

In both cases, the -cp indicates that a classpath follows. 

A classpath consists of one or more path specifications separated by semicolon characters. 

The purpose of the classpath is to tell the compiler and the virtual machine where to look for previously 
compiled class files that the application needs in order to successfully compile and execute. 

The current folder 

The period ahead of the semicolon says to search the current. folder first. 

The path to the Ericson library 
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The material following the semicolon is the absolute path to the folder containing the class files that 
make up Ericson’s library on my machine. The location of that folder will probably be different on your 
machine. 

The main method 

Now that we have the preliminaries out of the way, let’s go back and examine the body of the main 
method in Listing 1 (p. 515) . 

The first statement in the body of the main method in Listing 1 (p. 515) instantiates a new object of 
the class named Prob01Runner 

The statement saves a reference to that object in a reference variable named obj . Note that the type 
of the variable is the same as the name of the class in this case. In general, the type of the variable must be: 


e The name of the class, or 
e The name of a superclass of the class, or 
e The name of an interface implemented by the class. 


Accessing the object 

You must save a reference to an object in order to gain access to the object later. In this case, the 
reference is stored in the variable named obj 

Call the method named run 

The second statement in the body of the main method in Listing 1 (p. 515) uses that reference to 
call the method named run encapsulated in the object. As you will see later, most of the work in this 
application is performed in the method named run 

Get and display information about the object 

When the run method returns control to the main method, the last three statements in the body 
of the main method in Listing 1 (p. 515) use the object’s reference to call the following three methods 
belonging to the object: 


e getMars 
e getJoe 
e getSue 


Accessor methods 

These three methods are of a type that is commonly referred to as accessor methods . They access and 
return values encapsulated inside an object. In most cases, (using good programming practice) they return 
copies of the values. This protects the encapsulated values from being corrupted by code outside the object. 

The method named println 

In each case in Listing 1 (p. 515) , the value returned by the method is passed to a method named 
printIn . This is a method belonging to a standard system object that represents the standard output 
device (usually the command-line screen) . The purpose of the printIn method is to display material on 
the command-line screen. 

System.out.println... 

Without going into detail about how this works, you should simply memorize the syntax of the last three 
statements in the body of the main method in Listing 1 (p. 515) . I explain the concepts involved in great 
detail on my website. Go to Google and search for the following keywords: 


baldwin java "class variable named out" 


This code (System.out.printin...) provides the mechanism by which you can display material on the 
command line screen in a running Java application. The last three statements in the main method in Listing 
1 (p. 515) produced the last three lines of text in Image 2 (p. 514) . 

(Note that only the last four lines of text in Image 2 (p. 514) were produced by the program. 
Everything above that was produced by the system during the compilation and initial execution of the 
application. ) 

What do you know so far? 

So far, you know the following to be true: 
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The program instantiates an object of the class named Prob01Runner 
The program causes a method named run belonging to that object to be executed. 
When the run method returns, the program calls three accessor methods in succession, causing the 
values returned by those methods to be displayed on the command-line screen. 

e The fourth line of text from the bottom in Image 2 (p. 514) (Dick Baldwin) was produced before the 
last three lines of text discussed above. Therefore, that line of text must have been produced before 
control reached the call to the getMars method in Listing 1 (p. 515) . 


The public modifier 
Java uses four access modifiers to specify the accessibility of various classes and members in a Java 
application: 


public 

private 
protected 
package-private 


Rather than trying to explain all four at this time, I will explain public here and explain the other three 
when we encounter them in code. 

The public modifier is the easiest of the four to explain. As the name implies, it is analogous to a 
public telephone. Any code that can find a class or class member with a public modifier can access and use 
it. In this case, any code that can find the class definition for the class named Prob0O1 can instantiate an 
object of that class. 

The class named Prob01Runner 

There’s not a lot more that we can say about the driver class named ProbO1 , so it’s time to analyze 
the class named Prob01Runner . We need to figure out what it is about that class that causes the 
program output to match the material shown in Image 1 (p. 514) and Image 2 (p. 514) . 

Beginning of the class named Prob01Runner 
The definition of the class named Prob01Runner begins in Listing 2 (p. 518) . 


Listing 2 . Beginning of the class named Prob01Runner. 


class Prob01Runner{ 
//Instantiate the World and Turtle objects. 
private World mars = new World(300, 274); 
private Turtle joe = new Turtle(mars) ; 
private Turtle sue = new Turtle(mars) ; 


Table 3.193 


No access modifier 

Note that this class definition does not have an access modifier. This puts it in package-private access 
category. A class with package-private access can be accessed by code that is stored in the same package 
and cannot be accessed by code stored in other packages. 

Three private variables 

The last three statements in Listing 2 (p. 518) declare three private variables. Because these variables 
are declared private, they can only be accessed by code contained in methods defined inside the class. 

(They are also accessible by code contained in methods defined in classes defined inside the class, but 
that is beyond the scope of this module.) 

Three private instance variables 
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These variables are also instance variables as opposed to class variables . (We will discuss class 
variables in a future module.) 

Because they are instance variables, they belong to an object instantiated from the class. (An object 
is an instance of a class.) Even if the variables were public, they could only be accessed by first gaining 
access to the object to which they belong. 

Multiple instances of the class 

If you instantiate multiple objects of this same class (create multiple instances which you often do) , 
each object will encapsulate the same set of the three private instance variables shown in Listing 2 (p. 518) 
. Instance variables have the same name but may have different values in the different objects. 

Three private instance reference variables 

The three variables declared in Listing 2 (p. 518) are also reference variables (as opposed to primitive 
variables) . This means that they are capable of storing references to objects as opposed to simply being 
able to store primitive values of the following eight types: 


char 
byte 
short 
int 

long 
float 
double 
boolean 


Primitive variables can only store primitive values of the types in the above list. 
Classes, classes, and more classes 

A Java application consists almost exclusively of objects. Objects are instances of classes. Therefore, 

class definitions must exist before objects can exist. 
The true power of Java 

The Java programming language is small and compact. The true power of Java lies in its libraries of 
predefined classes. 

The Java standard edition development kit and runtime engine available from Sun contains a library con- 
sisting of thousands of predefined classes. Other class libraries containing thousands of classes are available 
from sun in the enterprise edition and the micro edition. 

Non-standard class libraries 

In some cases, you or your company may create your own class libraries and/or obtain class libraries 

from other sources such as the Ericson class library that we are using in this module. 
Custom class definitions 

In almost all cases, you will need to define a few new classes for new applications that you write. We will 
define two new classes for this application. The remainder of the classes that we use will come either from 
Sun’s standard library or Ericson’s library. 

Objects of the World class and the Turtle class 

Ericson’s class library contains a class named World and another class named Turtle . The code in 
Listing 2 (p. 518) instantiates one object of the World class and populates that world with two objects of 
the Turtle class. 

Every class has a constructor 

Every class definition has one or more method-like members called constructors. (If you don’t define a 
constructor when you define a class, a default constructor will be automatically defined for your class.) 

The name of the constructor must always be the same as the name of the class. Like a method, a 
constructor may or may not take arguments. If there are two or more (overloaded) constructors, they must 
have different argument lists. 

Instantiating an object of a class 
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To instantiate an object of a class, you apply the new operator (see Listing 2 (p. 518) ) to the 
class’ constructor, passing parameters that satisfy the required arguments for the constructor. 

Return a reference to the object 

Once the object has been instantiated, the constructor returns a reference to the new object. 

A new World object 

For example, the first statement in Listing 2 (p. 518) applies the new operator to Ericson’s World class 


constructor passing two integer values as parameters. This causes anew World object to be instantiated. 
A reference is returned 
A reference to the new World object is returned and stored in the reference variable named mars . 
Once the reference is stored in the reference variable, it can be used to access the World object later. 
Constructors for the World class 


Image 4 (p. 521) s shows the constructors that are available for Ericson’s World class. (See javadocs 
for the Ericson library.) 


Constructor Summary 
World() 
Constructor that takes no arguments 


World(boolean visibleFlag) 


Constructor that takes a boolean to say if this world should be 
visible or not 


World(int w, int h) 
Constructor that takes a width and height for this world 


Constructor Summary 


World() 
Constructor that takes no arguments 


World(boolean visibleFlag) 

Constructor that takes a boolean to say if this world should be 
visible or not 
World(int w, int h) 

Constructor that takes a width and height for this world 
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Constructor Summary 


World() 
Constructor that takes no arguments 


World(boolean visibleFlag) 
Constructor that takes a boolean to say if this world should be 
visible or not 


World(int w, int h) 
Constructor that takes a width and height for this world 


Image 4 . Constructors for the World class. 
Constructor Summary 


World() 
Constructor that takes no arguments 


World(boolean visibleFlag) 

Constructor that takes a boolean to say if this world should be 
visible or not 
World(int w, int h) 

Constructor that takes a width and height for this world 


Table 3.194 


A new World object 

The third constructor in Image 4 (p. 521) was used to construct a World object in Listing 2 (p. 518) 
with a width of 300 pixels and a height of 274 pixels. As explained earlier, this object’s reference was saved 
in the variable named mars . 

Two new Turtle objects 

The last two statements in Listing 2 (p. 518) instantiate two objects of the Turtle class and use them 
to populate the World object whose reference is stored in the variable named mars . 

More complicated than before 

This is a little more complicated than the instantiation of the World object. Ericson’s javadocs indicate 
that the Turtle class provides the four constructors shown in Image 5 (p. 523) . 
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Constructor Summary 


Turtle(int x, int y, ModelDisplay modelDisplayer) 
Constructor that takes the x and y and a model display to draw 
it on 


Turtle(int x, int y, Picture picture) 
Constructor that takes the x and y and a picture to draw on 


Turtle(ModelDisplay modelDisplay) 

Constructor that takes the model display 
Turtle(Picture p) 

Constructor that takes a picture to draw on 


Constructor Summary 


Turtle(int x, int y, ModelDisplay modelDisplayer) 

Constructor that takes the x and y and a model display to draw 
it on 
Turtle(int x, int y, Picture picture) 

Constructor that takes the x and y and a picture to draw on 


Turtle(ModelDisplay modelDisplay) 
Constructor that takes the model display 


Turtle(Picture p) 
Constructor that takes a picture to draw on 
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Constructor Summary 


Turtle(int x, int y, ModelDisplay modelDisplayer) 
Constructor that takes the x and y and a model display to draw 


it on 
Turtle(int x, int y, Picture picture) 
Constructor that takes the x and y and a picture to draw on 


Turtle(ModelDisplay model!Display) 
Constructor that takes the model display 


Turtle(Picture p) 
Constructor that takes a picture to draw on 


Image 5 . Constructors for the Turtle class. 


Constructor Summary 


Turtle(int x, int y, ModelDisplay modelDisplayer) 
Constructor that takes the x and y and a model display to draw 
it on 


Turtle(int x, int y, Picture picture) 


Constructor that takes the x and y and a picture to draw on 


Turtle(ModelDisplay modelDisplay) 
Constructor that takes the model display 


Turtle(Picture p) 
Constructor that takes a picture to draw on 


Table 3.195 


A World object as a parameter 
If you dig deep enough, and if you study Ericson’s textbook, you can determine that the third constructor 


in Image 5 (p. 523) will accept a reference toa World object as a parameter. This is the constructor that 
was used in the last two statements in Listing 2 (p. 518) . 


ModelDisplay interface The World class implements the ModelDisplay interface. Therefore, 
an object of the World class can be treated as it is type ModelDisplay. I explain the relationship 
between classes and interfaces in detail on my website. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


520 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Displayed in the center of the world 

When the two Turtle objects instantiated in Listing 2 (p. 518) come into existence, they will be 
displayed in the center of the World object referred to by the contents of the variable named mars 
However, that happens so quickly that you probably won’t see it when you run this program. 

Eliminating the run method call 

If you were to eliminate the call to the run method in Listing 1 (p. 515) , you would see a world 
with a white background and a single turtle positioned in the center of the world facing north. There would 
actually be two turtles there, but they would be in exactly the same location so only the one closest to you 
would be visible. 

The constructor for the Prob01Runner class 

That’s probably enough discussion of the three statements in Listing 2 (p. 518) . The constructor for 
the class named Prob01Runner is shown in its entirety in Listing 3 (p. 524) . 


Listing 3 . The constructor for the Prob01Runner class. 


public Prob01Runner(){//constructor 
System.out.println("Dick Baldwin."); 
}//end constructor 


Table 3.196 


The purpose of constructors 

The primary purpose for which constructors exist is to assist in the initialization of the variables belonging 
to the object being constructed. However, it is possible to directly initialize the variables as shown in Listing 
2 (p. 518) . 

Initialization of variables 

When an object comes into existence, the variables belonging to that object will have been initialized 
by any direct initializers like those shown in Listing 2 (p. 518) as well any initialization produced by code 
written into the constructor. 

Default initialization 

If a variable (exclusive of local variables inside of methods) is not initialized in one of those two ways, 
it will receive a default initialization value. The default values are: 


e 0 or 0.0 for numeric variables 
e false for boolean variables 
e null for reference variables 


Non-initialization code in constructors 

Although it is usually not good programming practice to do so, there is no technical reason that you 
can’t write code into the constructor that has nothing to do with variable initialization. Such code will be 
executed when the object is instantiated. 

An object counter 

For example, you might need to keep track of the number of objects that are instantiated from a particular 
class, such as the total number of asteroid objects in a game program for example You could write the code 
to do the counting in the constructor. 

Display my name 

The code in the constructor in Listing 3 (p. 524) simply causes my name to be displayed on the command- 
line screen when the object is instantiated. That is how my name appears ahead of the other lines of output 
text in Image 2 (p. 514) . My name is displayed when the object is instantiated. The remaining three lines 
of text in Image 2 (p. 514) are displayed later by manipulating the object. 
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Three accessor methods 
Listing 4 (p. 525) defines three accessor methods that are used to access and return copies of the contents 
of the private instance variables named joe , sue ,and mars 


Listing 4 . Three accessor methods. 


public Turtle getJoe(){return joe;} 
public Turtle getSue(){return sue;} 
public World getMars(){return mars; } 


Table 3.197 


Good OOP practice 

Good object-oriented programming practice says that most of the instance variables encapsulated in an 
object should be declared private. If there is a need to make the contents of those variables available outside 
the object, that should be accomplished by defining public accessor methods. (Accessor methods are often 
referred to as getter methods because the name of the accessor method often includes the word "get".) 

Setter methods 

If there is a need for code outside the object to store information in the object’s private instance variables, 
this should be accomplished by writing public setter methods. Code in the setter methods can filter incoming 
data to make certain that the state of the object doesn’t become corrupt as a result of outside influences. 

Pass and return by value 

Everything in Java is passed and returned by value , not by reference. 

Each of the accessor methods shown in Listing 4 (p. 525) returns a copy of the reference belonging to 
either a Turtle object or a World object. 

Pass to the println method 

As you saw earlier, each of the three references is passed to the println method in Listing 1 (p. 515) 
causing information about the objects to be displayed on the command-line screen. 

The toString method 

Although it isn’t obvious in Listing 1 (p. 515) , the code in the printIn method calls a method named 
toString on the incoming object reference and displays the string value returned by that method. I discuss 
this in detail on my website. Go to Google and search for the following: 


baldwin java "the toString method" 


An overridden method 

The toString method is overridden (not overloaded) in the World and Turtle classes so as to 
return a string value describing the object. 

The Ericson javadocs 

Normally, the javadocs would tell you what information is contained in that string, but that is not the 
case in Ericson’s javadocs. You would have to get into her source code, (which is readily available), to get 
that information. However, you can see the information that is contained in the string values for the two 
different types of objects in the last three lines of text in Image 2 (p. 514) . 

The beginning of the run method 

This is where thing start to get really interesting. Listing 5 (p. 526) shows the beginning of the public 
method named run 
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Listing 5. The beginning of the run method. 


public void run()f{ 
//Replace the default all-white picture with another 
// picture. 
mars.setPicture(new Picture("Prob01.jpg")); 


Table 3.198 


Recall that the code in the main method in Listing 1 (p. 515) calls the run method on the object 
immediately after it is instantiated. 

A turtle on a white background 

I told you earlier that if you were to eliminate the call to the run method, you would see a turtle at 
the center of the world with a white background. 

The background is a Picture object 

The background of a World object consists of an object of Ericson’s Picture class. (A Picture 

object is encapsulated in the World object.) 

By default, the Picture object encapsulated in a World object is all white and is exactly the right 
size and shape to completely fill the area inside the world’s border (see Image 1 (p. 514) ). 

Can be replaced 

As you will see shortly, we can replace the default Picture object with anew Picture object of our 
own choosing. 

What if it doesn’t fit? 

Ifthe new Picture object isn’t large enough to completely fill the area inside the borders of the World 
object, it will be placed in the upper-left corner of the World object and the remainder of the World 
object will be a light gray color. 

If the Picture object is too large, an upper-left rectangular portion of the Picture object, sufficient 
to fill the World object, will be displayed. The remainder of the Picture object will not be visible even 
if you manually resize the World object to make it larger. 

Constructors for the Picture class 
Image 6 (p. 528) shows the javadocs for the constructors for Ericson’s Picture class. 
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Picture() 

Constructor that takes no arguments 
Picture(Bufferedimage image) 

Constructor that takes a buffered image 


Picture(int width, int height) 
Constructor that takes the width and height 
Picture(Picture copyPicture) 


Constructor that takes a picture and creates a copy of that 
picture 


Picture(String fileName) 
Constructor that takes a file name and creates the picture 


Constructor Summary 


Picture() 

Constructor that takes no arguments 
Picture(Bufferedimage image) 

Constructor that takes a buffered image 
Picture(int width, int height) 

Constructor that takes the width and height 


Picture(Picture copyPicture) 
Constructor that takes a picture and creates a copy of that 
picture 


Picture(String fileName) 
Constructor that takes a file name and creates the picture 
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Constructor Summary 


Picture() 
Constructor that takes no arguments 


Picture(Bufferedimage image) 
Constructor that takes a buffered image 


Picture(int width, int height) 


Constructor that takes the width and height 


Picture(Picture copyPicture) 
Constructor that takes a picture and creates a copy of that 
picture 


Picture(String fileName) 
Constructor that takes a file name and creates the picture 


Image 6. Constructors for the Picture class. 
Constructor Summary 


Picture() 
Constructor that takes no arguments 


Picture(Bufferedimage image) 

Constructor that takes a buffered image 
Picture(int width, int height) 

Constructor that takes the width and height 


Picture(Picture copyPicture) 
Constructor that takes a picture and creates a copy of that 
picture 


Picture(String fileName) 
Constructor that takes a file name and creates the picture 


Table 3.199 


Replace the default picture object 
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The right-hand portion of the last statement in Listing 5 (p. 526) uses the last constructor in Image 6 (p. 
528) to instantiate a new Picture object that encapsulates the image contained in the image file named 
ProbO0l1.jpg . 

(Click here 1° to download a copy of the file named Prob01.jpg.) 
What about the size of the Picture object? 

I was careful to use an image that was a little wider than and exactly as tall as the dimensions of my 

World object (300 x 274) . Therefore, the image completely filled the world as shown in Image 1 (p. 514) 


Pass the reference to a setter method 

The reference belonging to the new Picture object was passed to the setPicture method of the 
World object (a setter method) . This caused the new picture containing the penguin to replace the 
default all-white picture that forms the background for the World object. (See Image 1 (p. 514) .) 

A subclass of the SimplePicture class 

Ericson’s Picture class is a subclass of (extends) the class named SimplePicture . Therefore, an 
object of the Picture class encapsulates all of the methods defined in the Picture class in addition to 
all of the methods defined in the SimplePicture class. 

A subclass of the Object class 

Further, the SimplePicture class is a subclass of (extends) the Object class. Therefore, an object 
of the Picture class also encapsulates all of the methods defined in the Object class. 

The AddMessage method 

One of the methods defined in the SimplePicture class and inherited into the Picture class is 
named AddMessage . 

The addMessage method requires three parameters: 


e a string and 
e two coordinate values of type int 


The method will draw the string as text characters onto the image at the location specified by the two 
coordinate values. 

(The origin of the coordinate system is the upper-left corner of the image with positive horizontal values 
going to the right and positive vertical values going down.) 

Add text to the image 

The code in Listing 6 (p. 529) uses two levels of indirection to add my name as a message to the picture 
that forms the background of the world as shown in Image 1 (p. 514) . 


Listing 6 . Add text to the image. 


mars.getPicture() .addMessage( 
"Dick Baldwin",10,20); 


Table 3.200 


Get and access the World object 

To begin with, Listing 6 (p. 529) goes to the variable named mars to get a reference to the World 
object. This reference is used to access the World object. 

Access the Picture object via a getter method 

Then the code in Listing 6 (p. 529) calls the getter method named getPicture to get access to the 
Picture object encapsulated in the World object. 


110h¢tp://cnx.org/content /m44149/latest /Prob01.jpg 
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Call the addMessage method 

Having gained access to the Picture object, Listing 6 (p. 529) calls the addMessage method on that 
object passing my name asa String object along with a pair of coordinate values that specify a location 
near the upper-left corner of the image. The result is that my name appears in the world as shown in Image 
1 (p. 514) . 

Methods encapsulated in the Turtle object 

The Turtle class extends the SimpleTurtle class, which in turn extends the Object class. 
Therefore, an object of the Turtle class encapsulates all of the methods defined in all three classes. 

Manipulate the turtle referred to by the variable named joe 

A Turtle object encapsulates many methods that can be used to manipulate the turtle in a variety of 
different ways. This is illustrated by the series of statements in Listing 7 (p. 530) . 


Listing 7 . Manipulate the turtle named joe. 


joe.setName ("joe") ; 


joe.setBodyColor(Color.RED) ; 
joe.setShel1Color (Color.BLUE) ; 


joe.setPenColor (Color. YELLOW) ; 
joe.setPenWidth(3) ; 


joe.forward(); 
joe.turn(-135) ; 


joe.setPenColor (Color .BLUE) ; 
joe.forward (150) ; 


Table 3.201 


Initial (default) state of a Turtle object 

When anew Turtle object is instantiated and added to a World object (using the constructor 
shown in Listing 2 (p. 518) ) , it doesn’t have a name property. (Actually, its name is probably null.) 

The turtle initially appears in the center of the world, facing north with a default color. 

Every Turtle object has a pen attached to its belly that can draw a line with a default width of one 
pixel in a default color when the turtle moves. 

The pen can be raised so that it won’t draw a line or lowered so that it will draw a line. Initially it is 
down and will draw a line. 

Set the name property to "joe" 

Listing 7 (p. 530) begins by setting the name property of one of the turtles to the string value "joe." 

(Note that this is completely independent of the fact that a reference to this turtle is stored in a variable 
named joe . The name property could have been set to "Tom", "Dick", "Harry", or any other string value. 
It is the value of the name property and not the name of the variable that determines the text output shown 
in Image 2 (p. 514) .) 

Set the turtle’s body and shell color 

Listing 7 (p. 530) continues by calling two setter methods on the turtle object to set the body color 
(head and feet) to red and the color of the shell to blue. You can see the effect of this in Image 1 (p. 514) . 

Set the pen color and width 
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Then Listing 7 (p. 530) calls two setter methods that set the turtle’s pen color to yellow and the pen 

width to three pixels. You can also see the result of this in Image 1 (p. 514) . 
Make the turtle move forward 

After that, Listing 7 (p. 530) calls the forward method (with no parameters) to cause the turtle to 
move forward by a default distance of 100 pixels. 

Recall that the turtle initially faces north. In this case, the forward method causes the turtle to move 
from the center of the world to a location that is 100 pixels due north of the center of the world, drawing a 
wide yellow line along the way. 

Turn counter clockwise 

Then Listing 7 (p. 530) calls the turn method causing the turtle to rotate its body by 135 degrees 
counter-clockwise. (A positive parameter causes a clockwise rotation and a negative parameter causes a 
counter clockwise rotation.) 

Change the pen color and move forward again 

Finally Listing 7 (p. 530) calls methods to change the pen color to blue and to cause the turtle to move 

forward by 150 pixels. 
The final location 

After making the turn, the turtle is facing southwest. Therefore, the forward movement causes a diagonal 
blue line to be drawn from the position at the top of the yellow line down toward the southwest. As you can 
see in Image 1 (p. 514) , the turtle comes to rest at the end of that line. 

A few words about color 

I have published extensively on the concept of color in Java on my website. The best way to find that 

information is probably to go to Google and search for the keywords: 


baldwin java color 


Google is also probably your best bet for finding information on other topics that I have published on my 
website. For example, if you go to Google Images and search for the following keywords, you will find a lot 
of the work that I have published using Ericson’s media library. 


richard baldwin java ericson 


Manipulate the turtle named sue 
Listing 8 (p. 531) calls several methods on the object whose reference is stored in the variable named 
sue 


Listing 8 . Manipulate the turtle named sue. 


sue.setName("sue") ; 


sue.setPenWidth(2) ; 
sue.setPenColor(Color.RED) ; 


sue.moveTo (183,170) ; 
sue.setPenDown (false); 


sue .moveTo (216,203) ; 
sue.setPenDown (true); 


sue .moveTo (250, 237) ; 
}//end run method 
}//end class Prob01Runner 
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Table 3.202 


The end result 

These method calls result in the turtle facing north in the lower right corner of the window, having drawn 
the broken red line shown in Image 1 (p. 514) in getting there. 

The moveTo method 

Listing 8 (p. 531) calls the moveTo method to cause the turtle to move to a new location on the basis 
of coordinate values instead of on the basis of a distance value. 

Pen control 

Listing 8 (p. 531) also calls the setPenDown method twice passing false and then true as the parameter 
to first raise and then lower the pen. This produced the gap in the red line shown in Image 1 (p. 514) . 

The end of the program 

Listing 8 (p. 531) also signals the end of the method named run and the end of the class named 
Prob01Runner . As such, Listing 8 (p. 531) signals the end of the program. 


3.3.4.5 Run the program 


II encourage you to copy the code from Listing 9 (p. 533) , compile it and execute it. Experiment with the 
code, making changes, and observing the results of your changes. Make certain that you can explain why 
your changes behave as they do. 


3.3.4.6 Summary 


II explained a program that uses Java and Ericson’s media library to: 


e Add a picture and two turtles to a world. 
e Manipulate the turtles, their color, and their pens. 


Stated in more detail, the program: 


e Creates a Picture object and replaces the default white Picture in a World object with the 
new Picture object. 
Places two Turtle objects ina World object. 
Applies a series of operations to manipulate the two turtle objects so as to produce a specific graphic 
output. 
Provides accessor methods to get references to two Turtle objects and the World object. 
Gets information from the World and Turtle objects and displays the information on the command- 
line screen. 

e Displays text on a Picture ina World object. 


3.3.4.7 What’s next? 
In the next module, I will teach you how to invert images and how to display images using Ericson’s 
PictureExplorer object. 
3.3.4.8 Online video links 
Select the following links to view online video lectures on the material in this module. 
e ITSE 2321 Lecture 01 11? 


Part01 112 


1llhttp://www.youtube.com/playlist?list=PL26BF7154F 10D3854 
112http://www.youtube.com/watch?v=7KjSLqTgMec 
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Parto2 148 
Part03 114 
Parto4 115 
Part05 116 
Part06 1!" 
Part07 118 
Part08 119 
Partog 120 
Part10 1?! 


3.3.4.9 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java OOP: Creating and Manipulating Turtles and Pictures in a World Object 


e File: Java3002.htm 
e Published: 07/26/12 
e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have misappropriated copies of my modules from cnx.org, con- 
verted them to Kindle books, and placed them for sale on Amazon.com showing me as the author. 
I receive no compensation for those sales and don’t know who does receive compensation. If you 
purchase such a book, please be aware that it is a bootleg copy of a module that is freely available 
on cnx.org. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.3.4.10 Complete program listings 


A complete listing of the program discussed in this module is shown in Listing 9 below. 


Listing 9 . Source code for Prob01. 


continued on next page 


113http://www.youtube.com/watch?v=Jnra7R£{PKOI 
'4http://www.youtube.com/watch?v=mJDGp1HPCuE 
15http://www.youtube.com/watch?v=mYrGKI116j_ 4 
116http://www.youtube.com/watch?v=UUTIMh3J50w 
'7http://www-.youtube.com/watch?v=hmu-lla7VyE 
118http://www-.youtube.com/watch?v=tRpS7c-aPd0 
119http://www.youtube.com/watch?v=cE_ks6Oq30Y 
120http://www.youtube.com/watch?v=4f39g80EWsY 
121 http://www.youtube.com/watch?v=yeay7 REKLBY 
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/*File Prob01 Copyright 2008 R.G.Baldwin 
Command-line output 


javac 1.6.0_14 

java version "1.6.0_14" 

Java(TM) SE Runtime Environment (build 1.6.0_14-b08) 

Java HotSpot (TM) Client VM (build 14.0-b16, mixed mode, 
sharing) 

Dick Baldwin. 

A 300 by 274 world with 2 turtles in it. 

joe turtle at 44, 143 heading -135.0. 

sue turtle at 250, 237 heading 0.0. 

FE EEEE EEEE EEE EEEE EEE ICAI AI I I IKI I A i 21 2k E E 21 21 E 4 4 24 E 2 af 2k 2 2 E / 

import java.awt.Color; 


public class Prob01{//Driver class 
public static void main(String[] args){ 
Prob01Runner obj = new Prob0iRunner(); 
obj.run(); 


System. out.println(obj.getMars()); 
System. out.println(obj.getJoe()); 
System. out.println(obj.getSue()); 
}//end main 
}//end class Prob01 
7D BOBO COORG OSORIO SOCIO SIAR IOI II I I I ISI A a kf ak ak ak kak / 


class Prob0iRunner{ 
//Instantiate the World and Turtle objects. 
private World mars = new World(300, 274); 
private Turtle joe = new Turtle (mars); 
private Turtle sue = new Turtle(mars) ; 


public Prob01Runner () {//constructor 
System.out.println("Dick Baldwin."); 
}//end constructor 


//Accessor methods 

public Turtle getJoe(){return joe;} 
public Turtle getSue(){return sue;} 
public World getMars(){return mars; } 


//This method is where the action is. 
public void run(){ 
//Replace the default all-white picture with another 
// picture. 
mars.setPicture(new Picture("Prob01.jpg")); 
mars.getPicture() .addMessage( 
"Dick Baldwin" ,10,20 
Available for free at Connexions <http: Taz org/content/col11441/1.181> 
//Manipulate the turtle named joe. 
joe.setName("joe"); 
joe. setBodyColor (Color. RED); 
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-end- 
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3.3.5 Java3002r Review” 
3.3.5.1 Table of Contents 


e Preface (p. 536) 
e Questions (p. 536) 


1 (p. 536) , 2 (p. 537) , 3 (p. 537) , 4 (p. 537) , 5 (p. 537) , 6 (p. 537) , 7 (p. 538) , 8 (p. 538) , 
9 (p. 538) , 10 (p. 538) , 11 (p. 538) , 12 (p. 538) , 13 (p. 539) , 14 (p. 539) , 15 (p. 539) , 16 
(p. 539) , 17 (p. 539) , 18 (p. 539) , 19 (p. 539) , 20 (p. 540) , 21 (p. 540) , 22 (p. 540) , 23 (p. 
540) , 24 (p. 540) , 25 (p. 540) , 26 (p. 541) , 27 (p. 542) , 28 (p. 542) , 29 (p. 542) , 30 (p. 542) 
, 31 (p. 542) , 32 (p. 542) , 33 (p. 543) , 34 (p. 543) , 35 (p. 543) , 36 (p. 543) , 37 (p. 543) , 38 
(p. 543) , 39 (p. 543) , 40 (p. 543) , 41 (p. 544) , 42 (p. 544) , 43 (p. 544) , 44 (p. 544) , 45 (p. 
544) , 46 (p. 545) , 47 (p. 545) , 48 (p. 548) , 49 (p. 548) , 50 (p. 548) 


Images (p. 549) 
Listings (p. 549) 
Answers (p. 550) 
Miscellaneous (p. 556) 


3.3.5.2 Preface 


This module contains review questions and answers keyed to the module titled Java3002: Creating and 
Manipulating Turtles and Pictures in a World Object 13 . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.5.3 Questions 


3.3.5.3.1 Question 1 


True or False? The import directive at the very beginning of Listing 1 (p. 537) is a directive to the compiler 
and the virtual machine notifying them that the class named Color can be found in the package named 
java.awt 


122This content is available online at <http://cnx.org/content/m45762/1.4/>. 
123h¢tp://cnx.org/content /m44149 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


533 


Listing 1 . Question 1. 


import java.awt.Color; 


public class Prob01{//Driver class 
public static void main(String[] args){ 
//Instantiate an object and call its method named run. 
Prob01Runner obj = new Prob0iRunner(); 
obj.run(); 


//Get information from the object and display it on 
// the command-line screen. 
System. out.println(obj.getMars()); 
System. out.println(obj.getJoe()); 
System. out.println(obj.getSue()); 
}//end main 
}//end class Prob01 


Table 3.204 


Answer 1 (p. 556) 


3.3.5.3.2 Question 2 


True or False? The class named Color imported in Listing 1 (p. 537) is a member of Ericson’s multimedia 
library. 

Answer 2 (p. 556) 
3.3.5.3.3 Question 3 


True or False? A package is the specification of a particular folder on the disk relative to a standard root 
folder. 

Answer 3 (p. 555) 
3.3.5.3.4 Question 4 


True or False? Every Java application and every Java applet must include the definition of a class that 
contains the definition of a method named main 

Answer 4 (p. 555) 
3.3.5.3.5 Question 5 


True or False? The name of the class containing the main method is also the name of the application 
insofar as being able to compile and execute the application is concerned. 

Answer 5 (p. 555) 
3.3.5.3.6 Question 6 


True or False? The name of the application shown in Listing 1 (p. 537) is Proj01 
Answer 6 (p. 555) 
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3.3.5.3.7 Question 7 


True or False? The name of the source code file containing the class definition shown in Listing 1 (p. 537) 
must be ProbO1.java in order for the application to compile and run as an application named ProbOl1 . 
Answer 7 (p. 555) 


3.3.5.3.8 Question 8 


True or False? In its simplest form, an application can be compiled by executing the command shown in 
Listing 2 (p. 538) at the command prompt where ProbOl.java_ is the name of the file containing the 
main method. 


Listing 2 . Question 8. 


javac Prob01 
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Answer 8 (p. 555) 


3.3.5.3.9 Question 9 


True or False? It is often necessary to specify the path to various library files on the command line when 
compiling an application. In that case, the simplest form given in Listing 3 (p. 555) is not sufficient. 
Answer 9 (p. 555) 


3.3.5.3.10 Question 10 

True or False? When a Java application is successfully compiled, it will produce one or more output files 

with an extension of .class . 
Answer 10 (p. 555) 

3.3.5.3.11 Question 11 

True or False? The execution of a Java application begins and ends in the method named main . 
Answer 11 (p. 555) 

3.3.5.3.12 Question 12 


True or False? The two commands shown in Listing 4 (p. 539) can be used to compile and execute a Java 
application named Prob01 where: 


e The only special class library required is contained in the folder named bookClasses 
e The path from the root to the folder named bookClasses is represented by —\bookClasses. 
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Listing 4 . Question 12. 


javac -cp .;---\bookClasses Prob01. java 


java -cp .;---\bookClasses Prob01 
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Answer 12 (p. 554) 


3.3.5.3.13 Question 13 


True or False? The Java compiler program is named java.exe 
Answer 13 (p. 554) 


3.3.5.3.14 Question 14 


True or False? The ProbOl.java and Prob01 at the ends of the two commands in Listing 4 (p. 539) 
specify the files being operated on by the virtual machine and the compiler respectively. 
Answer 14 (p. 554) 


3.3.5.3.15 Question 15 

True or False? In Listing 4 (p. 539) , the -cp indicates that a classpath follows. 
Answer 15 (p. 554) 

3.3.5.3.16 Question 16 

True or False? A classpath consists of one or more path specifications separated by semicolon characters. 
Answer 16 (p. 554) 

3.3.5.3.17 Question 17 


True or False? The purpose of the classpath in Listing 4 (p. 539) is to tell the compiler and the virtual 
machine where to look for source code files that the application needs in order to successfully compile and 
execute. 


Answer 17 (p. 554) 

3.3.5.3.18 Question 18 

True or False? The period ahead of the semicolon in Listing 4 (p. 539) says to search the root folder first. 
Answer 18 (p. 554) 

3.3.5.3.19 Question 19 


True or False? The first statement in the body of the main method in Listing 1 (p. 537) instantiates a 
new object of the class named Prob0O1Runner . 
Answer 19 (p. 554) 
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3.3.5.3.20 Question 20 


True or False? The first statement in Listing 1 (p. 537) saves a reference to a new object of the class named 
Prob01Runner in a reference variable named obj . In general, the type of the variable must be: 


e The name of the object, or 
e The name of a superclass of the object, or 
e The name of an interface implemented by the object. 


Answer 20 (p. 554) 


3.3.5.3.21 Question 21 


True or False? In Java, you must save a reference to a newly instantiated object in order to gain access to 
that object later in the program. 
Answer 21 (p. 553) 


3.3.5.3.22 Question 22 


True or False? The second statement in the body of the main method in Listing 1 (p. 537) uses the 
reference stored in the variable named obj to call the method named run encapsulated in the object 
referred to by the contents of obj 

Answer 22 (p. 553) 


3.3.5.3.23 Question 23 


True or False? The following three methods that are called in Listing 1 (p. 537) are of a type that is 
commonly referred to as accessor methods . They are also sometimes referred to by the slang term getter 
methods . 


e getMars 
e getJoe 
e getSue 


Answer 23 (p. 553) 


3.3.5.3.24 Question 24 


True or False? The method named printlIn that is called in Listing 1 (p. 537) is a member of Ericson’s 
multimedia library. The purpose of the println method is to display text on an image. 
Answer 24 (p. 553) 


3.3.5.3.25 Question 25 


True or False? Java uses four access modifiers to specify the accessibility of various classes and members in 
a Java application: 


public 

private 
protected 
package-private 


Answer 25 (p. 553) 
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3.3.5.3.26 Question 26 


True or False? Listing 5 (p. 542) shows the beginning of a class named ProbO1Runner . 
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Listing 5 . Question 26. 


class Prob01Runner{ 
//Instantiate the World and Turtle objects. 
private World mars = new World(300, 274); 
private Turtle joe = new Turtle(mars) ; 
private Turtle sue = new Turtle (mars); 


Table 3.207 


Answer 26 (p. 553) 


3.3.5.3.27 Question 27 


True or False? The class that begins in Listing 5 (p. 542) does not have an access modifier. This puts it 
in package-private access category. A class with package-private access can be accessed by code that is 
stored in the same package and cannot be accessed by code stored in other packages. 

Answer 27 (p. 553) 


3.3.5.3.28 Question 28 


True or False? The last three statements in Listing 5 (p. 542) declare three private variables. Because 
these variables are declared private, they can be accessed by any method defined in any class in the same 
package. 

Answer 28 (p. 553) 


3.3.5.3.29 Question 29 


True or False? The three variables declared in Listing 5 (p. 542) are instance variables as opposed to class 
variables . 
Answer 29 (p. 553) 


3.3.5.3.30 Question 30 


True or False? Because the three variables declared in Listing 5 (p. 542) are instance variables, they belong 
to an object instantiated from the class. Even if the variables were public, they could only be accessed by 
first gaining access to the object to which they belong. 

Answer 30 (p. 552) 


3.3.5.3.31 Question 31 


True or False? The three variables declared in Listing 5 (p. 542) are reference variables . This means that 
they are capable of storing references to objects and are also capable of storing values of the eight primitive 


types. 
Answer 31 (p. 552) 


3.3.5.3.32 Question 32 


True or False? Ericson’s class library contains a class named World and another class named Turtle 
The code in Listing 5 (p. 542) instantiates one object of the World class and populates that world with 
three objects of the Turtle class. 

Answer 32 (p. 552) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


539 


3.3.5.3.33 Question 33 


True or False? Every class definition has one or more method-like members called constructors. (If you 
don’t define a constructor when you define a class, a default constructor will be automatically defined for 
your Class.) 

Answer 33 (p. 552) 


3.3.5.3.34 Question 34 


True or False? The name of the constructor must always be the same as the name of the class in which 
it is defined. Like a method, a constructor may or may not take arguments. If there are two or more 
(overloaded) constructors, they must have different argument lists. 

Answer 34 (p. 552) 


3.3.5.3.35 Question 35 
True or False? To instantiate an object of a class, you apply the new operator to the class’ constructor, 
passing parameters that satisfy the required arguments for the constructor. 
Answer 35 (p. 552) 
3.3.5.3.36 Question 36 


True or False? When an object is instantiated, the constructor returns an array containing the values in all 
of the instance variables. 
Answer 36 (p. 552) 


3.3.5.3.37 Question 37 


True or False? The last two statements in Listing 5 (p. 542) instantiate two objects of the Turtle class 
and use them to populate the World object whose reference is stored in the variable named mars 
Answer 37 (p. 552) 


3.3.5.3.38 Question 38 


True or False? If a variable (exclusive of local variables inside of methods) is not purposely initialized when 
the object in instantiated, it will receive a default initialization value. The default values are: 


e 0 or 0.0 for numeric variables 
e true for boolean variables 
e null for reference variables 


Answer 38 (p. 552) 


3.3.5.3.39 Question 39 


True or False? Code written into a class’ constructor is executed when an object of the class is instantiated. 
Answer 39 (p. 551) 


3.3.5.3.40 Question 40 


True or False? Good object-oriented programming practice says that most of the instance variables encap- 
sulated in an object should be declared private. If there is a need to make the contents of those variables 
available outside the object, that should be accomplished by defining protected accessor methods. 

Answer 40 (p. 551) 
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3.3.5.3.41 Question 41 

True or False? Everything in Java is passed and returned by reference. 
Answer 41 (p. 551) 

3.3.5.3.42 Question 42 


True or False? Each of the accessor methods shown in Listing 6 (p. 544) returns a copy of the reference 
pointing to either a Turtle object or a World object. 


Listing 6 . Question 42. 


public Turtle getJoe(){return joe;} 
public Turtle getSue(){return sue;} 
public World getMars(){return mars; } 


Table 3.208 


Answer 42 (p. 551) 


3.3.5.3.43 Question 43 


True or False? Code in the printIn method calls a method named toString on each incoming primitive 
value and displays the string value returned by that method. 
Answer 43 (p. 551) 


3.3.5.3.44 Question 44 


True or False? The toString method is overridden (not overloaded) inthe World and Turtle classes 
so as to return a string value describing the object. 
Answer 44 (p. 551) 


3.3.5.3.45 Question 45 


True or False? The code in Listing 7 (p. 544) replaces the default all-white picture ina World object with 
another picture. (Note, the variable named mars contains a reference to an object of the class World 


Listing 7 . Question 45. 


public void run()f{ 
mars.setPicture(new Picture("Prob01.jpg")); 


Table 3.209 


Answer 45 (p. 551) 
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3.3.5.3.46 Question 46 


True or False? The background of a World object consists of an object of Ericson’s Picture class. (A 
Picture object is encapsulated in the World object.) 
Answer 46 (p. 551) 


3.3.5.3.47 Question 47 


True or False? The code in Listing 8 (p. 545) uses two levels of indirection to add my name to the picture 
that forms the background of the world shown in Image 1 (p. 548) . 


Listing 8 . Question 47. 


mars.getPicture() .toString( 
"Dick Baldwin",10,20); 


Table 3.210 


Dick Baldwin 
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World 
Dick Baldwin 
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Image 1 . Question 47. 


Dick Baldwin 


Table 3.211 


Answer 47 (p. 550) 


3.3.5.3.48 Question 48 


True or False? A Turtle object encapsulates many methods that can be used to manipulate the turtle in 
a variety of different ways. 
Answer 48 (p. 550) 


3.3.5.3.49 Question 49 


True or False? A call to the forward method of a turtle object with no parameters causes the turtle to 
move forward by a default distance of 100 pixels. 
Answer 49 (p. 550) 


3.3.5.3.50 Question 50 


True or False? A call to the moveTo method of a turtle object with a single parameter value of 150 
causes the turtle to move forward by a distance of 150 pixels. 
Answer 50 (p. 550) 
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3.3.5.4 Images 
e Image 1 (p. 548) . Question 47. 


3.3.5.5 Listings 


e Listing 1 (p. 537) . Question 1. 
e Listing 2 (p. 538) . Question 8. 
e Listing 3 (p. 555) . Answer 8. 

e Listing 4 (p. 539) . Question 12. 
e Listing 5 (p. 542) . Question 26. 
e Listing 6 (p. 544) . Question 42. 
e Listing 7 (p. 544) . Question 45. 
e Listing 8 (p. 545) . Question 47. 
e Listing 9. (p. 551) Answer 47. 


What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None 


Display your name 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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3.3.5.6 Answers 
3.3.5.6.1 Answer 50 


False. The moveTo method of the Turtle class cannot be called with a single parameter. Two parameters 
are required. 


Back to Question 50 (p. 548) 
3.3.5.6.2 Answer 49 
True. 

Back to Question 49 (p. 548) 
3.3.5.6.3 Answer 48 
True. 

Back to Question 48 (p. 548) 
3.3.5.6.4 Answer 47 


False. The code in Listing 8 (p. 544) won’t compile. The toString method does not apply to images. The 
correct code is shown in Listing 9 (p. 551) . 
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Listing 9 . Answer 47. 


mars.getPicture() .addMessage( 
"Dick Baldwin",10,20); 


Table 3.212 


Back to Question 47 (p. 545) 


3.3.5.6.5 Answer 46 
True. 
Back to Question 46 (p. 545) 
3.3.5.6.6 Answer 45 
True. 
Back to Question 45 (p. 544) 
3.3.5.6.7 Answer 44 
True. 
Back to Question 44 (p. 544) 
3.3.5.6.8 Answer 43 
False. Code in the println method calls a method named toString on each incoming object reference 
and displays the string value returned by that method. 
Back to Question 43 (p. 544) 
3.3.5.6.9 Answer 42 
True. 
Back to Question 42 (p. 544) 
3.3.5.6.10 Answer 41 
False. Everything in Java is passed and returned by value , not by reference. 
Back to Question 41 (p. 544) 
3.3.5.6.11 Answer 40 


False. If there is a need to make the contents of those variables available outside the object, that should be 
accomplished by defining public accessor methods. 

Back to Question 40 (p. 543) 
3.3.5.6.12 Answer 39 


True. 
Back to Question 39 (p. 543) 
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3.3.5.6.13 Answer 38 


False. 
The default values are: 


e 0 or 0.0 for numeric variables 
e false for boolean variables 
e null for reference variables 


Back to Question 38 (p. 543) 


3.3.5.6.14 Answer 37 
True. 
Back to Question 37 (p. 543) 
3.3.5.6.15 Answer 36 
False. When an object is instantiated, the constructor returns a reference to the new object. 
Back to Question 36 (p. 543) 
3.3.5.6.16 Answer 35 
True. 
Back to Question 35 (p. 543) 
3.3.5.6.17 Answer 34 
True. 
Back to Question 34 (p. 543) 
3.3.5.6.18 Answer 33 
True. 
Back to Question 33 (p. 543) 
3.3.5.6.19 Answer 32 


False. The code in Listing 5 (p. 542) instantiates one object of the World class and populates that world 
with two objects of the Turtle class. 
Back to Question 32 (p. 542) 


3.3.5.6.20 Answer 31 


False. The three variables declared in Listing 5 (p. 542) are reference variables (as opposed to primitive 
variables) . This means that they are capable of storing references to objects as opposed to simply being 
able to store values of the eight primitive types. It also means that they are incapable of storing values of 
the eight primitive types. 

Back to Question 31 (p. 542) 


3.3.5.6.21 Answer 30 


True. 
Back to Question 30 (p. 542) 
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3.3.5.6.22 Answer 29 
True. 
Back to Question 29 (p. 542) 
3.3.5.6.23 Answer 28 
False. Because these variables are declared private , they can only be accessed by code contained in 
methods defined inside the same class (and in inner classes of the class, which is beyond the scope of this 
module) . 
Back to Question 28 (p. 542) 
3.3.5.6.24 Answer 27 
True. 
Back to Question 27 (p. 542) 
3.3.5.6.25 Answer 26 
True. 
Back to Question 26 (p. 541) 
3.3.5.6.26 Answer 25 
True. 
Back to Question 25 (p. 540) 
3.3.5.6.27 Answer 24 
False. The method named println that is called in Listing 1 (p. 537) is a method belonging to a standard 
system object that represents the standard output device (usually the command-line screen) . The purpose 
of the println method is to display material on the command-line screen. 
Back to Question 24 (p. 540) 
3.3.5.6.28 Answer 23 
True. 
Back to Question 23 (p. 540) 
3.3.5.6.29 Answer 22 
True. 
Back to Question 22 (p. 540) 
3.3.5.6.30 Answer 21 


True. 
Back to Question 21 (p. 540) 
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3.3.5.6.31 Answer 20 


False. 
In general, the type of the variable must be: 


e The name of the class, or 
e The name of a superclass of the class, or 
e The name of an interface implemented by the class. 


Back to Question 20 (p. 540) 


3.3.5.6.32 Answer 19 
True. 
Back to Question 19 (p. 539) 
3.3.5.6.33 Answer 18 
False. The period ahead of the semicolon in Listing 4 (p. 539) says to search the current folder first. 
Back to Question 18 (p. 539) 
3.3.5.6.34 Answer 17 
False. The purpose of the classpath is to tell the compiler and the virtual machine where to look for previously 
compiled class files that the application needs in order to successfully compile and execute. 
Back to Question 17 (p. 539) 
3.3.5.6.35 Answer 16 
True. 
Back to Question 16 (p. 539) 
3.3.5.6.36 Answer 15 
True 
Back to Question 15 (p. 539) 
3.3.5.6.37 Answer 14 
False. The Prob01.java and Prob01 at the ends of the two commands in Listing 4 (p. 539) specify the 
files being operated on by the compiler and the virtual machine respectively. 
Back to Question 14 (p. 539) 
3.3.5.6.38 Answer 13 
False. The Java compiler program is named javac.exe . The virtual machine is named java.exe . 
Back to Question 13 (p. 539) 
3.3.5.6.39 Answer 12 


True. 
Back to Question 12 (p. 538) 
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3.3.5.6.40 Answer 11 
True. 

Back to Question 11 (p. 538) 
3.3.5.6.41 Answer 10 
True. 

Back to Question 10 (p. 538) 
3.3.5.6.42 Answer 9 
True. 

Back to Question 9 (p. 538) 
3.3.5.6.43 Answer 8 


False. The required command is shown in Listing 3 (p. 555) . 


Listing 3 . Answer 8. 


javac Prob01.java 


Table 3.213 


Back to Question 8 (p. 538) 


3.3.5.6.44 Answer 7 

True. 
Back to Question 7 (p. 538) 

3.3.5.6.45 Answer 6 

False. The name of the application shown in Listing 1 (p. 537) is Prob01 
Back to Question 6 (p. 537) 

3.3.5.6.46 Answer 5 

True. 
Back to Question 5 (p. 537) 

3.3.5.6.47 Answer 4 

False. Java applets do not require a method named main . 
Back to Question 4 (p. 537) 

3.3.5.6.48 Answer 3 


True. 
Back to Question 3 (p. 537) 
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3.3.5.6.49 Answer 2 


False. java.awt.Color belongs to the Java standard edition class library. 
Back to Question 2 (p. 537) 


3.3.5.6.50 Answer 1 


True. 
Back to Question 1 (p. 536) 


3.3.5.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3002r Review: Creating and Manipulating Turtles and Pictures in a World 
Object 

e File: Java3002r-htm 

e Published: 02/10/13 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.6 Java3002s Slides'™ 
3.3.6.1 Table of Contents 


e Instructions for viewing slides (p. 557) 
e Miscellaneous (p. 557) 


4This content is available online at <http://cnx.org/content /m45621/1.5/>. 
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3.3.6.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3002: Creating and Manipulating Turtles 
and Pictures in a World Object 1” . 

Click here !?° to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.6.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3002s Slides: Creating and Manipulating Turtles and Pictures in a World 
Object 

e File: Java3002s.htm 

e Published: 01/05/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.7 Java3004: Image Processing Algorithms, Image Inversion, and PictureEx- 
plorer Objects” 


3.3.7.1 Table of Contents 
e Preface (p. 558) 
Viewing tip (p. 558) 


x Images (p. 558) 
x Listings (p. 558) 


125http://cnx.org/content /m44149 
226http://cnx.org/content /m45621/latest /a0-Index.htm 
127 This content is available online at <http://cnx.org/content /m44203/1.7/>. 
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Preview (p. 558) 

Discussion and sample code (p. 567) 
Run the program (p. 572) 

Summary (p. 572) 

What’s next? (p. 572) 

Online video links (p. 572) 
Miscellaneous (p. 572) 

Complete program listing (p. 573) 


3.3.7.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 17° . 


3.3.7.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.3.7.2.1.1 Images 


Image 1 (p. 562) . The raw image. 

Image 2 (p. 566) . The modified image. 

Image 3 (p. 566) . Output text on the command line screen. 

Image 4 (p. ) . javadocs description of the explore method. 
(p. 570) . javadocs description of the getPixels method. 
(p ) . javadocs description of the Pixel class. 


Image 5 
Image 6 


3.3.7.2.1.2 Listings 


e Listing 1 (p. 567) . The driver class. 

e Listing 2 (p. 568) . Beginning of the class named Prob02Runner. 
e Listing 3 (p. 568) . The beginning of the run method. 

e Listing 4 (p. 569) . Implementing the algorithm. 

e Listing 5 (p. 571) . Display again and terminate. 

e Listing 6 (p. 574) . Complete program listing. 


3.3.7.3 Preview 


The program that I will explain in this module is designed to be used as a test of the student’s understanding 
of programming using Java and Ericson’s media library. 

The student is provided an image file named Prob02.jpg along with a pair of PictureExplorer 
windows containing the raw image and a modified version of the image. (See Image 1 (p. 562) and Image 
2 (p. 566) .) 

Deduce the algorithm 


228http://cnx.org/content /m44148/latest / 
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The first part of the test is to determine if the student can examine the raw image shown in the 
PictureExplorer window in Image 1 (p. 562) and deduce the algorithm required to produce the output 
shown in the PictureExplorer window in Image 2 (p. 566) . 

Implement the algorithm 

The second part of the test is to determine if the student can implement the algorithm once it is established 
and also satisfy some requirements for text output on the command line screen. Among other things, this 
requires that the student be able to: 


Create a Picture object from an image file. 

Write an accessor method to return a reference to the Picture object. 

Modify the pixels in the picture according to the algorithm. 

Display the raw picture and the modified picture in PictureExplorer objects by calling the explore 
method on the Picture object before and after it is modified. 


Program output 
The raw image is displayed in the PictureExplorer window shown in Image 1 (p. 562) . 


Prob02.jpg 


— ip 
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ProbO02.jpg 
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Image 1 . The raw image. 


Prob02.jpg 


Dick Baldwin 


Table 3.214 


The modified image is shown in the PictureExplorer window in Image 2 (p. 566) . 
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I o 
SKI b > vdo > 


R: 180 G: 132 B: 0 Color at location: | | 
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| Image 2 . The modified image. 


„joli 


T He 


R: 180 G: 132 B: 0 Color at location: || 


Table 3.215 


The required output on the command-line screen is shown by the last two lines of text in Image 3 (p. 
566) . The other text in Image 3 (p. 566) is produced by the system during the compilation and execution 
process. 


Image 3 . Output text on the command line screen. 


continued on next page 
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java version "1.6.0_14" 
Java(TM) SE Runtime Environment (build 1.6.0_14-b08) 
Java HotSpot (TM) Client VM (build 14.0-b16, mixed mode, 
sharing) 
javac 1.6.0_14 


Dick Baldwin 
Picture, filename Prob02.jpg height 274 width 365 


Table 3.216 


The algorithm 
The algorithm required to transform the image from Image 1 (p. 562) to Image 2 (p. 566) is: 


e Set the blue color value for every pixel to zero. 
e Invert the red and green color values for every pixel. 


A color value is inverted by subtracting the value from 255. 

Obvious that the blue color value is reduced to zero 

It should be obvious to the student when comparing the two images in the PictureExplorer objects 
that the blue pixel value has been set to zero for every pixel in the modified image. 

Color inversion is not quite so obvious 

Deducing that the red and green colors in the output pixels are the inverse of the red and green colors 
in the input image isn’t as straightforward. However, color inversion is one of the examples provided in the 
Ericson textbook, so that should serve as a clue to the student. I have also published several online tutorials 
that involve color inversion. 

The implementation of the algorithm will be explained below. 


3.3.7.4 Discussion and sample code 


Will explain in fragments 

I will explain this program in fragments. A complete listing is provided in Listing 6 (p. 574) near the 
end of the module. 

I will begin with the driver class named Prob02 , which is shown in its entirety in Listing 1 (p. 567) . 


Listing 1 . The driver class. 


public class Prob02{//the driver class 
public static void main(String[] args){ 
ProbO2Runner obj = new ProbO02Runner() ; 


obj .run(); 
System. out.println(obj.getPicture()); 


}//end main 
}//end class Prob02 


Table 3.217 
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You should already be familiar with everything in Listing 1 (p. 567) . The most important aspect of 
Listing 1 (p. 567) for purposes of this discussion is the call to the run method belonging to the object 
instantiated from the Prob0O2Runner class. I will explain the run method shortly. 

Beginning of the class named Prob02Runner 
The class definition for the class named Prob02Runner begins in Listing 2 (p. 568) . 


Listing 2 . Beginning of the class named Prob02Runner. 


class ProbO2Runner{ 
private Picture pic = new Picture("Prob02. jpg"); 


public Prob02Runner () {//constructor 
System.out.println("Dick Baldwin"); 
}//end constructor 


//Accessor method 
public Picture getPicture(){return pic;} 


Table 3.218 


Again, you should be familiar with everything in Listing 2 (p. 568) . I will simply highlight the instan- 
tiation of anew Picture object using an image file as input and the saving of a reference to that object 
in the private instance variable named pic 

The beginning of the run method 
The run method begins in Listing 3 (p. 568) . This is where the action is, so to speak. 


Listing 3 . The beginning of the run method. 


public void run(){ 
pic.addMessage("Dick Baldwin",10,20) ; 


pic.explore(); 


Table 3.219 


You are already familiar with the call to the addMessage method to add my name as text to the 
image encapsulated in the Picture object. ( See Image 1 (p. 562) .) 

The explore method 

The call to the explore method is new to this module. 

The explore method is defined inthe SimplePicture class, which is the superclass of the Picture 
class. The method is inherited into the Picture class. 

javadocs description of the explore method 

The javadocs description of this method is shown in Image 4 (p. 569) . 
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Image 4 . javadocs description of the explore method. 


Method to open a picture explorer on a copy of this simple picture. 


Table 3.220 


Result of calling the explore method 

The result of calling the explore method in Listing 3 (p. 568) is to create and display the Picture- 
Explorer object shown in Image 1 (p. 562) . 

Very important capability 

The availability of the explore method and the PictureExplorer class is very important in at least 
two respects: 


e The explore method makes it easy to display copies of an image at various stages during the 
processing of the image. Once the PictureExplorer object is created and displayed, it won’t be 
effected by subsequent changes to the image. 

e The availability of a PictureExplorer object makes it easy to manually analyze the colors of the 
individual pixels in an image encapsulated in that object. 


Implementing the algorithm 
The code in Listing 4 (p. 569) implements the algorithm required to modify the original image to make 
it look like the image shown in Image 2 (p. 566) . 


Listing 4 . Implementing the algorithm. 


Pixel[] pixelArray = pic.getPixels(); 


for(Pixel pixel:pixelArray ){ 
pixel.setRed(255 - pixel.getRed()); 
pixel.setGreen(255 - pixel.getGreen()); 
pixel.setBlue(0) ; 

}//end for loop 


Table 3.221 


In particular, the code in Listing 4 (p. 569) sets the blue color components to 0 and inverts the red and 

green color components for every pixel in the picture. 
One of several approaches 

There are several ways to do this, and this is only one of those ways. This approach makes use of a 
method named getPixels that is defined in the SimplePicture class and inherited into the Picture 
class. 

Very useful when... 

This approach is particularly useful when you want to perform the same action on every pixel in an 
image. The advantage is that you don’t have to worry about horizontal and vertical coordinates with this 
approach. Access to all of the pixels is provided in a one-dimensional array. 

javadocs description of the getPixels method 

The javadocs description of this method is shown in Image 5 (p. 570) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


566 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Image 5 . javadocs description of the getPixels method. 


Method to get a one-dimensional array of 
Pixels for this simple picture. 


Returns: a one-dimensional array of Pixel 
objects starting with y=0 to y=height-1 
and x=0 to x=width-1. 


Table 3.222 


What is a Pixel object? 
An object of Ericson’s Pixel class encapsulates an individual pixel from an image. Image 6 (p. 570) 
shows the javadocs description of the Pixel class. 


Image 6 . javadocs description of the Pixel class. 


Class that references a pixel in a picture. 
A pixel has an x and y location in a picture. 


A pixel knows how to get and set the red, green, 
blue, and alpha values in the picture. 


A pixel also knows how to get and set the color 
using a Color object. 


Table 3.223 


Many methods available 

The Pixel class defines a large number of methods. Once you have a reference to a Pixel object, you 
can manipulate the underlying pixel encapsulated in that object in a variety of ways. 

Get the pixels in the image 

Recall that a reference to the Picture object that encapsulates our image is stored in the variable 
named pic . (See Listing 2 (p. 568) .) 

Listing 4 (p. 569) begins by calling the getPixels method on that reference. 

All of the pixels in the image are returned in a one-dimensional array. 

A reference to the array is stored in a local reference variable of type Pixel[] named pixelArray 

A for-each loop 

A special kind of for loop (often called a for-each loop) is used to access and process each pixel in the 
array. (A conventional for loop could also be used here.) 

During each iteration of the loop... 

The three statements inside the loop modify the color values of a single pixel. 

The first two statements invert the red and green color values by subtracting the values from 255. 

The third statement in the loop sets the blue color value to zero. 

When the loop terminates... 

Every pixel in the image will have been modified as described above. 
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Not a reversible process 

Because the blue color values were set to zero, the image has now been modified in an irreversible manner. 

A reversible process 

However, if the blue color values had also been inverted, the process would be reversible. 

All that would be necessary to recover the original image would be to invert all of the pixels again. 

An important process 

Color inversion is a very important process in many areas of computing that involve images. The process 
is: 


Computationally cheap 
Very fast 

Usually visually obvious 
Totally reversible 


Often used to highlight selected images 

For example, many software program invert all of the colors in an image when it is selected for some 
purpose, such as copying to the clipboard. Then the colors are restored to their original values when the 
image is deselected. 

Next to redeye correction, color inversion is probably the most commonly used color modification algo- 
rithm in use in modern image processing. 

Display again and terminate 

The variable named pic still contains a reference to the original Picture object. However, the image 
that is encapsulated in that object has been significantly modified. 

Listing 5 (p. 571) calls the explore method again, creating and displaying another PictureExplorer 
object that encapsulates a copy of the Picture object with the modified image. 


Listing 5 . Display again and terminate. 


pic.explore() ; 


}//end run method 
}//end class Prob02Runner 


Table 3.224 


The result is shown in Image 2 (p. 566) . 

The end of the program 

Listing 5 (p. 571) also signals the end of the run method and the end of the ProbO2Runner class. 

Return control to main 

The run method terminates and returns control to the main method in Listing 1 (p. 567) . 

The code in the main method calls a getter method to get a reference to the Picture object. 

The reference is passed to the println method, which displays the information about the Picture 
object in the last line of Image 3 (p. 566) . 

The program terminates 

Then the main method terminates, at which time the program terminates and returns control to the 
operating system. 
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3.3.7.4.1 Run the program 


I encourage you to copy the code from Listing 6 (p. 574) , compile it and execute it. Experiment with the 
code, making changes, and observing the results of your changes. Make certain that you can explain why 
your changes behave as they do. 

You can download a copy of the raw image file here 17° . 


3.3.7.5 Summary 


In this module, you learned how to invert images and how to display images in PictureExplorer objects. 


3.3.7.6 What’s next? 


Y ou will learn how to implement a space-wise linear color-modification algorithm in the next module. 


3.3.7.7 Online video links 


Select the following links to view online video lectures on the material in this module. 


e ITSE 2321 Lecture 02 130 


Part01 131 
Part02 18? 
Part03 133 
Part04 134 


3.3.7.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Image Processing Algorithms, Image Inversion, and PictureExplorer 
Objects 

e File: Java3004.htm 

e Published: 07/29/12 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 


!29%http://cnx.org/content /m44203/latest / Prob02.jpg 
130http://www.youtube.com/playlist?list=PL713DB9A 1FF4B92DF 
131 http://www-youtube.com/watch?v=SVq_IN4TsTs 
132http://www.youtube.com/watch?v=vc VLr8Z1mo04 
133http://www.youtube.com/watch?v=M1Nns7vYTiM 
134http://www.youtube.com/watch?v=Qw-yzEGuFJU 
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a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.3.7.9 Complete program listing 


A complete listing of the program discussed in this module is shown in Listing 6 (p. 574) below. 
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Listing 6 . Complete program listing. 


/*File Prob02 Copyright 2008 R.G.Baldwin 
JOSS O OOO OGIO IORI A IOI ISI I II II I ISI A a Kk kk ak ka 4 / 


public class Prob02{//the driver class 
public static void main(String[] args){ 
ProbO2Runner obj = new ProbO02Runner() ; 
obj .run(); 
System. out.println(obj.getPicture()); 
}//end main 
}//end class Prob02 


class ProbO2Runner{ 
private Picture pic = new Picture("Prob02. jpg"); 


public Prob02Runner () {//constructor 
System.out.println("Dick Baldwin"); 
}//end constructor 


//Accessor method 
public Picture getPicture(){return pic;} 


//This method is where the action is. 
public void run(){ 
//Display the raw picture. 
pic.addMessage("Dick Baldwin",10,20) ; 
pic.explore(); 


//Set the blue color components to 0 and invert the 

// red and green color components for every pixel in 

// the picture. 

Pixel[] pixelArray = pic.getPixels(); 

for(Pixel pixel:pixelArray ){ 
pixel.setRed(255 - pixel.getRed()); 
pixel.setGreen(255 - pixel.getGreen()); 
pixel.setBlue(0) ; 

}//end for loop 


//Display the modified picture 
pic.explore(); 
}//end run method 
}//end class Prob02Runner 


Table 3.225 


-end- 
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3.3.8 Java3004r Review” 
3.3.8.1 Table of Contents 


Preface (p. 575) 
Questions (p. 575) 


1 (p. 575) , 2 (p. 575) , 3 (p. 576) , 4 (p. 579) , 5 (p. 579) , 6 (p. 583) , 7 (p. 583) , 8 (p. 584) , 
9 (p. 584) , 10 (p. 584) , 11 (p. 584) 


Images (p. 584) 
Listings (p. 584) 
Answers (p. 586) 
Miscellaneous (p. 591) 


3.3.8.2 Preface 


This module contains review questions and answers keyed to the module titled Image Java3004: Processing 
Algorithms, Image Inversion, and PictureExplorer Objects 136 . 
The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 
3.3.8.3 Questions 
3.3.8.3.1 Question 1 
True or False? A color value is inverted by subtracting the value from 256. 
Answer 1 (p. 590) 
3.3.8.3.2 Question 2 


True or False? The code in Listing 1 (p. 575) instantiates a new object of the PictureExplorer class. 


Listing 1 . Question 2. 


class ProbO2Runner{ 
private Picture pic = new Picture("Prob02. jpg"); 


public Prob02Runner () {//constructor 
System.out.println("Dick Baldwin"); 
}//end constructor 


//Accessor method 
public Picture getPicture(){return pic;} 


Table 3.226 


Answer 2 (p. 590) 


135This content is available online at <http://cnx.org/content/m45763/1.7/>. 
136http://cnx.org/content /m44203 
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3.3.8.3.3 Question 3 


True or False? The code in Listing 2 (p. 576) causes an image to be displayed in the format shown in Image 
1 (p. 579) . 


Listing 2 . Question 3. 


public void run()f{ 
pic.addMessage("Dick Baldwin",10,20) ; 


pic.explore(); 


Table 3.227 


Prob05a.jpg 


Put your name here 
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Put your name here 
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Prob05a.jpg 


Put your name here 
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Image 1 . Question 3. 


Prob05a.jpg 


Put your name here 


Table 3.228 


Answer 3 (p. 586) 


3.3.8.3.4 Question 4 


True or False? The availability of the explore method and the PictureExplorer class is very important 
in at least two respects: 


e The explore method makes it easy to display copies of an image at various stages during the 
processing of the image. Once the PictureExplorer object is created and displayed, it won’t be 
effected by subsequent changes to the image. 

e The availability of a PictureExplorer object makes it easy to manually analyze the colors of the 
individual pixels in an image encapsulated in that object. 


Answer 4 (p. 586) 


3.3.8.3.5 Question 5 


True or False? The algorithm shown in Listing 3 (p. 580) can be used to cause the image shown in Image 2 
(p. 590) to be transformed into the image shown in Image 3 (p. 583) . 
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Listing 3 . Question 5. 


Pixel[] pixelArray = pic.getPixels(); 


for(Pixel pixel:pixelArray ){ 
pixel.setRed(255 - pixel.getRed()); 
pixel.setGreen(255 - pixel.getGreen()); 
pixel.setBlue(0) ; 

}//end for loop 


Table 3.229 


= 15] x| 


e | 


R: 180 G: 132 B: 0 Color at location: W 
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R: 180 G: 132 B: 0 Color at location: | | 
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| Image 3 . Question 5. 


„joli 


T He 


R: 180 G: 132 B: 0 Color at location: || 


Table 3.230 
Answer 5 (p. 586) 


3.3.8.3.6 Question 6 


True or False? An object of Ericson’s Pixel class encapsulates an individual pixel from an image. 
Answer 6 (p. 586) 


3.3.8.3.7 Question 7 


True or False? The Pixel class defines a single method that can be called to invert the color of the pixel. 
Answer 7 (p. 586) 
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3.3.8.3.8 Question 8 


True or False? The getPixels method belonging to a Picture object returns references to all of the 
Pixel objects encapsulated in the picture in a two-dimensional array where the dimensions of the array 
represent the horizontal and vertical coordinates of each pixel. 

Answer 8 (p. 586) 


3.3.8.3.9 Question 9 


True or False? The for loop shown in Listing 3 (p. 580) is of a type that is often referred to asa for-each 
loop. 
Answer 9 (p. 586) 


3.3.8.3.10 Question 10 


True or False? The three statements inside the loop in Listing 3 (p. 580) modify the color values of a single 
pixel. 
Answer 10 (p. 586) 


3.3.8.3.11 Question 11 


True or False? If the colors of all the pixels in an image are inverted, the process is completely reversible. 
All that is necessary to recover the original image is to invert all of the pixels again. 
Answer 11 (p. 586) 


3.3.8.4 Images 


e Image 1 (p. 579) . Question 3. 
e Image 2 (p. 590) . Answer 3. 
e Image 3 (p. 583) . Question 5. 


3.3.8.5 Listings 


e Listing 1 (p. 575) . Question 2. 
e Listing 2 (p. 576) . Question 3. 
e Listing 3 (p. 580) . Question 5. 


What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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3.3.8.6 Answers 
3.3.8.6.1 Answer 11 
True. 

Back to Question 11 (p. 584) 
3.3.8.6.2 Answer 10 
True. 

Back to Question 10 (p. 584) 
3.3.8.6.3 Answer 9 
True. 

Back to Question 9 (p. 584) 
3.3.8.6.4 Answer 8 


False. The getPixels method belonging to a Picture object returns references to all of the Pixel 
objects encapsulated in the picture in a one-dimensional array. 

Back to Question 8 (p. 584) 
3.3.8.6.5 Answer 7 


False. The Pixel class defines a large number of methods. Once you have a reference to a Pixel object, 
you can manipulate the underlying pixel encapsulated in that object in a variety of ways. 
Back to Question 7 (p. 583) 
3.3.8.6.6 Answer 6 
True. 
Back to Question 6 (p. 583) 
3.3.8.6.7 Answer 5 
True. 
Back to Question 5 (p. 579) 
3.3.8.6.8 Answer 4 
True. 
Back to Question 4 (p. 579) 
3.3.8.6.9 Answer 3 


False. The code in Listing 2 (p. 576) causes an image to be displayed in the format shown in Image 2 (p. 
590) . 
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ProbO02.jpg 
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Image 2 . Answer 3. 


Prob0?.jpg : [i | x| 


Table 3.231 
Back to Question 3 (p. 576) 


3.3.8.6.10 Answer 2 


False. The code in Listing 1 (p. 575) instantiates a new object of the Picture class. 
Back to Question 2 (p. 575) 


3.3.8.6.11 Answer 1 


False. A color value is inverted by subtracting the value from 255 . 
Back to Question 1 (p. 575) 
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3.3.8.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3004r Review: Image Processing Algorithms, Image Inversion, and Pic- 
tureExplorer Objects 

e File: Java3004r.htm 

e Published: 02/10/13 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.9 Java3004s Slides'”’ 
3.3.9.1 Table of Contents 


e Instructions for viewing slides (p. 591) 
e Miscellaneous (p. 592) 


3.3.9.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3004: Image Processing Algorithms, 
Image Inversion, and PictureExplorer Objects 138 . 

Click here 13° to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


137 This content is available online at <http://cnx.org/content /m45622/1.4/>. 
138http://cnx.org/content /m44203 
189http://cnx.org/content /m45622/latest /a0-Index.htm 
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3.3.9.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3004s Slides: Image Processing Algorithms, Image Inversion, and Picture- 
Explorer Objects 

e File: Java3004s.htm 

e Published: 01/05/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
3.3.10 Java3006: Implementing a space-wise linear color-modification 
algorithm." 


3.3.10.1 Table of Contents 


e Preface (p. 593) 
Viewing tip (p. 593) 

x Images (p. 593) 

x Listings (p. 593) 
Preview (p. 593) 
Discussion and sample code (p. 602) 
Run the program (p. 606) 
Summary (p. 606) 
What’s next? (p. 606) 
Online video links (p. 606) 
Miscellaneous (p. 606) 
Complete program listing (p. 607) 


140 This content is available online at <http://cnx.org/content /m44204/1.7/>. 
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3.3.10.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 14! . 


3.3.10.2.1 Viewing tip 
I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.3.10.2.1.1 Images 


e Image 1 (p. 597) . The raw image. 
e Image 2 (p. 601) . The modified image. 
e Image 3 (p. 601) . Text output on the command-line screen. 


3.3.10.2.1.2 Listings 


. The driver class named Prob03. 


e Listing 1 (p. 602) 

e Listing 2 (p. 602) . Beginning of the class named Prob03Runner. 

e Listing 3 (p. 603) . The beginning of the run method. 

e Listing 4 (p. 604) . Beginning of the for loop. 

e Listing 5 (p. 604) . Compute the column number and scale factors. 
e Listing 6 (p. 605) . Apply the scale factors. 

e Listing 7 (p. 605) . Display the modified image. 

e Listing 8 (p. 608) . Complete program listing. 


3.3.10.3 Preview 


The program that I will explain in this module is designed to be used as a test of the student’s understanding 
of programming using Java and Ericson’s media library. 

The student is provided an image file named Prob03.jpg along with a written specification of a 
space-wise linear image modification algorithm. 

Implement the algorithm 

The primary purpose of the test is to determine if the student can implement the algorithm and also 
satisfy some requirements for text output on the command line screen. Among other things, this requires 
that the student be able to: 


Create a Picture object from an image file. 

Write an accessor method to return a reference to the Picture object. 

Modify the pixels in the picture according to the specified algorithm. 

Display the raw picture and the modified picture in PictureExplorer objects by calling the explore 
method on the Picture object before and after it is modified. 


The algorithm 
Scale the blue and green color components by a scale factor that is less than or equal to 1.0. The green 
scale factor: 


141 http://cnx.org/content /m44148/latest / 
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e Is equal to 1.0 on the left side of the image 
e Is equal to 0.0 on the right side of the image 
e Decreases linearly with distance going from left to right across the image. 


The blue scale factor 


e Is 0.0 on the left side of the image 
e Is 1.0 on the right side of the image 
e Increases linearly with distance going from left to right across the image. 


Do not scale the red color component. 
The program output 


The program produces the images shown in Image 1 (p. 597) and Image 2 (p. 601) and produces the 
output text shown in Image 3 (p. 601) on the command line screen. 
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ProbO3.jpa 
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Image 1 . The raw image. 


F3 prob03.ipa ME 


"Dick Baldwin 


Table 3.232 
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Ef Probo3ipo O O 
SKI b > v4] 0 > 


R: 75 G: 123 B: 0 Color at location: aa] 
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Ef Probo3ipo eS 
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Image 2 . The modified image. 


EA prob03.jpa 


x| 4] p > vllo > 


R: 75 G: 123 B: 0 Color at location: | | 


Table 3.233 


Image 3 . Text output on the command-line screen. 


java version "1.6.0_14" 
Java(TM) SE Runtime Environment (build 1.6.0_14-b08) 
Java HotSpot(TM) Client VM (build 14.0-b16, 
mixed mode, sharing) 
javac 1.6.0_14 


Dick Baldwin 
Picture, filename Prob03.jpg height 274 width 365 
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Table 3.234 


The required output on the command-line screen is shown by the last two lines of text in Image 3 (p. 601) 
. The remaining text in Image 3 (p. 601) is produced by the system during the compilation and execution 
process. 


3.3.10.4 Discussion and sample code 


Will explain in fragments 

I will explain this program in fragments. A complete listing is provided in Listing 8 (p. 608) near the 
end of the module. 

I will begin with the driver class named Prob03 , which is shown in its entirety in Listing 1 (p. 602) . 


Listing 1 . The driver class named Prob03. 


public class Prob03{ 
public static void main(String[] args){ 
ProbO3Runner obj = new ProbO3Runner() ; 
obj .run(); 
System. out.println(obj.getPicture()); 
}//end main 
}//end class Prob03 


Table 3.235 


There is nothing in Listing 1 (p. 602) that I haven’t explained in earlier modules. Therefore, no expla- 
nation of the code in Listing 1 (p. 602) should be required. 

Beginning of the class named Prob03Runner 

The class definition for the class named Prob03Runner begins in Listing 2 (p. 602) . 


Listing 2 . Beginning of the class named Prob03Runner. 


class ProbO3Runner{ 
//Instantiate the Picture object. 
private Picture pic = new Picture("Prob03. jpg"); 


public Prob03Runner () {//constructor 
System.out.println("Dick Baldwin"); 
}//end constructor 


//Accessor method 
public Picture getPicture(){return pic;} 


Table 3.236 
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Once again, there is nothing in Listing 2 (p. 602) that I haven’t explained before. I included it here 
simply for the sake of continuity. 

The beginning of the run method 

The run method begins in Listing 3 (p. 603) . The run method is where most of the interesting 
action takes place. 


Listing 3 . The beginning of the run method. 


public void run(){ 
pic.addMessage("Dick Baldwin",10,20) ; 
//Display a PictureExplorer object. 
pic.explore(); 


//Get an array of Pixel objects. 
Pixel[] pixels = pic.getPixels(); 


//Declare working variables 
Pixel pixel = null; 

int green = 0; 

int blue = 0; 

int width = pic.getWidth(); 
double greenScale = 0; 
double blueScale = 0; 


Table 3.237 


Much of what you see in Listing 3 (p. 603) has been explained in earlier modules. However, Listing 3 (p. 
603) does deserve a few comments. 
Display the raw image 
The call to the explore method produces the output shown in Image 1 (p. 597) . 
Get an array of Pixel data 
The call to the getPixels method in Listing 3 (p. 603) returns a reference to a one-dimensional array 
object. The elements in the array are references to Pixel objects, where each Pixel object represents a 
single pixel in the image. I will explain the organization of the pixel data later 4? . 
Get the width of the image 
The call to the getWidth method in Listing 3 (p. 603) returns an int value that specifies the width 
of the image in pixels. This value will be used later to compute the column to which each pixel belongs. 
Local variables 
Listing 3 (p. 603) declares six local variables. The purpose of these variables should become clear during 
the explanation of the code that implements the algorithm. 
Implementation of the algorithm 


The algorithm 14? is implemented by the code in a conventional for loop, which begins in Listing 4 (p. 
604) . 


'42http://cnx.org/content /m44204 /latest /Java3006old.htm#-Organization of the pixel data 
M43http://cnx.org/content /m44204/latest /Java3006old.htm#The_ algorithm 
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Listing 4 . Beginning of the for loop. 


for(int cnt = 0;cnt < pixels.length;cnt++){ 
pixel = pixels[cnt]; 
green = pixel.getGreen(); 


blue = pixel.getBlue(); 


Table 3.238 


The loop iterates through the array of Pixel data, modifying the colors in one pixel during each 
iteration. 

The length property of the array object 

Every array object in Java contains a length property that contains the number of elements in the 
array. The value of this property is used in the conditional clause in the for loop in Listing 4 (p. 604) to 
establish when the end of the array has been reached in order to terminate the loop. 

Get reference to the next Pixel object 

The first statement inside the for loop in Listing 4 (p. 604) gets a reference to a Pixel object from 
the next array element. That reference is stored in the local variable of type Pixel named pixel that 
was declared in Listing 3 (p. 603) . 

Get the red and green color values for the current pixel 

Having gotten a reference to the Pixel object, the next statement calls the getGreen method on 
that reference to get and save the value of the green color component in the current pixel. 

Similarly, the statement following that one gets and saves the value of the blue color component in the 
current pixel. 

Both values are returned as type int , and can range in value from 0 up to and including 255. 

Objective is to scale the green and blue color values 

Recall that the objective is to scale the green and blue color values on a column by column basis, going 
from left to right across the image shown in Image 1 (p. 597) in order to produce the output image shown 
in Image 2 (p. 601) . 

Organization of the pixel data 

The pixel data is stored in the array on a row by row basis. In other words, the first width elements 
contain references to pixels in the first row of pixels going from left to right across the screen. The next 
width elements contain references to pixels in the second row of pixels, etc. 

Compute the column number and scale factors 

Listing 5 (p. 604) uses the modulus operator to compute the column number for each Pixel object. 


Listing 5 . Compute the column number and scale factors. 


//Compute the column number and use it to compute 
// the scale factor. 
int col = cnt%width; 


greenScale = (double) (width - col)/width; 
pblueScale = (double) (col) /width; 
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Table 3.239 


An exercise for the student 

Knowing the column number in which the pixel is located, the next step is to compute the green and 
blue scale factors necessary to satisfy the algorithm. 

I will leave it as an exercise for the student to think about how the expressions contained in the last two 
statements in Listing 5 (p. 604) cause the two scale factors to vary linearly from left to right across the 
image in accordance with the requirements of the algorithm. (Think about the equation of a straight line 
from your high school math classes.) 

Apply the scale factors 

The Pixel class contains methods named setRed , setGreen , and setBlue that can be called 
to set the color values for the pixel represented by a Pixel object. 

Listing 6 (p. 605) computes new values for the red and green components based on the existing color 
values for the pixel and the scale factors computed in Listing 5 (p. 604) . 


Listing 6 . Apply the scale factors. 


pixel.setGreen((int) (green * greenScale)) ; 
pixel.setBlue((int) (blue * blueScale)) ; 
}//end for loop 


Table 3.240 


Then Listing 6 (p. 605) calls the setGreen and setBlue methods on the Pixel object to set the 
green and blue color values to the newly computed values. 

The end of the for loop 

Listing 6 (p. 605) also signals the end of the for loop that began in Listing 4 (p. 604) . 

Display the modified image 

Finally, Listing 7 (p. 605) calls the explore method again to display the image shown in Image 2 (p. 
601) . 


Listing 7 . Display the modified image. 


pic.explore() ; 


}//end run method 
}//end class Prob03Runner 


Table 3.241 


The end of the program 

Listing 7 (p. 605) also signals the end of the run method and the end of the ProbO03Runner class. 

Return control to main 

The run method terminates and returns control to the main method shown in Listing 1 (p. 602) . 

The code in the main method calls a getter method to get a reference to the Picture object. 

The reference is passed to the printlIn method, which displays the information about the Picture 
object in the last line of Image 3 (p. 601) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


602 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


The program terminates 
Then the main method terminates, at which time the program terminates and returns control to the 
operating system. 


3.3.10.4.1 Run the program 


I encourage you to copy the code from Listing 8 (p. 608) , compile it and execute it. Experiment with the 
code, making changes, and observing the results of your changes. Make certain that you can explain why 
your changes behave as they do. 


You can download a copy of the required input image file here 144 . 


3.3.10.5 Summary 


In this module, I showed you how to implement an algorithm that causes the green and blue color values in 
an image to change in a linear fashion going from left to right across the image. 


3.3.10.6 What’s next? 


You will learn more about abstract methods, abstract classes, and overridden methods in the next lesson. 
Very importantly, you will learn more about overriding the toString method. 


3.3.10.7 Online video links 


Select the following links to view online video lectures on the material in this module. 


e ITSE 2321 Lecture 03 !45 


Part01 146 
Parto2 147 
Part03 148 


3.3.10.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Implementing a space-wise linear color-modification algorithm 
e File: Java3006.htm 

e Published: 07/30/12 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


M44http://cnx.org/content /m44204/latest /Prob03.jpg 
M45http://www-.youtube.com/playlist?list=PL43014B9ED4419642 
M46http://www.youtube.com/watch?v=pdqKvAuzkhg 

M47 http://www-youtube.com/watch?v—aXoSD7oauLQ 
M48http://www-youtube.com/watch?v=liRiXhTPmMU 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 

Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.3.10.9 Complete program listing 
A complete listing of the program discussed in this module is shown in Listing 8 (p. 608) below. 
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Listing 8 . Complete program listing. 


/*File Prob03 Copyright 2008 R.G.Baldwin 
FOSS IOC IAAI CISC ISIS I II I I I ISI I a Kf ak ak ak ka 4 / 


public class Prob03{ 
public static void main(String[] args){ 
ProbO3Runner obj = new ProbO03Runner() ; 
obj .run(); 
System. out.println(obj.getPicture()); 
}//end main 
}//end class Prob03 


class ProbO03Runner{ 
//Instantiate the Picture object. 
private Picture pic = new Picture("Prob03. jpg"); 


public Prob03Runner () {//constructor 
System.out.println("Dick Baldwin"); 
}//end constructor 


//Accessor method 
public Picture getPicture(){return pic;} 


//This method is where the action is. 

public void run(){ 
pic.addMessage("Dick Baldwin",10,20) ; 
//Display a PictureExplorer object. 
pic.explore(); 


//Get an array of Pixel objects. 
Pixel[] pixels = pic.getPixels(); 


//Declare working variables 
Pixel pixel = null; 

int green = 0; 

int blue = 0; 

int width = pic.getWidthQ); 
double greenScale = 0; 
double blueScale = 0; 


//Scale the blue and green color components according 
// to the algorithm given above. 
//Do not scale the red component. 
for(int cnt = 0;cnt < pixels.length;cnt++){ 
//Get blue and green values for current pixel. 
pixel = pixels[cnt]; 
green = pixel.getGreen(); 
blue = pixel. etBlue() ; , 
vailable for free at Connexions <http://cnx.org/content/col11441/1.181> 
//Compute the column number and use it to compute 
// the scale factor. 
int col = cnt%width; 
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Table 3.242 


-end- 
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3.3.11 Java3006r Review” 
3.3.11.1 Table of Contents 
e Preface (p. 610) 
e Questions (p. 610) 
1 (p. 610) , 2 (p. 619) , 3 (p. 619) , 4 (p. 619) , 5 (p. 620) , 6 (p. 620) , 7 (p. 620) 


Images (p. 620) 
Listings (p. 620) 
Answers (p. 622) 
Miscellaneous (p. 622) 


3.3.11.2 Preface 


This module contains review questions and answers keyed to the module titled Java3006: Implementing a 
space-wise linear color-modification algorithm 15° . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.11.3 Questions 


3.3.11.3.1 Question 1 


True or False? The program shown in Listing 1 (p. 611) will transform the image shown in Image 1 (p. 615) 
into the image shown in Image 2 (p. 619) (or to an image that looks very similar to the image shown in 
Image 2 (p. 619) ). 


'49This content is available online at <http://cnx.org/content /m45768/1.3/>. 
150http://cnx.org/content /m44204 
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Listing 1 . Source code for Java3006r. 


/*File Java3006r Copyright 2013 R.G.Baldwin 
FE AG IO I IAAI ICAI AI I ICI I I I A E 21 21 E E 21 21 E EEE E EE E 2k E E / 


public class Java3006r{ 
public static void main(String[] args){ 
Java3006rRunner obj = new Java3006rRunner() ; 
obj .run(); 
System. out.println(obj.getPicture()); 
}//end main 
3//end class Java3006r 


class Java3006rRunner{ 
//Instantiate the Picture object. 
private Picture pic = new Picture("Java3006r. jpg") ; 


public Java3006rRunner (){//constructor 
System.out.println("Dick Baldwin"); 
}//end constructor 


//Accessor method 
public Picture getPicture(){return pic;} 


//This method is where the action is. 

public void run(){ 
pic.addMessage("Dick Baldwin",10, 20); 
//Display a PictureExplorer object. 
pic.explore(); 


//Get an array of Pixel objects. 
Pixel[] pixels = pic.getPixels(); 


//Declare working variables 
Pixel pixel = null; 

int green = 0; 

int blue = 0; 

int width = pic. getWidth(); 
double greenScale = 0; 
double blueScale = 0; 


//Scale the blue and green color components according 
// to the algorithm given above. 
//Do not scale the red component. 
for(int cnt = 0;cnt < pixels.length;cnt++){ 
//Get blue and green values for current pixel. 
pixel = pixels[cnt]; 
green = pixel.getGreen(); 
blue = pixelAvgpbblee (6 at Connexions <http://cnx.org/content /col11441/1.181> 


//Compute the column number and use it to compute 
// the scale factor. 
int col = cnt%width; 
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Table 3.243 
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aes 1 . The image from Java3006r.jpg. 
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Image 2 . Possible output image. 
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Table 3.245 


Answer 1 (p. 622) 


3.3.11.3.2 Question 2 


True or False? The output shown in Image 2 (p. 619) was produced by calling the show method of 
Ericson’s Picture class. 
Answer 2 (p. 622) 


3.3.11.3.3 Question 3 


True or False? A call to Ericson’s getPixels method returns a reference to a one-dimensional array object. 
The elements in the array are references to Pixel objects, where each Pixel object represents a single 
pixel in an image. 

Answer 3 (p. 622) 


3.3.11.3.4 Question 4 


True or False? A call to the getWidth method of Ericson’s Picture class returns a double value that 
specifies the width of the image in inches. 
Answer 4 (p. 622) 
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3.3.11.3.5 Question 5 


True or False? Every array object in Java contains a length property that contains the number of elements 
in the array. 

Answer 5 (p. 622) 
3.3.11.3.6 Question 6 


True or False? Having gotten a reference toa Pixel object, the getGreen method can be called on that 
reference to get the value of the red color component in the current pixel. 
Answer 6 (p. 622) 
3.3.11.3.7 Question 7 
True or False? Red, green, and blue color values range from 0 to 256. 
Answer 7 (p. 622) 
3.3.11.4 Images 


e Image 1 (p. 615) . The image from Java3006r.jpg. 
e Image 2 (p. 619) . Possible output image. 


3.3.11.5 Listings 
e Listing 1 (p. 611) . Source code for Java3006r. 


What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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3.3.11.6 Answers 
3.3.11.6.1 Answer 7 
False. Red, green, and blue color values range from 0 to 255 . 
Back to Question 7 (p. 620) 
3.3.11.6.2 Answer 6 
False. Having gotten a reference toa Pixel object, the getGreen method can be called on that reference 
to get the value of the green color component in the current pixel. 
Back to Question 6 (p. 620) 
3.3.11.6.3 Answer 5 
True. 
Back to Question 5 (p. 620) 
3.3.11.6.4 Answer 4 
False. A call to the getWidth method of Ericson’s Picture class returns an int value that specifies 
the width of the image in pixels. 
Back to Question 4 (p. 619) 
3.3.11.6.5 Answer 3 
True. 
Back to Question 3 (p. 619) 
3.3.11.6.6 Answer 2 
False. The output shown in Image 2 (p. 619) was produced by calling the explore method of Ericson’s 
Picture class. 
Back to Question 2 (p. 619) 
3.3.11.6.7 Answer 1 
True. 
Back to Question 1 (p. 610) 
3.3.11.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3006r Review: Implementing a space-wise linear color-modification algo- 
rithm 

e File: Java3006r.htm 

e Published: 02/12/13 

e Revised: 12/07/14 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


619 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.12 Java3006s Slides” 
3.3.12.1 Table of Contents 


e Instructions for viewing slides (p. 623) 
e Miscellaneous (p. 623) 


3.3.12.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3006: Implementing a space-wise linear 
color-modification algorithm 15? . 

Click here 153 to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.12.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3006s Slides: Implementing a space-wise linear color-modification algo- 
rithm 

e File: Java3006s.htm 

e Published: 01/06/13 


151 This content is available online at <http://cnx.org/content /m45623/1.3/>. 
152http://cnx.org/content /m44204 
153http://cnx.org/content /m45623/latest /a0-Index.htm 
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NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.13 Java3008: Abstract Methods, Abstract Classes, and Overridden 
Methods” 


3.3.13.1 Table of Contents 


e Preface (p. 624) 
Viewing tip (p. 624) 

x Images (p. 624) 

x Listings (p. 625) 
Preview (p. 625) 
Discussion and sample code (p. 625) 
Run the program (p. 631) 
Summary (p. 631) 
What’s next? (p. 631) 
Online video links (p. 631) 
Miscellaneous (p. 631) 
Complete program listings (p. 632) 


3.3.13.2 Preface 

This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

3.3.13.2.1 Viewing tip 

I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 
3.3.13.2.1.1 Images 


e Image 1 (p. 625) . Program output on the command line screen. 
e Image 2 (p. 629) . Default behavior of the toString method. 
e Image 3 (p. 629) . More on the default behavior of the toString method. 


154This content is available online at <http://cnx.org/content /m44205/1.7/>. 
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3.3.13.2.1.2 Listings 


. Source code for class Prob04. 


e Listing 1 (p. 626) 

e Listing 2 (p. 627) . Beginning of the class named Prob04MyClass. 
e Listing 3 (p. 628) . Override the abstract getData method. 

e Listing 4 (p. 629) . Override the toString method. 

e Listing 5 (p. 632) . Complete program listing. 


3.3.13.3 Preview 


The program that I will explain in this module produces no graphics and does not require the use of Ericson’s 
media library. 
OOP concepts 
The program illustrates the following OOP concepts: 


Extending an abstract class. 

Parameterized constructor. 

Defining an abstract method in the superclass and overriding it in a subclass. 
Overridden toString method. 


Program specifications 
Write a program named Prob04 that uses the class definition shown in Listing 1 (p. 626) to produce 
the output on the command-line screen shown in Image 1 (p. 625) . 


Image 1 . Program output on the command line screen. 


Prob04 
Dick 
Baldwin 
95 
95 


Table 3.246 


Pseudo random data 

Because the program generates and uses a pseudo random data value each time it is run, the actual 
values displayed in the last two lines of Image 1 (p. 625) will differ from one run to the next. However, in 
all cases, the two values must match. 

New classes 

You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named Prob04 given below. 


3.3.13.4 Discussion and sample code 


Will explain in fragments 
I will explain this program in fragments. A complete listing is provided in Listing 5 (p. 632) near the 


end of the module. 
I will begin with the driver class named Prob04 , which is shown in its entirety in Listing 1 (p. 626) . 
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Listing 1 . Source code for class Prob04. 


import java.util.*; 


abstract class Prob04{ 
public static void main(String[] args){ 
Random generator = new Random(new Date().getTime()); 
int randomNumber = (byte) generator.nextInt(); 


Prob04 objRef = new Prob04MyClass (randomNumber) ; 
System. out.println(objRef) ; 

System. out.println(objRef.getData()); 

System. out. println(randomNumber) ; 


}//end main 


//Declare the signature of an abstract class. 
public abstract int getData(); 


}//end class Prob04 


Table 3.247 


The import directive 

The import directive at the beginning of Listing 1 (p. 626) is required because the program requires 
access to the Random class and the Date class, both of which are defined in the java.util package. 

Lazy programming practice 

It would be better programming practice to provide two explicit import directives, one for the Random 
class and the other for the Date class. However, if you are lazy like I apparently was when I wrote this 
program, you can use the wildcard character (*) to import all of the classes in a package. 

An abstract method 

I’m going to begin by skipping down to the second line from the bottom in Listing 1 and explain the 
declaration of the abstract method named getData 

Purpose of an abstract method 

The purpose of an abstract method declaration is to establish the signature of a method that must be 
overridden in every (non-abstract) subclass of the class in which the abstract method is declared. 

An incomplete method 

As you can see the abstract method has no body. Therefore, it is incomplete, has no behavior, and cannot 
be executed. 

An abstract method must be overridden in a subclass in order to be useful. 

Override in different ways 

The same abstract method can be overridden in different ways in different subclasses. In other words, the 
behavior of the overridden version can be tailored to (appropriate for) the class in which it is overridden. 

A guarantee 

The existence of an abstract method in a superclass guarantees that every (non-abstract) subclass of 
that superclass will havea concrete (executable) version of a method having that same signature. 

An abstract class 

The class named Prob04 is declared abstract in Listing 1 (p. 626) . 

Any class can be declared abstract. The consequence of declaring a class abstract is that it is not possible 
to instantiate an object of the class. 
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Must be declared abstract... 

More importantly, a class must be declared abstract if it contains one or more abstract method decla- 
rations. The idea here is that it must not be possible to instantiate objects containing incomplete (non- 
executable) methods. 

The main method 

As you have seen in previous modules, the driver class for every Java application must contain a method 

named main with a signature matching that shown in Listing 1 (p. 626) . 
A pseudo-random number generator 

I will leave it as an exercise for the student to go to the javadocs and read up on the class named 

Random , along with the class named Date and the method named getTime 
Why pseudo-random? 

I refer to this as a pseudo-random number generator because the sequence will probably repeat after an 

extremely large number of values has been generated. 
An object of the class Random 

Briefly, however, the first statement in the main method in Listing 1 (p. 626) instantiates an object 

that will return a pseudo-random number each time certain methods are called on the object. 
Seeding the generator 

The value passed as a parameter to the Random constructor represents the current time and guarantees 
that the series of pseudo-random values returned by the methods will be different each time the program is 
run. This is commonly known as seeding the generator. 

Get and save a pseudo random value 

The next statement in Listing 1 (p. 626) 1 calls the nextInt method on the generator object to get 

and save the next value of type int in the pseudo-random sequence. 
Cast to type byte 

This value is cast to type byte , which discards all but the eight least significant bits of the int value. 
When it is stored in the variable named randomNumber of type int , the sign is extended through 
the most significant 24 bits and it becomes a value of type int that is guaranteed to be of relatively small 
magnitude. 

Why cast to byte? 

I cast the random value to type byte simply to cause the values that are displayed to be smaller and 
easier to compare visually. 

Instantiate an object of type Prob04MyClass 

The next statement in Listing 1 (p. 626) instantiates an object of the class named Prob04MyClass , 
passing the random value as a parameter to the constructor. At this point, I will put the explanation of the 
class named Prob04 on temporary hold and explain the class named Prob04MyClass_, which begins 
in Listing 2 (p. 627) . 


Listing 2 . Beginning of the class named Prob04MyClass. 


class Prob04MyClass extends Prob04{ 
private int data; 


public Prob04MyClass(int inData){//constructor 
System. out.println("Prob04") ; 
System. out.println("Dick") ; 
data = inData; 

}//end constructor 


Table 3.248 
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Extends the abstract class named Prob04 

First note that the class named Prob04MyClass extends the abstract class named Prob04 

Among other things, this means that either this class must override the abstract method named getData 
that was declared in the superclass, or this class must also be declared abstract. 

Does it override getData? 

Seeing that this class isn’t declared abstract, we can surmise at this point that it does override the 

abstract method named getData . We will see more about this later. 
Beginning of the class named Prob04MyClass 

The class definition in Listing 2 (p. 627) begins by declaring a private instance variable of type int 
named data . Note that it does not initialize the variable. Therefore, the value is automatically initialized 
to an int value of zero. 

The constructor 

Then Listing 2 (p. 627) defines the constructor for the class. The first two statements in the constructor 

cause the first two lines of text shown in Image 1 (p. 625) to be displayed on the command line screen. 
Save the incoming parameter value 

The last line in the constructor saves the incoming value in the instance variable named data 
overwriting the default value of zero that it finds there. 

This statement is more in keeping with the intended usage of a constructor than the first two statements. 
The primary purpose of a constructor is to assist in the initialization of the state of an object , which 
depends on the values stored in its variables. 

Override the abstract getData method 

Listing 3 (p. 628) overrides the abstract getData method declared in the abstract superclass named 

Prob04 and inherited into the subclass named Prob04MyClass 


3 


7 


Listing 3 . Override the abstract getData method. 


public int getData(){//overridden abstract method 
return data; 
}//end getData() 


Table 3.249 


Very simple behavior 

Although the overridden version of the method simply returns a copy of the value stored in the private 
instance variable named data , it is concrete (p. 626) and can be executed. We will see later that it is 
called in the main method of the driver class named Prob04 in Listing 1 (p. 626) . 

Override the toString method 

The ultimate superclass of every class is the predefined system class named Object . The Object 
class defines eleven methods with default behavior, including the method named toString 

Listing 4 (p. 629) overrides the inherited toString method, overriding the default behavior of the 
method insofar as objects of the class named Prob04MyClass are concerned. 


Listing 4 . Override the toString method. 


continued on next page 
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public String toString(){//overridden method 
return "Baldwin"; 
}//end overloaded toString () 


}//end class Prob04MyClass 


Table 3.250 


Default behavior of the toString method 
Ifthe toString method had not been overridden in the Prob04MyClass class, calling the toString 
method on an object of the class would return a string similar to that shown in Image 2. 


Image 2 . Default behavior of the toString method . 


Prob04MyClass0@42e816 


Table 3.251 


Image 2 (p. 629) shows the default behavior of the toString method as defined in the Object class. 
For this program, only the six hexadecimal digits at the end would change from one run to the next. 

More on the default behavior of the toString method 

Furthermore, if the toString method had not been overridden in the Prob04MyClass class, the 
output produced by the program on the command line screen would be similar to that shown in Image 3 (p. 
629) instead of that shown in Image 1 (p. 625) . 


Image 3 . More on the default behavior of the toString method. 


Prob04 
Dick 
Prob04MyClass@42e816 
-34 
-34 


Table 3.252 


Compare to see the difference 

If you compare Image 3 (p. 629) with Image 1 (p. 625) , you will see that the difference results from the 
fact that the overridden version of the toString method in Listing 4 (p. 629) returns "Baldwin" as a 
string rather than returning the default string shown in Image 2 (p. 629) . 

The end of the class named Prob04MyClass 

Listing 4 (p. 629) signals the end of the class definition for the class named Prob04MyClass 
Therefore, it is time to return to the explanation of the driver class shown in Listing 1 (p. 626) . 

Display information about the object 

When the Prob04MyClass constructor returns, Listing 1 (p. 626) calls the println method passing 
a reference to the new object as a parameter. 
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Many overloaded (not overridden) versions of printIn 

There are many overloaded versions of the println method, each of which requires a different type of 
incoming parameter or parameters. 

For example, different overloaded versions of the method know how to receive incoming parameters of 
each of the different primitive types, convert them to characters, and display the characters on the screen. 

An incoming parameter of type Object 

There is also an overloaded version of the println method that requires an incoming parameter of type 
Object . That is the version of the method that is executed when the reference to this object is passed to 
the method in Listing 1 (p. 626) . 

One object, several types 

Recall that the reference to this object can be treated as its true type, or as the type of any superclass. 
Therefore, the reference can be treated as any of the following types: 


Prob04MyClass 
Prob04 
Object 


Will satisfy type requirement... 

Because it can be treated as type Object , it will satisfy the type requirement for the overloaded 

version of the println method that requires an incoming parameter of type Object 
Call the toString method 

The first thing that this version of the println method does is to call the toString method on the 
incoming reference. Then it displays the string value returned by the toString method on the screen. 

In this case, the overridden toString method returns the string "Baldwin" , which is what you see 
displayed in Image 1 (p. 625) . 

Runtime polymorphism 

This is a clear example of an OOP concept known as runtime polymorphism . 

Runtime polymorphism is much too complicated to explain in this module. However, I explain it in 
detail in my online OOP modules and I strongly recommend that you study it there until you thoroughly 
understand it. 

A critical concept 

It is critical that you understand runtime polymorphism if you expect to go further in Java OOP. 

It is almost impossible to write a useful Java application without making heavy use of runtime polymor- 
phism, because that is the foundation of the event driven Java graphical user interface system. 

Call the overridden getData method 

The next statement in Listing 1 (p. 626) calls the overridden getData method and displays the return 
value. 

As you saw earlier, this method returns a copy of the random value that was received and saved by the 
constructor for the Prob04MyClass class in Listing 2 (p. 627) . 

Display the original random value 

Finally, the last statement in the main method in Listing 1 (p. 626) displays the contents of the 
instance variable named randomNumber . This variable contains the random value that was passed to 
the constructor for the Prob04MyClass earlier in Listing 1 (p. 626) . 

The two values must match 

Therefore, the final two statements in the main method in Listing 1 (p. 626) display the same random 
value. This is shown in the command line screen output in Image 1 (p. 625) . 

The program terminates 

After displaying this value, the main method terminates causing the program to terminate. 
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3.3.13.5 Run the program 


I encourage you to copy the code from Listing 5 (p. 632) , compile it and execute it. Experiment with the 
code, making changes, and observing the results of your changes. Make certain that you can explain why 
your changes behave as they do. 


3.3.13.6 Summary 


You have learned about abstract methods, abstract classes, and overridden methods in this module. Very 
importantly, you have learned about overriding the toString method. 


3.3.13.7 What’s next? 


You will learn more about indirection, array objects, and casting in the next module. 


3.3.13.8 Online video links 


Select the following links to view online video lectures on the material in this module. 


e ITSE 2321 Lecture 04 155 


Part01 156 
Part02 157 
Part03 158 
Part04 159 


3.3.13.9 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java OOP: Abstract Methods, Abstract Classes, and Overridden Methods 
e File: Java3008.htm 

e Published: 08/02/12 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


155 http://www.youtube.com/playlist? list=PL6C202D624F8C5972 
186http://www-youtube.com/watch?v=wReb-ZdxgwQ 
157http://www-youtube.com/watch?v=AMe_ hVVZ7CA 
158http://www-youtube.com/watch?v=Dvelt VjYqhQ 
159http://www-.youtube.com/watch?v=EPwoHu30 lww 
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3.3.13.10 Complete program listings 


A complete listing of the program discussed in this module is shown in Listing 5 (p. 632) below. 


Listing 5 . Complete program listing. 


/*File Prob04 Copyright 2001, R.G.Baldwin 
Rev 12/16/08 
BOSSA AFICIO I II I IK II I ICI IK 1 4 21K EEE EEE 2k 2k 2k fC 2K 2k a ak ak ak ak EN 
import java.util.*; 


abstract class Prob04{ 
public static void main(String[] args){ 
Random generator = new Random(new Date().getTime()); 
(byte) generator .nextInt(); 


int randomNumber 


Prob04 objRef = new Prob04MyClass (randomNumber) ; 
System. out.println(objRef) ; 
System. out.println(objRef.getData()); 
System. out. println(randomNumber) ; 
}//end main 


//Declare the signature of an abstract class. 
public abstract int getData(); 


}//end class Prob04 


class Prob04MyClass extends Prob04{ 
private int data; 


public Prob04MyClass(int inData){//constructor 
System. out.println("Prob04") ; 
System. out.printin("Dick") ; 
data = inData; 

}//end constructor 


public int getData(){//overridden abstract method 
return data; 
}//end getData() 


public String toString(){//overridden method 
return "Baldwin"; 


}//end overloaded toString () 


}//end class Prob04MyClass 


Table 3.253 


-end- 
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3.3.14 Java3008r Review” 
3.3.14.1 Table of Contents 


Preface (p. 633) 
Questions (p. 633) 


1 (p. 633) , 2 (p. 635) , 3 (p. 635) , 4 (p. 635) , 5 (p. 635) , 6 (p. 635) , 7 (p. 635) , 8 (p. 635) , 
9 (p. 636) , 10 (p. 636) , 11 (p. 636) , 12 (p. 636) 


Images (p. 636) 
Listings (p. 636) 
Answers (p. 638) 
Miscellaneous (p. 639) 


3.3.14.2 Preface 


This module contains review questions and answers keyed to the module titled Java3008: Abstract Methods, 
Abstract Classes, and Overridden Methods 1°! . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.14.3 Questions 


3.3.14.3.1 Question 1 


True or False? The code in Listing 1 (p. 634) produces the output shown in Image 1 (p. 635) where the two 
numeric values shown are random but must always match. 


160This content is available online at <http://cnx.org/content /m45773/1.2/>. 
161http://cnx.org/content /m44205 
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Listing 1 . Source code for Java3008r.java. 


/*File Java3008r Copyright 2013, R.G.Baldwin 

Rev 02/12/13 

FEO EEEE EEEE EEE ICAI AI I I IAI I I A E 1 21 EE 21 21 21 4 4 21 E EE EE 2 2 E / 
import java.util.*; 


abstract class Java3008r{ 
public static void main(String[] args){ 
Random generator = new Random(new Date().getTime()); 
int randomNumber = (byte) generator .nextInt(); 


Java3008r objRef = new Java3008rMyClass (randomNumber) ; 
System. out.println(objRef) ; 
System. out.println(objRef.getData()); 
System. out .println(randomNumber) ; 
}//end main 


//Declare the signature of an abstract class. 
public abstract int getData(); 


}//end class Java3008r 


class Java3008rMyClass extends Java3008r{ 
private int data; 


public Java3008rMyClass(int inData){//constructor 
System. out.println("Java3008r") ; 
System. out.println("Dick") ; 
data = inData; 

}//end constructor 


public int getData(){//overridden abstract method 
return data; 


}//end getData() 


}//end class Java3008rMyClass 


Table 3.254 
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Image 1 . Possible output from the code in Listing 1. 


Java3008r 
Dick 
Baldwin 
-80 
-80 


Table 3.255 


Answer 1 (p. 639) 


3.3.14.3.2 Question 2 


True or False? The purpose of an abstract method declaration is to establish the signature of a method that 
must be overridden in a (non-abstract) subclass of the class in which the abstract method is declared. 
Answer 2 (p. 639) 


3.3.14.3.3 Question 3 
True or False? When an abstract method is executed, it always exhibits default behavior defined in the class 
in which it is declared. 
Answer 3 (p. 638) 
3.3.14.3.4 Question 4 


True or False? An abstract method must be overridden in a subclass in order to be executed. 
Answer 4 (p. 638) 


3.3.14.3.5 Question 5 


True or False? An abstract method can be overridden once and once only and it must be overridden in the 
immediate subclass of the class in which it is declared. 
Answer 5 (p. 638) 


3.3.14.3.6 Question 6 


True or False? The existence of an abstract method in a superclass guarantees that objects instantiated 
from every (non-abstract) subclass of that superclass will have a concrete (executable) version of a 
method having that same signature. 

Answer 6 (p. 638) 


3.3.14.3.7 Question 7 


True or False? Any class can be declared abstract. The consequence of declaring a class abstract is that it 
is not possible to instantiate an object of the class. 

Answer 7 (p. 638) 
3.3.14.3.8 Question 8 


True or False? A class must be declared abstract if it contains two or more abstract method declarations. 
Answer 8 (p. 638) 
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3.3.14.3.9 Question 9 


True or False? If a class inherits an abstract method, either the subclass must be declared abstract, or it 
must provide a concrete overridden version of the inherited abstract method. 
Answer 9 (p. 638) 


3.3.14.3.10 Question 10 


True or False? The primary purpose of a constructor is to assist in the initialization of the state of an object 
, which depends on the values stored in its variables. 
Answer 10 (p. 638) 


3.3.14.3.11 Question 11 


True or False? The default version of the toString method is defined in the class named Class . 
Answer 11 (p. 638) 


3.3.14.3.12 Question 12 


True or False? There is an overloaded version of the printIn method that requires an incoming parameter 
of type Object . When that version of the method is called, it calls the toString method on the 
incoming object reference and displays the string that is returned by the toString method. If the 
toString method belonging to the object has not been overridden, the default version of the toString 
method will be executed and the string that will be displayed is the string returned by that default version. 
The toString method can be overridden to cause the string that is displayed to be more appropriate for 
the object. The toString method can be overridden only once in the class hierarchy. 
Answer 12 (p. 638) 


3.3.14.4 Images 


e Image 1 (p. 635) . Possible output from the code in Listing 1. 
e Image 2 (p. 639) . Output from code in Listing 1. 


3.3.14.5 Listings 


e Listing 1 (p. 634) . Source code for Java3008r.java. 


What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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3.3.14.6 Answers 

3.3.14.6.1 Answer 12 

False. The toString method can be overridden by every class that inherits it. 
Back to Question 12 (p. 636) 

3.3.14.6.2 Answer 11 

False. The default version of the toString method is defined in the class named Object 
Back to Question 11 (p. 636) 

3.3.14.6.3 Answer 10 

True. 
Back to Question 10 (p. 636) 

3.3.14.6.4 Answer 9 

True. 
Back to Question 9 (p. 636) 

3.3.14.6.5 Answer 8 

False. A class must be declared abstract if it contains one or more abstract method declarations. 
Back to Question 8 (p. 635) 

3.3.14.6.6 Answer 7 

True. 
Back to Question 7 (p. 635) 

3.3.14.6.7 Answer 6 

True. 
Back to Question 6 (p. 635) 

3.3.14.6.8 Answer 5 


False. The same abstract method can be overridden in different ways in different subclasses. In other words, 
the behavior of the overridden version can be tailored to (be appropriate for) the class in which it is 
overridden. 

Back to Question 5 (p. 635) 


3.3.14.6.9 Answer 4 
True. 
Back to Question 4 (p. 635) 


3.3.14.6.10 Answer 3 


False. An abstract method has no body. Therefore, it is incomplete, has no behavior, and cannot be 
executed. 
Back to Question 3 (p. 635) 
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3.3.14.6.11 Answer 2 
True. 

Back to Question 2 (p. 635) 
3.3.14.6.12 Answer 1 


False. Listing 1 (p. 634) produces the output shown in Image 2 (p. 639) except that the numeric values may 
vary from one run to the next. Note that the toString method is not overridden in Listing 1 (p. 634) . 


Image 2 . Output from code in Listing 1. 


Java3008r 
Dick 
Java3008rMyClass04f1d0d 
27 
27 


Table 3.256 


Back to Question 1 (p. 633) 


3.3.14.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3008r Review 
e File: Java3008r.htm 

e Published: 02/12/13 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.3.15 Java3008s Slides” 
3.3.15.1 Table of Contents 


e Instructions for viewing slides (p. 640) 
e Miscellaneous (p. 640) 


3.3.15.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3008: Abstract Methods, Abstract Classes, 
and Overridden Methods 163 . 

Click here 164 to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.15.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3008s Slides: Abstract Methods, Abstract Classes, and Overridden Meth- 
ods 

e File: Java3008s.htm 

e Published: 01/06/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


162This content is available online at <http://cnx.org/content /m45624/1.3/>. 
163http://cnx.org/content /m44205 
164http://cnx.org/content /m45624/latest /a0-Index.htm 
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3.3.16 Java3010: Indirection, Array Objects, and Casting” 
3.3.16.1 Table of Contents 


e Preface (p. 641) 


Viewing tip (p. 641) 
x Images (p. 641) 
x Listings (p. 641) 


Preview (p. 641) 


3.3.16.2 Preface 


Discussion and sample code (p. 642) 
Run the program (p. 646) 

Summary (p. 647) 

What’s next? (p. 647) 

Online video links (p. 647) 
Miscellaneous (p. 647) 

Complete program listings (p. 648) 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 


using Java. 


3.3.16.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.3.16.2.1.1 Images 


e Image 1 (p. 642) . Program output on command line screen. 


3.3.16.2.1.2 Listings 


Listing 1 (p. 642 
Listing 2 (p. 644 
Listing 3 (p 


Listing 5 (p 
Listing 6 (p 
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3.3.16.3 Preview 


) 
(p. 644) 
(p. 645) . 
Listing 4 (p. 645) . 
(p. 646) . 
(p. 649) 


. Beginning of the Prob05 class. 
. The class named ProbO05MyClassA. 


The next statement in the main method. 
The class named Prob05MyClassB. 
The end of the main method. 


. Complete program listing. 


The program that I will explain in this module produces no graphics and does not require the use of Ericson’s 


media library. 
OOP concepts 


The program illustrates the following OOP concepts among others: 


e Multiple levels of indirection 
e A one-element array of type Object 


165This content is available online at <http://cnx.org/content /m44206/1.6/>. 
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Storing a reference to an object in an array element as type Object 
An anonymous object 

Passing a reference to a subclass object as type Object 
Downcasting an incoming object reference to access a method 


Program specifications 
Write a program named Prob05 that uses the class definition shown in Listing 1 (p. 642) to produce 
an output similar to that shown in Image 1 (p. 642) on the command-line screen. 


Image 1 . Program output on command line screen. 


Prob05 
Dick 
Baldwin 
-28 
-28 


Table 3.257 


A random value 
Because the program generates and uses a random data value, the actual values displayed will differ from 
one run to the next. However, in all cases, the two values shown in Image 1 (p. 642) must match. 
New classes 
You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named Prob05 which begins in Listing 1 (p. 642) . 


3.3.16.4 Discussion and sample code 


Will explain in fragments 

I will explain this program in fragments. A complete listing is provided in Listing 6 (p. 649) near the 
end of the module. 

I will begin with the driver class named Prob05 , which begins in Listing 1 (p. 642) . 


Listing 1 . Beginning of the Prob05 class. 


import java.util.*; 


class Prob05{ 
public static void main(String[] args){ 


Random generator = new Random(new Date().getTime()); 
int randomNumber = (byte) generator .nextInt(); 


Object[] objRef = {new ProbO5MyClassA(randomNumber) }; 


Table 3.258 
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Everything in Listing 1 (p. 642) should be familiar to you except for the last statement, which I will 
explain shortly. 

Characteristics of arrays in Java 

Before explaining that statement, however, I will discuss some of the important characteristics of array 
objects in Java. A list of such characteristics follows in no particular order: 


e All arrays in Java are one-dimensional arrays. (Multidimensional arrays are created by creating tree 
structures of one-dimensional arrays.) 
Each array in Java is encapsulated in a special type of object that I will refer to as an array object . 
As with all objects, an array object must be accessed using a reference to the array object. 
When the declared type of an array is one of the eight primitive types, the actual values are stored in 
the array elements in the array object. 

e When the declared type of an array is the type of an object (array object or ordinary object), references 
to the objects are stored in the array elements and the objects actually exist elsewhere in memory. 

e As with instance variables, the elements in an array are typically initialized with the standard default 
values for the types involved (zero, false, or null) . That is not the case in this program however. 

e The array that is encapsulated in an array object may have none, one, or more elements. (Yes, it is 
possible for a Java array to have no elements, but that normally occurs only in special circumstances.) 


e The length or size of the array is established when the array object is instantiated and cannot be 
changed thereafter. 

e Every array object contains a special property named length that contains the number of elements 
in an array. It is always possible to determine the number of elements in an array object at runtime 
by accessing the value of the length property for the array object. 


A special instantiation syntax 

There is a special syntax that allows for the instantiation of an array object and the initialization of the 
array elements in a single statement. (I explain this in detail in my online OOP tutorial modules.) The 
last statement in Listing 1 (p. 642) is an example of this syntax. 

Briefly, the syntax consists of a comma separated list of element values (expressions) inside a pair of 
matching curly braces. The length of the array is determined by the number of values in the list. The 
type of the array is determined by the types of the elements in the list. 

This syntax instantiates an array object of the correct length and populates the elements with the 
specified values. 

A reference is returned 

A reference to the array object is returned in much the same way that a constructor for an ordinary 
object returns a reference to the object. 

As is always the case, if the reference is stored in a variable, the type of the reference must be assignment 
compatible with the type of the variable. 

What is assignment compatible? 

I recommend that you go to Google and search for the following keywords to learn more about this topic: 
baldwin java "assignment compatible" 

A one-element array 

The last statement in Listing 1 (p. 642) instantiates an array object containing a one-element array. The 
array element is initialized with a reference to a new object of type Prob05MyClassA_, which exists 
somewhere else in memory. 

The value of a random number that was generated earlier in the main method is passed as a parameter 
to the constructor for the object of type Prob05MyClassA 

Save the reference to the array object 

The reference to the array object is stored in the local reference variable named objRef of type Object 
. We know that the reference is assignment compatible with this reference variable because the Object 
type is completely generic. All non-primitive types are assignment compatible with type Object 
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The class named Prob05MyClassA 
At this point, I am going to put the explanation of the class named Prob05 temporarily on hold and 
explain the class named Prob05MyClassA_, which is shown in its entirety in Listing 2 (p. 644) . 


Listing 2 . The class named Prob05MyClassA. 


class ProbO5MyClassA extends Prob05{ 
private int data; 


public ProbO5MyClassA(int inData) { 
System. out.println("Prob05") ; 
System. out.println("Dick") ; 
data = inData; 

}//end constructor 


public int getData(){ 
return data; 


}//end getData() 


}//end class Prob05MyClassA 


Table 3.259 


Note that the class named Prob05MyClassA extends the class named Prob05_, which is partially 
shown in Listing 1 (p. 642) . 

Familiar code 

All of the code in Listing 2 (p. 644) should be familiar to you because it is very similar to the code in 
the previous module. Therefore, no explanation of Listing 2 (p. 644) is warranted. 

Save the incoming value 

In summary, when the object of type Prob05MyClassA is instantiated, it saves the value of an 
incoming constructor parameter in a private instance variable. 

Return the saved value 

When the method named getData is called on a reference to the object, it returns a copy of that value. 

A review 

To review what I have already said, the array object that was instantiated in Listing 1 (p. 642) contains 
a reference to this object of type Prob05MyClassA_ in the only element of the one-element array. 

The reference to the array object is stored in the reference variable named objRef 

Indirection at work 

At this point, objRef contains a reference to an array object, one element of which contains a reference 
to an ordinary object, which is located somewhere else in memory. This is indirection. 

The next statement in the main method 

Returning now to the main method that began in Listing 1 (p. 642) , Listing 3 (p. 645) shows the 
next statement in the main method following the last statement in Listing 1 (p. 642) . 
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Listing 3 . The next statement in the main method. 


System. out. print1n( 
new ProbO5MyClassB() .getDataFrom0bj (objRef[0])); 


Table 3.260 


What is an anonymous object? 
An anonymous object is an object whose reference is not saved in a named reference variable. 
Instantiate an anonymous object 

Consider the parameter list of the println method shown in Listing 3 (p. 645) . A new object of the 
Prob05MyClassB class is instantiated in the parameter list. However, the reference to that object is not 
saved in a named reference variable. Instead, that reference is used to immediately call the method named 
getDataFromObj that belongs to the anonymous object. 

The parameter that is passed... 

Now consider the parameter that is passed to the method named getDataFromObj . The expression 
inside that parameter list extracts the contents of the zeroth element in the array object that is referred to 
by the contents of the variable named objRef 

And those contents are... 
That element contains a reference to an object of the class Prob05MyClassA (see Listing 1 (p. 642) 


ae 

Therefore, a reference to an object of type Prob05MyClassA_ is passed as a parameter to the method 
named getDataFromObj 

The class named Prob05MyClassB 

It is time to take a look at the class in which the getDataFromObj method is defined. 

The class named Prob05MyClassB is shown in its entirety in Listing 4 (p. 645) . 


Listing 4 . The class named Prob05MyClassB. 


class ProbO5MyClassB{ 


ProbO5MyClassB () { 
System. out.println("Baldwin") ; 
}//end constructor 


public int getDataFrom0bj (Object refTo0bj) { 
return ((Prob05MyClassA)refTo0bj) .getData() ; 
}//end getDataFrom0bj () 


}//end class Prob05MyClassB 


Table 3.261 


Extends the Object class 

Note that this class does not extend the class named ProbO5 . In fact, it doesn’t explicitly extend any 
class. This means that it extends the class named Object by default because every class is a subclass of 
the class named Object 
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The constructor 

The constructor for this class is inconsequential. It simply displays my last name when the object is 

instantiated, producing part of the output text shown in Image 1 (p. 642) . 
The getDataFromObj method 

The interesting part of Listing 4 (p. 645) is the definition of the method named getDataFromObj 

As we saw before, this method receives a reference to an object of type Prob0O5MyClassA (see Listing 
3 (p. 645) ) . However, this reference is not received as the true type of the object. Instead, it is received 
as type Object , which is the ultimate superclass of the class named Prob05MyClassA 

The objective of the method 

The objective is to call the method named getData on the incoming reference. However, the Object 
class doesn’t know anything about a method named getData because the Object class neither defines 
nor inherits a method having that signature. Instead, the getData method is defined in the class named 
Prob05MyClassA_, which is the true type of the object. 

A cast is required 

Therefore, it is necessary to convert the type of the reference back to its true type using a cast operator 
before that reference can be used to call the method named getData . (The cast operator is shown in 
Listing 4 (p. 645) .) 

The returned value 

The getData method returns a copy of the value that was passed as a constructor parameter when the 
object was instantiated. (See Listing 2 (p. 644) .) Recall that the value was the original random value. 
(See Listing 1 (p. 642) .) 

Referring back to Listing 4 (p. 645) , that is the value that is returned from the call to the getDataFro- 
mObj method in Listing 3 (p. 645) , which cause the value to be displayed as the first numeric value in 
Image 1 (p. 642) . 

The end of the main method 

Returning once more to the main method and picking up where we left off in Listing 3 (p. 645) , 

Listing 5 (p. 646) shows the final statement in the main method. 


Listing 5 . The end of the main method. 


System. out .print1n(randomNumber) ; 


}//end main 
}//end class Prob05 


Table 3.262 


This statement simply displays the original random value that was passed to the constructor for the 
Prob05MyClassA_ in Listing 1 (p. 642) . This statement displays the second numeric value shown as the 
last line of text in Image 1 (p. 642) . 

The end of the program 
At this point, the main method terminates causing the program to terminate. 


3.3.16.5 Run the program 


I encourage you to copy the code from Listing 6 (p. 649) , compile it and execute it. Experiment with the 
code, making changes, and observing the results of your changes. Make certain that you can explain why 
your changes behave as they do. 
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3.3.16.6 Summary 
You learned about the following OOP concepts, among others in this module. 


Multiple levels of indirection 

A one-element array of type Object 

Storing a reference to an object in an array element as type Object 
An anonymous object 

Passing a reference to a subclass object as type Object 
Downcasting an incoming object reference to access a method 


3.3.16.7 What’s next? 


You will learn how to use nested loops to process pixels on a row and column basis in the next module. 


3.3.16.8 Online video links 
Select the following links to view online video lectures on the material in this module. 


e ITSE 2321 Lecture 05 166 


Parto1 167 
Part02 168 
Part03 169 


3.3.16.9 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java OOP: Indirection, Array Objects, and Casting 
e File: Java3010.htm 

e Published: 08/02/12 

e Revised:12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


166http://www.youtube.com/playlist?list=PL13622F7BA83F 110C 
167http://www.youtube.com/watch?v=Ow_ XzlSrmsw 
168http://www-youtube.com/watch?v=UiT_ZYtNqWo 
169http://www.youtube.com/watch?v=fCiM M4ps304 
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3.3.16.10 Complete program listings 


A complete listing of the program discussed in this module is shown in Listing 6 (p. 649) below. 
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Listing 6 . Complete program listing. 


/*File Prob05 Copyright 2001, R.G.Baldwin 
Rev 12/16/08 
FOSSA IAI A ICI I I I I I CK IK I IK 12K 1 4 21 2K EEE 2K EEEE fC 2K 2K ak ak af 2k EN 
import java.util.*; 


class Prob05{ 
public static void main(String[] args){ 


Random generator = new Random(new Date().getTime()); 


(byte) generator .nextInt() ; 


int randomNumber 
Object[] objRef = {new ProbO5MyClassA(randomNumber) }; 


System. out. print1n( 
new ProbO5MyClassB() .getDataFrom0bj (objRef[0])); 


System. out .println(randomNumber) ; 


}//end main 
}//end class Prob05 


class ProbO5MyClassA extends Prob05{ 
private int data; 


public ProbO5MyClassA(int inData) { 
System. out.println("Prob05") ; 
System. out.println("Dick") ; 
data = inData; 

3//end constructor 


public int getData(){ 
return data; 


}//end getData() 


}//end class Prob05MyClassA 


class ProbO5MyClassB{ 


ProbO5MyClassB () { 
System. out.println("Baldwin") ; 
}//end constructor 


public int getDataFrom0bj (Object refTo0bj) { 
return ((Prob05MyClassA)refTo0bj) .getData() ; 
}//end getDataFrom0bj () 


}//end class Prob05MyClassB 
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Table 3.263 


-end- 
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3.3.17 Java3010r Review” 
3.3.17.1 Table of Contents 


e Preface (p. 651) 
e Questions (p. 651) 


1 (p. 651) , 2 (p. 653) , 3 (p. 653) , 4 (p. 653) , 5 (p. 653) , 6 (p. 653) , 7 (p. 653) , 8 (p. 654) , 
9 (p. 654) , 10 (p. 654) , 11 (p. 654) , 12 (p. 654) , 13 (p. 654) 


Images (p. 656) 
Listings (p. 656) 
Answers (p. 658) 
Miscellaneous (p. 660) 


3.3.17.2 Preface 


This module contains review questions and answers keyed to the module titled Java3010: Indirection, Array 
Objects, and Casting 1"! . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.17.3 Questions 


3.3.17.3.1 Question 1 


True or False? The code shown in Listing 1 (p. 652) produces the output shown in Image 1 (p. 653) where 
the numeric values are random and vary from one run to the next. 


'70This content is available online at <http://cnx.org/content /m45774/1.2/>. 
'Thttp://cnx.org/content /m44206 
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Listing 1 . Question 1. 


/*File Java3010ra Copyright 2013, R.G.Baldwin 

Rev 02/14/13 

FEA EEEE EEEE EEE IGA AI I ICI I I I A E 21 2k EE 21 21 E EEE E EE EE 2 2 E / 
import java.util.*; 


class Java3010raf{ 
public static void main(String[] args){ 


Random generator = new Random(new Date().getTime()); 


(byte) generator .nextInt() ; 


int randomNumber 
Object[] objRef = [mew Java3010raMyClassA(randomNumber) ]; 


System. out .print1n( 
new Java3010raMyClassB() .getDataFrom0bj (objRef[0])); 


System. out. println(randomNumber) ; 


}//end main 
}//end class Java3010ra 


class Java3010raMyClassA extends Java3010raf 
private int data; 


public Java3010raMyClassA(int inData){ 
System. out. println("Java3010ra") ; 
System. out.println("Dick") ; 
data = inData; 

}//end constructor 


public int getData(){ 
return data; 
}//end getData() 


}//end class Java3010raMyClassA 


class Java3010raMyClassBf{ 


Java3010raMyClassB(){ 
System. out.println("Baldwin") ; 
}//end constructor 


public int getDataFrom0bj (Object refTo0bj) { 
return ((Java3010raMyClassA) refTo0bj).getData() ; 
}//end getDataFrom0bj () 


}//end class Java3010raMyClassB 
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Table 3.264 
Image 1 . Question 1. 
Java3010ra 
Dick 
Baldwin 
-37 
-37 
Table 3.265 


Answer 1 (p. 659) 


3.3.17.3.2 Question 2 

True or False? All array objects in Java contain one-dimensional array structures. 
Answer 2 (p. 659) 

3.3.17.3.3 Question 3 


True or False? Each array in Java is encapsulated in an array object. An array object must be accessed 
using a reference to the array object. 

Answer 3 (p. 659) 
3.3.17.3.4 Question 4 


True or False? When the declared type of an array is one of the eight primitive types, the actual values are 
stored in the array elements in the array object. 

Answer 4 (p. 659) 
3.3.17.3.5 Question 5 


True or False? When the declared type of an array is the type of an object (array object or ordinary object) 
, those objects are stored in the array elements. 

Answer 5 (p. 659) 
3.3.17.3.6 Question 6 


True or False? Unless code is written to do otherwise, the elements in a new array object are initialized with 
the standard default values for the types involved (zero, true, or null) . 
Answer 6 (p. 659) 


3.3.17.3.7 Question 7 


True or False? The array structure that is encapsulated in an array object must have one, or more elements. 
Answer 7 (p. 659) 
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3.3.17.3.8 Question 8 
True or False? The length or size of the array is established when the array object is instantiated and 
cannot be changed thereafter. 
Answer 8 (p. 659) 
3.3.17.3.9 Question 9 


True or False? Every array object contains a special property named size that contains the number of 
elements in an array. It is always possible to determine the number of elements in an array object at runtime 
by accessing the value of the size property for the array object. 

Answer 9 (p. 659) 
3.3.17.3.10 Question 10 


True or False? There is a special syntax that allows for the instantiation of an array object and the 
initialization of the array elements in a single statement. 
Answer 10 (p. 658) 
3.3.17.3.11 Question 11 
True or False? An anonymous class is an object whose reference is not saved in a named reference variable. 
Answer 11 (p. 658) 
3.3.17.3.12 Question 12 


True or False? Every class that doesn’t explicitly extend another class automatically extends the class named 
Class 
Answer 12 (p. 658) 
3.3.17.3.13 Question 13 


True or False? The code shown in Listing 3 (p. 655) produces the output shown in Image 3 (p. 656) where 
the numeric values are random and vary from one run to the next. 
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Listing 3 . Question 13. 


/*File Java3010rb Copyright 2013, R.G.Baldwin 

Rev 02/14/13 

FE A A EEEE EEEE EEE EE EE EEEE KK I A E 21 21 E E 21 21 E EEE E EE EE EE E / 
import java.util.*; 


class Java3010rb{ 
public static void main(String[] args){ 


new Random(new Date() .getTime()); 
(byte) generator .nextInt() ; 


Random generator 
int randomNumber 


Object[] objRef = {new Java3010rbMyClassA(randomNumber) }; 


System. out .print1n( 
new Java3010rbMyClassB() .getDataFrom0bj (objRef[0])); 


System. out. println(randomNumber) ; 


}//end main 
}//end class Java3010rb 


class Java3010rbMyClassA extends Java3010rbf{ 
private int data; 


public Java3010rbMyClassA(int inData){ 
System. out.println("Java3010rb") ; 
System. out.println("Dick") ; 
data = inData; 

}//end constructor 


public int getData(){ 
return data; 
}//end getData() 


}//end class Java3010rbMyClassA 


class Java3010rbMyClassBf{ 


Java3010rbMyClassB(){ 
System. out.println("Baldwin") ; 
}//end constructor 


public int getDataFrom0bj (Object refTo0bj) { 
return refToObj.getData(); 
}//end getDataFrom0bj () 


}//end class Java3010rbMyClassB 
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Table 3.266 

Image 3 . Question 13. 
Java3010rb 
Dick 
Baldwin 
120 
120 
Table 3.267 


Answer 13 (p. 658) 


3.3.17.4 Images 


e Image 1 (p. 653) . Question 1. 
e Image 2 (p. 660) . Answer 1. 
e Image 3 (p. 656) . Question 13. 
e Image 4 (p. 658) . Answer 13. 


3.3.17.5 Listings 


e Listing 1 (p. 652) . Question 1. 
e Listing 2 (p. 658) . Answer 10. 
e Listing 3 (p. 655) . Question 13. 


What is the meaning of the following two images? 


This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 


The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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3.3.17.6 Answers 
3.3.17.6.1 Answer 13 


False: The code shown in Listing 3 (p. 655) produces the compiler error shown in Image 4 (p. 658) . A cast 
is required to fix the problem. 


Image 4 . Answer 13. 


Java3010rb.java:47: error: cannot find symbol 
return (refTo0bj) .getData(); 


symbol: method getData() 
location: variable refTo0bj of type Object 
1 error 


Table 3.268 


Back to Question 13 (p. 654) 


3.3.17.6.2 Answer 12 


False. Every class that doesn’t explicitly extend another class automatically extends the class named Object 


Back to Question 12 (p. 654) 


3.3.17.6.3 Answer 11 


False. An anonymous object is an object whose reference is not saved in a named reference variable. An 
anonymous class is something entirely different. 
Back to Question 11 (p. 654) 


3.3.17.6.4 Answer 10 


True. Listing 2 (p. 658) shows an example of this syntax. (Note the use of the curly brackets in Listing 2 
(p. 658) as opposed to the use of square brackets in Listing 1 (p. 652) .) 


Listing 2 . Answer 10. 


Object[] objRef = {new Java3010raMyClassA(randomNumber) }; 


Table 3.269 


Back to Question 10 (p. 654) 
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3.3.17.6.5 Answer 9 
False. Every array object contains a special property named length that contains the number of elements 
in an array. It is always possible to determine the number of elements in an array object at runtime by 
accessing the value of the length property for the array object. 
Back to Question 9 (p. 654) 
3.3.17.6.6 Answer 8 
True. 
Back to Question 8 (p. 654) 
3.3.17.6.7 Answer 7 
False. The array structure that is encapsulated in an array object may have none, one, or more elements. 
Back to Question 7 (p. 653) 
3.3.17.6.8 Answer 6 


False. Unless code is written to do otherwise, the elements in a new array object are initialized with the 
standard default values for the types involved (zero, false , or null) . 

Back to Question 6 (p. 653) 
3.3.17.6.9 Answer 5 


False. When the declared type of an array is the type of an object (array object or ordinary object), 

references to the objects are stored in the array elements and the objects actually exist elsewhere in memory. 
Back to Question 5 (p. 653) 

3.3.17.6.10 Answer 4 

True. 
Back to Question 4 (p. 653) 

3.3.17.6.11 Answer 3 

True. 
Back to Question 3 (p. 653) 

3.3.17.6.12 Answer 2 

True. Multidimensional arrays are created by creating tree structures of one-dimensional array objects. 
Back to Question 2 (p. 653) 

3.3.17.6.13 Answer 1 


False. The program produces the compiler error shown in Image 2 (p. 660) . 


Image 2 . Answer 1. 


continued on next page 
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Java3010ra.java:12: error: illegal start of expression 
Object[] objRef = [mew Java3010raMyClassA(randomNumber) ] ; 


Java3010ra.java:12: error: °’;’ expected 
Object[] objRef = [mew Java3010raMyClassA(randomNumber) ] ; 


Table 3.270 


Back to Question 1 (p. 651) 


3.3.17.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3010r Review 
e File: Java3010.htm 

e Published: 02/14/13 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.18 Java3010s Slides’” 
3.3.18.1 Table of Contents 


e Instructions for viewing slides (p. 661) 
e Miscellaneous (p. 661) 


'72This content is available online at <http://cnx.org/content /m45625/1.2/>. 
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3.3.18.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3010: Indirection, Array Objects, and 
Casting 17° . 

Click here 174 to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.18.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3010s Slides 
e File: Java3010s.htm 
e Published: 01/06/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.19 Java3012: Using Nested Loops to Process Pixels” 
3.3.19.1 Table of Contents 


e Preface (p. 662) 
Viewing tip (p. 662) 
x Images (p. 662) 
x Listings (p. 662) 


e Preview (p. 662) 
e General background information (p. 671) 


'73http://cnx.org/content /m44206 
'74http://cnx.org/content /m45625 /latest /a0-Index.htm 
175 This content is available online at <http://cnx.org/content /m44207/1.7/>. 
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Discussion and sample code (p. 671) 
Run the program (p. 675) 

Summary (p. 675) 

What’s next? (p. 675) 

Online video links (p. 676) 
Miscellaneous (p. 676) 

Complete program listing (p. 676) 


3.3.19.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 16 . 


3.3.19.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.3.19.2.1.1 Images 


e Image 1 (p. 666) . Raw image. 
e Image 2 (p. 670) . Modified image. 
e Image 3 (p. 670) . Required text output. 


3.3.19.2.1.2 Listings 


e Listing 1 (p. 671) . The driver class named Prob01. 

e Listing 2 (p. 672) . The constructor for the class named Prob01Runner. 
e Listing 3 (p. 672) . Beginning of the method named run. 

e Listing 4 (p. 673) . Beginning of the mirrorUpperQuads method. 

e Listing 5 (p. 673) . Mirror pixel colors around the midpoint. 

e Listing 6 (p. 674) . Remainder of the run method. 

e Listing 7 (p. 675) . The method named mirrorHoriz. 

e Listing 8 (p. 678) . Complete program listing.. 


3.3.19.3 Preview 


In this module, you will learn how to use nested for loops to process pixels on a row and column basis. 
Program specifications 
Write a program named Prob01 that uses the class definition shown in Listing 1 (p. 671) along with 
Ericson’s media library and the image file named Prob01.jpg to produce the graphic output images shown 
in Image 1 (p. 666) and Image 2 (p. 670) . 


'76http://cnx.org/content /m44148/latest / 
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R: 2 G0 B: 1 Color at location: ie 


Table 3.271 
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| EB Probot ipo 
| Zoom 
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Table 3.272 


Define new classes 

You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named ProbO1 given in Listing 1 (p. 671) . 

Required text output 

In addition to the two output images mentioned above, your program must display your name and the 
other line of text shown in Image 3 on the command-line screen. 


Image 3 . Required text output. 


continued on next page 
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Display your name here. 
Picture, filename Prob01.jpg height 240 width 320 


Table 3.273 


3.3.19.3.1 General background information 


This program mirrors an image in such a way that the image in each quadrant is a mirror image of the image 
in the two adjacent quadrants as shown in Image 2 (p. 670) . 

The top left quadrant is mirrored into the top right quadrant, and then the top half is mirrored into the 
bottom half. 

Major evaluation areas 

In order to successfully write this program, the student must be able to: 


e Examine the input and output images and determine how the input image has been modified to produce 
the output image. 
e Manipulate the individual pixels in the image to perform the required modifications. 


3.3.19.4 Discussion and sample code 


Will discuss in fragments 

I will discuss this program in fragments. A complete listing of the program is provided in Listing 8 (p. 
678) near the end of the module. 

The driver class named Prob01 

The driver class containing the main method is shown in Listing 1 (p. 671) . 


Listing 1 . The driver class named Prob01. 


public class Prob01{ 
public static void main(String[] args){ 
Picture pic = new Prob01Runner().run(); 
System. out.println(pic); 
}//end main method 
}//end class Prob01 


Table 3.274 


There is nothing in Listing 1 (p. 671) that I haven’t explained in earlier modules. 

The println statement in Listing 1 (p. 671) causes the second line of text to be displayed in Image 3 
(p. 670) . 

The constructor for the class named Prob01Runner 

The constructor for the class named Prob01Runner is shown in Listing 2 (p. 672) . 
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Listing 2 . The constructor for the class named Prob01Runner . 


class Prob01Runner{ 
public Prob01Runner () { 
System.out.println("Display your name here."); 
}//end constructor 


Table 3.275 


The code in Listing 2 (p. 672) simply causes the first line of text in Image 3 (p. 670) to be displayed on 
the command line screen. 

Beginning of the method named run 

The code in the driver class in Listing 1 (p. 671) instantiates a new object of the Prob01Runner class 
and immediately calls the run method belonging to that object. The run method begins in Listing 3 
(p. 672) . 


Listing 3 . Beginning of the method named run. 


public Picture run(){ 
Picture pix = new Picture("Prob01.jpg") ; 


//Display the input picture. 
pix.explore(); 


//Call the mirrorUpperQuads method to modify the top 
// half of the picture. 
pix = mirrorUpperQuads (pix); 


Table 3.276 


A new Picture object 

Listing 3 (p. 672) instantiates a new Picture object from an image file and saves a reference to that 
object in the local variable named pix . 

Display the Picture object 

Then Listing 3 (p. 672) calls the explore method on the reference producing the output image shown 
in Image 1 (p. 666) . 

Modify top half of the picture 

Finally, Listing 3 (p. 672) calls the method named mirrorUpperQuads to mirror the upper-left 
quadrant of the picture into the upper-right quadrant. A copy of a reference to the picture object is passed 
to the method and the value returned by the method is saved in the variable named pix . ( I will have 
more to say about this later.) 

Put the explanation of the run method on hold 

I will put the explanation of the run method on hold temporarily and explain the method named 
mirrorU pperQuads 

Beginning of the mirrorUpperQuads method 

The beginning of the mirrorUpperQuads method is shown in Listing 4 (p. 673) . 
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Listing 4 . Beginning of the mirrorUpperQuads method. 


private Picture mirrorUpperQuads(Picture pix) f{ 
Pixel leftPixel = null; 
Pixel rightPixel = null; 


int midpoint = pix.getWidth()/2; 
int width = pix.getWidthQ); 


Table 3.277 


Note that the method receives a copy of a reference to the picture. 
Declare working variables 
The code in Listing 4 (p. 673) begins by declaring a pair of local working variables of type Pixel 
These variables will be used to hold information about individual pixels. 
Compute width and midpoint of the image 
Then Listing 4 (p. 673) computes and saves the width and the horizontal midpoint of the image. 
Mirror pixel colors around the midpoint 
Listing 5 (p. 673) uses a pair of nested for loops to copy the pixel colors on the left of the midpoint to 
corresponding mirror-image pixels on the right side of the midpoint. 


Listing 5 . Mirror pixel colors around the midpoint. 


for(int row = O;row < pix.getHeight()/2;rowt+){ 
for(int col = 0;col < midpoint;col++){ 
leftPixel = pix.getPixel(col,row) ; 
rightPixel = pix.getPixel (width-1-col,row) ; 
rightPixel.setColor(leftPixel.getColor()); 
}//end inner loop 
}//end outer loop 


return pix; 
}//end mirrorUpperQuads 


Table 3.278 


Iterate on rows and columns 

The outer loop in Listing 5 (p. 673) iterates down through each of the rows in the top half of the image. 

The inner loop iterates across the left half of each row, copying the color of the pixels from the left half 
to the corresponding mirror-image pixels on the right half. 

Return a reference to the modified object 

Finally, Listing 5 (p. 673) returns a reference to the modified Picture object. The reference is assigned 
to the variable named pix in Listing 3 (p. 672) . 

Superfluous but self-documenting code 

Returning and storing a reference to the modified picture is superfluous and unnecessary. The code in 
Listing 3 (p. 672) already has a reference to the picture and that reference doesn’t change just because the 
object to which it refers is modified. 
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However, I prefer this programming style because I consider it to be more self-documenting. 

Remainder of the run method 

Returning now to the run method, Listing 6 (p. 674) calls the method named mirrorHoriz to mirror 
the top half of the image into the bottom half. (I will explain the mirrorHoriz method shortly.) 


Listing 6 . Remainder of the run method. 


//Mirror the top half into the bottom half. 
pix = mirrorHoriz (pix); 


//Add your name and display the output picture. 
pix.addMessage("Display your name here.",10,20); 


pix.explore(); 
return pix; 


3//end run 


Table 3.279 


Display text on the image 

Then Listing 6 (p. 674) calls the addMessage method on the reference to the picture to place the text 
near the upper-left corner as shown in Image 2 (p. 670) . 

Display the modified image 

After that, Listing 6 (p. 674) calls the explore method to display the modified image as shown in 
Image 2 (p. 670) . 

Return a reference to the modified picture 

Finally, Listing 6 (p. 674) returns the reference to the modified picture, which is saved in the variable 
named pic in Listing 1 (p. 671) . 

As mentioned earlier, the variable named pic is passed to the println method in Listing 1 (p. 671) , 
causing the second line of text shown in Image 3 (p. 670) to be displayed on the command line screen. 

The method named mirrorHoriz 

Listing 7 (p. 675) shows the method named mirrorHoriz in its entirety. This method mirrors the top 
half of the picture into the bottom half. 
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Listing 7 . The method named mirrorHoriz. 


private Picture mirrorHoriz(Picture pix){ 
Pixel topPixel = null; 
Pixel bottomPixel = null; 


int midpoint = pix.getHeight()/2; 
int height = pix.getHeight(); 


for(int col = 0;col < pix.getWidth() ;col++){ 
for(int row = O;row < midpoint;rowt+){ 
topPixel = pix.getPixel(col,row) ; 
bottomPixel = 
pix.getPixel (col,height-1-row) ; 
bottomPixel .setColor (topPixel.getColor()); 
}//end inner loop 
}//end outer loop 


return pix; 
}//end mirrorHoriz 


}//end class Prob01Runner 


Table 3.280 


Very similar to an earlier method 

This method is very similar to the method named mirrorUpperQuads that I explained in Listing 
4 (p. 673) and Listing 5 (p. 673) . If you understood that explanation, you should have no difficulty 
understanding the code in Listing 7 (p. 675) without further explanation. 

End of Prob01Runner class 

Listing 7 (p. 675) also signals the end of the class named Prob01Runner 


3.3.19.4.1 Run the program 


I encourage you to copy the code from Listing 8 (p. 678) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 

Click here 177 to download the required input image file. 


3.3.19.5 Summary 


In this module, you learned how to use nested for loops to process pixels on a row and column basis. 


3.3.19.6 What’s next? 


You will learn to crop, flip, and combine pictures in the next module. 


'Thttp://cnx.org/content /m44207 /latest /Prob01.jpg 
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3.3.19.7 Online video links 


Select the following links to view online video lectures on the material in this module. 


e ITSE 2321 Lecture 06 178 


Part01 179 
Part02 18° 


3.3.19.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Using Nested Loops to Process Pixels 
e File: Java3012.htm 

e Published: 07/31/12 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.3.19.9 Complete program listing 


A complete listing of the program discussed in this module is shown in Listing 8 (p. 678) below. 


'8http://www-youtube.com/playlist?list=PLB8C60363CB918BAA 
'79http://www-youtube.com/watch?v—JOhc5031Pj8 
180http://www.youtube.com/watch?v=vQBd VdqAxq4 
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Listing 8 . Complete program listing. 


/*File Prob01 Copyright 2008 R.G.Baldwin 
Revised 12/16/08 
FOS OSG IOS GOI GRC II ASI OI ICI I I I I I I IS A a Kk ak ak ak ka 4 / 


public class Prob01{ 
public static void main(String[] args){ 
Picture pic = new Prob01Runner().run(); 
System. out.println(pic); 
3//end main method 
}//end class Prob01 


class Prob01Runner{ 
public Prob01Runner(){ 
System.out.println("Display your name here."); 
}//end constructor 


public Picture run(){ 
Picture pix = new Picture("Prob01.jpg") ; 
//Display the input picture. 
pix.explore(); 


//Call the mirrorUpperQuads method to modify the top 
// half of the picture. 

pix = mirrorUpperQuads (pix); 

//Mirror the top half into the bottom half. 

pix = mirrorHoriz (pix); 

//Add your name and display the output picture. 
pix.addMessage("Display your name here.",10,20); 
pix.explore(); 

return pix; 


3//end run 


//This method mirrors the upper-left quadrant of a 
// picture into the upper-right quadrant. 
private Picture mirrorUpperQuads(Picture pix) { 
Pixel leftPixel = null; 
Pixel rightPixel = null; 
int midpoint = pix.getWidth()/2; 
int width = pix.getWidth(); 
for(int row = O;row < pix.getHeight()/2;rowt+){ 
for(int col = 0;col < midpoint;col++){ 
leftPixel = pix.getPixel(col,row); 
rightPixel = 
pix.getPixel (width-1-col,row) ; 
rightPixel.setColor(leftPixel.getColor()); 
}//end inner loop 
}//end outer joop ; 
vailable for free at Connexions <http://cnx.org/content/col11441/1.181> 
return pix; 
}//end mirrorUpperQuads 


675 


Table 3.281 


-end- 
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3.3.20 Java3012r Review” 
3.3.20.1 Table of Contents 
e Preface (p. 680) 
e Questions (p. 680) 
1 (p. 680) , 2 (p. 687) , 3 (p. 688) , 4 (p. 688) 


Images (p. 688) 
Listings (p. 688) 
Answers (p. 690) 
Miscellaneous (p. 690) 


3.3.20.2 Preface 


This module contains review questions and answers keyed to the module titled Java3012: Using Nested 
Loops to Process Pixels !8? . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.20.3 Questions 


3.3.20.3.1 Question 1 


True or False? The code shown in Listing 1 (p. 681) will transform the image shown in Image 1 (p. 683) 
into the image shown in Image 2 (p. 687) . 


181 This content is available online at <http://cnx.org/content/m45775/1.2/>. 
182http://cnx.org/content /m44207 
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Listing 1 . Question 1. 


/*File Java3012ra Copyright 2008 R.G.Baldwin 
Revised 02/14/13 
FE GI AG I IAA ICAI AI I ICICI GI I A E 21 1 EE 21 21 24 4 4 24 E EE EE 2 2 E / 


public class Java3012raf{ 
public static void main(String[] args){ 
new Java3012raRunner().run(); 
}//end main method 
}//end class Java3012ra 


class Java3012raRunner{ 
public Java3012raRunner (){ 
System.out.println("Display your name here."); 
}//end constructor 


public void run(){ 
Picture pix = new Picture("Java3012ra. jpg"); 


//Call the mirrorUpperQuads method to modify the top 
// half of the picture. 

pix = mirrorUpperQuads (pix) ; 

//Mirror the top half into the bottom half. 

pix = mirrorHoriz (pix); 

//Add your name and display the output picture. 
pix.addMessage("Display your name here.",10,20); 
pix.explore(); 


3//end run 


//This method mirrors the upper-left quadrant of a 
// picture into the upper-right quadrant. 
private Picture mirrorUpperQuads(Picture pix) { 
Pixel leftPixel = null; 
Pixel rightPixel = null; 
int midpoint = pix.getWidth()/2; 
int width = pix.getWidth(); 
for(int row = O;row < pix.getHeight()/2;rowt+){ 
for(int col = 0;col < midpoint;col++){ 
leftPixel = pix.getPixel(col,row) ; 
rightPixel = 
pix.getPixel (width-1-col, row) ; 
rightPixel.setColor(leftPixel.getColor()); 
}//end inner loop 
}//end outer loop 


return pix; 
}//end mirrorUpperQuads 
ea ce Availabte-for free at Connexions <http://enx.org/conteAt/col11441/1.181> 


//This method mirrors the top half of a picture into 
// the bottom half. 
private Picture mirrorHoriz(Picture pix){ 
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Table 3.283 
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| Image 2 . Possible output produced by the program in Listing 1. | 
=| Java3012ra.jpg 
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Table 3.284 


Answer 1 (p. 690) 


3.3.20.3.2 Question 2 


True or False? The code in Listing 2 (p. 688) instantiates an object of an anonymous class. 
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Listing 2 . Question 2. 


new Java3012raRunner().run(); 


Table 3.285 


Answer 2 (p. 690) 


3.3.20.3.3 Question 3 

True or False? The code in Listing 2 (p. 688) instantiates an anonymous object.. 
Answer 3 (p. 690) 

3.3.20.3.4 Question 4 


True or False? The statement shown in Listing 3 (p. 688) will return a reference to a Pixel object that 
represents a physical pixel located at a horizontal coordinate of col and a vertical coordinate of row . 


Listing 3 . Question 4. 


leftPixel = pix.getPixels(col,row) ; 


Table 3.286 


Answer 4 (p. 690) 


3.3.20.4 Images 


e Image 1 (p. 683) . Image from the file named Java3012ra.jpg. 
e Image 2 (p. 687) . Possible output produced by the program in Listing 1. 


3.3.20.5 Listings 


e Listing 1 (p. 681) . Question 1. 
e Listing 2 (p. 688) . Question 2. 
e Listing 3 (p. 688) . Question 4. 
e Listing 4 (p. 690) . Answer 4. 


What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


685 


None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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3.3.20.6 Answers 
3.3.20.6.1 Answer 4 


False. The code in Listing 3 (p. 688) has the wrong spelling for the method that returns the Pixel object. 
The correct spelling is shown in Listing 4 (p. 690) . You learned about the spelling (with no parameters) 
shown in Listing 3 (p. 688) in an earlier module. 


Listing 4 . Answer 4. 


leftPixel = pix.getPixel(col,row) ; 


Table 3.287 


Back to Question 4 (p. 688) 


3.3.20.6.2 Answer 3 


True. The object instantiated from the class named Java3012raRunner is an anonymous object because 
its reference is not saved in a named reference variable in the current scope. Anonymous classes and 
anonymous objects are entirely different topics. 

Back to Question 3 (p. 688) 


3.3.20.6.3 Answer 2 


False. A discussion of anonymous classes would be a somewhat advanced topic. That topic is not explained 
in the module named Java3012: Using Nested Loops to Process Pixels 183 . 
Back to Question 2 (p. 687) 


3.3.20.6.4 Answer 1 
True. 
Back to Question 1 (p. 680) 


3.3.20.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3012r Review 
e File: Java3012r.htm 

e Published: 02/14/13 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


183http://cnx.org/content /m44207 
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I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.21 Java3012s Slides’ 
3.3.21.1 Table of Contents 


e Instructions for viewing slides (p. 691) 
e Miscellaneous (p. 691) 


3.3.21.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3012: Using Nested Loops to Process 
Pixels 185 . 

Click here 186 to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.21.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3012s Slides 
e File: Java3012s.htm 
e Published: 01/06/02 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


184This content is available online at <http://cnx.org/content /m45626/1.2/>. 
185http://cnx.org/content /m44207 
186http://cnx.org/content /m45626 /latest /a0-Index.htm 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.22 Java3014: Cropping, Flipping, and Combining Pictures'”’ 
3.3.22.1 Table of Contents 


e Preface (p. 692) 
Viewing tip (p. 692) 

x Images (p. 692) 

x Listings (p. 693) 
Preview (p. 693) 
General background information (p. 704) 
Discussion and sample code (p. 704) 
Run the program (p. 716) 
Summary (p. 717) 
What’s next? (p. 717) 
Online video links (p. 717) 
Miscellaneous (p. 717) 
Complete program listing (p. 718) 


3.3.22.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 188 . 


3.3.22.2.1 Viewing tip 
I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.3.22.2.1.1 Images 


Image 1 (p. 695 
Image 2 (p. 699 
Image 3 (p. 70 
Image 4 (p. 70 
( 
( 


) . Raw butterfly image. 

) . Beach scene with student’s name added. 

) . Composite image. 

) . Required text output. 

) . Cropped and flipped version of the butterfly image. 
) . Partially complete version of the output picture. 


Image 5 (p. 709 
Image 6 (p. 715 


187This content is available online at <http://cnx.org/content /m44238/1.8/>. 
188http://cnx.org/content /m44148/latest / 
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3.3.22.2.1.2 Listings 


Listing 1 (p. 
Listing 2 (p. 
Listing 3 (p. 
Listing 4 (p. 
Listing 5 (p. 

( 

( 

( 

( 


Listing 6 
Listing 7 
Listing 8 
Listing 9 


p 
P 


Pp- 


704) . 
705) . 
705) . 
706) . 
). 
709) . 
< 710) . 
. 711). 

p. 715). 
Listing 10 (p 
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The driver class named Prob02. 

Beginning of the Prob02Runner class. 

Beginning of the run method. 

Beginning of the cropAndFlip method. 

Process using nested loops. 

Call the copyPictureWithCrop method from the run method.. 
Beginning of the method named copyPictureWithCrop. 
Process using nested loops. 

The remainder of the run method. 


719) . Complete program listing. 


3.3.22.3 Preview 


In this module, you will learn how to: 


e Work directly with individual pixels and keep track of coordinate values. 
e Copy a portion of one picture into a specific location in another picture. 
e Crop and flip a picture. 


Program specifications 

Write a program named Prob02 that uses the class definition shown in Listing 1 (p. 704) and Ericson’s 
media library along with the image files named Prob02a.jpg and Prob02b.jpg_ to produce the three 
graphic output images shown in Image 1 (p. 695) , Image 2 (p. 699) , and Image 3 (p. 703) . 
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Table 3.288 
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Image 3 . Composite image. 
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Table 3.290 


May define new classes 

You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named Prob02 given in Listing 1 (p. 704) . 

The facing butterfly images 

The two facing images of the butterflies in the final output picture are separated by two pixels and those 
two images as a pair are centered in the picture of the beach. 

Required text output 

In addition to the three output images mentioned above, your program must display your name and the 
other three lines of text shown in Image 4 (p. 704) on the command-line screen: 
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Image 4 . Required text output. 


Display your name here. 
Picture, filename Prob02a.jpg height 118 width 100 
Picture, filename Prob02b.jpg height 240 width 320 
Picture, filename None height 101 width 77 


Table 3.291 


3.3.22.4 General background information 


This program copies a rectangular portion of a picture of a butterfly into a specific location in a picture of 
a beach. 

The program also crops the butterfly picture to the same size as the portion that was copied into the 
beach picture and flips the cropped version to cause the butterfly to face left instead of facing right. 

Then it copies the cropped and flipped image to a location two pixels to the right of the original copy of 
the butterfly in the beach image. 

The two resulting images of the butterfly within the beach image are separated by two pixels, face one 
another, and are centered in the picture of the beach as shown in Image 3 (p. 703) . 

Major evaluation areas 

In order to successfully write this program, the student must, as a minimum be able to: 


e Work directly with individual pixels and keep track of coordinate values. 
e Copy a portion of one picture into a specific location in another picture. 
e Crop and flip a picture. 


3.3.22.5 Discussion and sample code 


Will discuss in fragments 

I will discuss this program in fragments. A complete listing of the program is provided in Listing 10 (p. 
719) near the end of the module. 

The driver class named Prob02 

The driver class containing the main method is shown in Listing 1 (p. 704) . 


Listing 1 . The driver class named Prob02. 


import java.awt.Color; 


public class Prob02{ 
public static void main(String[] args){ 
Picture[] pictures = new ProbO2Runner() .run(); 


System. out.println(pictures[0]); 
System. out.println(pictures[1]) ; 
System. out.println(pictures[2]) ; 
}//end main method 
}//end class Prob02 
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Table 3.292 


A reference to an array object 

The call to the run method in Listing 1 (p. 704) may be new to you. This call expects to receive a 
reference to an array object of type Picture[] as a return value. 

Save return value in variable named pictures 

The return value from the run method is stored in the local reference variable named pictures 

Extract and print references to Picture objects 

Then the reference variable is used to extract references to the individual Picture objects encapsulated 
in the array. Those references are passed to the println method causing the last three lines of text shown 
in Image 4 (p. 704) to be displayed on the command line screen. 

Beginning of the Prob02Runner class 

The class named Prob02Runner begins in Listing 2 (p. 705) , which shows the constructor for the 
class. 


Listing 2 . Beginning of the Prob02Runner class. 


class ProbO2Runner{ 


public Prob02Runner () {//constructor 
System.out.println("Display your name here."); 
}//end constructor 


Table 3.293 


The constructor simply causes the student’s name to be displayed on the command line screen, producing 
the first line of output text shown in Image 4 (p. 704) . 

Beginning of the run method 

The run method, that was called in Listing 1 (p. 704) begins in Listing 3 (p. 705) . 


Listing 3 . Beginning of the run method. 


public Picture[] run(){ 
Picture picA = new Picture("Prob02a. jpg"); 
picA.explore(); 


Picture picB = new Picture("Prob02b. jpg"); 
picB.addMessage("Display your name here.",10,20); 
picB.explore(); 


Picture picC = cropAndFlip(picA,4,5,80,105); 


Table 3.294 


Listing 3 (p. 705) instantiates two Picture objects from image files and displays them by calling the 
explore method on each Picture object. In addition, the student’s name is added near the upper-left 
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corner of the beach image. This code results in the images shown in Image 1 (p. 695) and Image 2 (p. 699) 


Call the cropAndFlip method 

Then Listing 3 (p. 705) calls the cropAndFlip method passing the reference to the butterfly image 
of Image 1, along with some other information as parameters. The return value is stored in a new local 
reference variable of type Picture named picC 

Put discussion of the run method on hold 

I will put the discussion of the run method on temporary hold at this point and explain the method 
named cropAndFlip , which begins in Listing 4 (p. 706) . 

Beginning of the cropAndFlip method 

The cropAndFlip method crops a picture to the specified coordinate values and flips it around a 
vertical line at its center. 


Listing 4 . Beginning of the cropAndFlip method. 


private Picture cropAndFlip(Picture pic, 
int xl,int yl, 
int x2,int y2){ 
Picture output = new Picture(x2-x1+1,y2-y1+1); 


int width = output.getWidth() ; 


Pixel pixel = null; 
Color color null; 


Table 3.295 


Incoming parameters 

In addition to a reference to the picture to be processed, the method receives four incoming integer values 
as parameters. The parameters named x1 and yl specify the coordinates of the upper-left corner of a 
rectangular area of the picture that is to be retained in the output. 

The parameters named x2 and y2 specify the coordinates of the lower-right corner of the rectangular 
area of the picture that is to be retained in the output. 

An empty Picture object 

Listing 4 (p. 706) begins by creating an empty Picture object of the correct size to hold the cropped 
image. A reference to the empty picture is saved in the local reference variable named output 

Then Listing 4 (p. 706) gets and saves the width of the output picture. 

Following this, Listing 4 (p. 706) declares two local working variables named pixel (of type Pixel ) 
and color (of type Color ) . 

Process using nested loops 

Listing 5 (p. 707) uses a pair of nested for loops to cause the output picture to be a cropped version 
of the picture received as an incoming parameter. The cropped image is flipped around its center. 
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Listing 5 . Process using nested loops. 


for(int col = x1;col < (x2+1);col++){ 
for(int row = yl;row < (y2+1);rowt+){ 
color = pic.getPixel(col,row) .getColor() ; 
pixel = output.getPixel (width-col+x1-1,row-y1); 
pixel.setColor(color) ; 
}//end inner loop 
}//end outer loop 


return output; 
}//end cropAndFlip method 


Table 3.296 


The code in Listing 5 (p. 707) copies the pixel colors of the selected pixels of the incoming image to the 
pixels of the output image, flipping the image around its center line in the process. 

Cropped and flipped version of the butterfly image 

If you display the picture referred to by output in Listing 5 (p. 707) , you will get the image shown 


in Image 5 (p. 709) . 
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| Image 5 . Cropped and flipped version of the butterfly image. 
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Table 3.297 


Compare with the original butterfly picture 

If you compare Image 5 (p. 709) with Image 1 (p. 695) , you will see that pixels on the outer edges of 
Image 1 (p. 695) have been discarded and the resulting image has been flipped around its centerline. 

End of the cropAndFlip method 

Image 5 (p. 709) returns a reference to the new image and ends the method named cropAndFlip 
The returned value is stored in the variable named picC in Listing 3 (p. 705) . 

Original image not modified 

Note that the code in the cropAndFlip method does not modify the original image of the butterfly. 
Instead, it extracts pixel data from the original image to produce a new image. When control returns to the 
run method in Listing 3 (p. 705) , a reference to the new image is stored in the variable named picC 

Call the copyPictureWithCrop method from the run method 

Control has now returned to the run method, picking up where Listing 3 (p. 705) left off. The next 
statement in the run method is shown in Listing 6 (p. 709) . 


Listing 6 . Call the copyPictureWithCrop method from the run method. 


copyPictureWithCrop(picA, picB,82,70,4,5,77,101); 


Table 3.298 


Put the run method on hold again 

Once again, I will put the run method on hold while I explain the method named copyPictureWith- 
Crop , which begins in Listing 7 (p. 710) . 

Beginning of the method named copyPictureWithCrop 
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The first two incoming parameters named source and dest are references to a source picture and a 
destination picture. 

When the method is called in Listing 6 (p. 709) , the source picture is the original butterfly picture 
shown in Image 1 (p. 695) and the destination picture is the beach picture shown in Image 2 (p. 699) . 


Listing 7 . Beginning of the method named copyPictureWithCrop. 


private void copyPictureWithCrop( 

Picture source, 

Picture dest, 

int x0ff, 

int yOff, 

int xCoor, 

int yCoor, 

int width, 

int height) { 


//Confirm that source will fit in destination 
if(((widtht+x0ff) <= dest.getWidth()) && 
(Cheightt+y0ff) <= dest.getHeight())){ 


Pixel pixel 
Color color 


null; 
null; 


Table 3.299 


Copy source to destination 

The method named copyPictureWithCrop copies part of the source picture into the destination 
picture with an offset on both axes after first confirming that the part will fit. The method does nothing if 
the part won’t fit. 

The copy process causes selected pixel colors in the destination picture to be replaced by pixel colors 
from the source picture. 

The offset values 

The next two parameters named xOff and yOff in Listing 7 (p. 710) specify the location in the 
destination picture where the upper-left corner of the cropped source picture is to be located. 

The statement in Listing 6 (p. 709) passes the values (82,70) for these two values. This is the location 
of the upper left corner of the left-most butterfly image in Image 3 (p. 703) . 


Not really cropped For clarity, I will refer to this as a cropped source picture even though 
the program doesn’t actually save a cropped version of the picture as was the case with the 
cropAndFlip method. 


The program simply copies a rectangular portion of the source picture into the destination picture. 


Upper-left cropping corner 

The parameters named xCoor and yCoor in Listing 7 (p. 710) specify the upper-left corner of the 
rectangular area of pixels that is to be preserved when the source image is cropped. 

Coordinate values of (4,5) are passed for these two values when the method is called in Listing 6 (p. 709) 


Same values as Listing 3 
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Note that these are the same two values that were passed for this purpose when the cropAndFlip 

method was called in Listing 3 (p. 705) . 
Two ways to specify a rectangle 

There are two commonly used ways to specify a rectangular area in programming. One way is to specify 
the coordinates of the upper-left and bottom right corners. This is the approach used in the cropAndFlip 
method in Listing 4 (p. 706) . 

The other way is to specify the coordinates of the upper-left. corner and then to specify the width and 
the height. This is the approach used in the copyPictureWithCrop method in Listing 7 (p. 710) . 

The width and height parameters 

The parameters named width and height in Listing 7 (p. 710) specify the width and height of the 
rectangular area of pixels that is to be preserved when the source picture is cropped. 

If you compare the width and height parameter values passed in Listing 6 (p. 709) with the coordinate 
values passed in Listing 3 (p. 705) , you will see that the same rectangular area of the butterfly image is 
being preserved after cropping in both cases. 

Confirm that the cropped image will fit 

Listing 7 (p. 710) begins by confirming that the cropped rectangular area of the source picture will fit 
within the destination picture when placed at the specified location. If the conditional clause of the if 
statement returns true, then the code in the body of the statement will be executed. If not, control bypasses 
the body of the if statement and the source picture will not be copied into the destination picture. 

Process using nested for loops 

As was the case in Listing 4 (p. 706) , Listing 7 (p. 710) declares two working variables named pixel 
and color 

The variables named pixel and color are used along with various parameter values in the pair of 
nested for loops shown in Listing 8 (p. 711) to crop the source picture and to copy the cropped source 
picture into the destination picture at the specified location. 


Listing 8 . Process using nested loops. 


for(int col = 0;col < width;col++){ 

for(int row = O;row < height;row++){ 
color = source.getPixel ( 

col + xCoor,row + yCoor).getColor(); 

pixel = dest.getPixel(col+xO0ff,row+yOff); 
pixel.setColor (color); 

}//end inner loop 

}//end outer loop 


}//end if 
}//end copyPictureWithCrop method 


}//end class Prob02Runner 


Table 3.300 


Not as complicated as it looks 

Although the arithmetic operations involved in Listing 8 (p. 711) can be daunting, the code in Listing 8 
(p. 711) is doing nothing more than replacing selected pixel colors in the destination picture with selected 
pixel colors from the source picture. 
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Partially complete version of the output picture. 
If you were to display the destination picture before returning control back to the run method in Listing 
8 (p. 711) , you would see the image shown in Image 6 (p. 715) . 


ProbO02b.jpa 


R: 2 G: 0 B: 1 Color at location: 


Display your name here, T 
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| ProbO02b.jpa 


R: 2 G: 0 B: 1 Color at location: 


Í Display your name here,” ee 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


710 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


| ProbO02b.jpa 


R: 2 G: 0 B: 1 Color at location: 


j Display your name here: ) | | 
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Image 6 . Partially complete version of the output picture. 


Prob02b.jpag 


R: ? G 0B: 1 Color at location: 


Í Display your name here. . 


Table 3.301 


At this point, only one cropped version of the butterfly image has been copied into the beach image. 

Return control to the run method 

The copyPictureWithCrop method terminates in Listing 8 (p. 711) and returns control to the run 
method, picking up where Listing 6 (p. 709) left off. 

The remainder of the run method 

The remainder of the run method is shown in Listing 9 (p. 715) . 


Listing 9 . The remainder of the run method. 


continued on next page 
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copyPictureWithCrop(picC, picB,161,70,0,0,77,101); 
picB.explore() ; 
Picture[] output = {picA,picB, picC}; 


return output; 
}//end run 


Table 3.302 


Call the copyPictureWithCrop method again 

Listing 9 (p. 715) begins by calling the copyPictureWithCrop method again. This time, however, 
the picture shown in Image 5 (p. 709) is passed as the source image with the same picture as before being 
passed as the destination image. 

The offset coordinates 

In this case, the offset coordinate values specify the upper-left corner of the right-most butterfly image 
in Image 3 (p. 703) . 

The cropping parameters 

The final four parameters that are passed in Listing 9 (p. 715) specify that the entire source picture is 
to be copied into the destination picture. 

Display the destination picture 

When the copyPictureWithCrop method returns, Listing 9 (p. 715) calls the explore method to 
display the current state of the destination picture. The result is shown in Image 3 (p. 703) . 

A new array object 

Finally, Listing 9 (p. 715) instantiates a new array object, populates it with references to three Picture 
objects, and returns control to the main method code in Listing 1 (p. 704) returning a reference to the 
array object in the process. 

The code in Listing 1 (p. 704) saves the reference to the array object in the variable named pictures . 

Pass Picture object references to printIn method 

Then Listing 1 (p. 704) extracts and passes each of the three Picture object references to the printIn 
method causing the last three lines of text shown in Image 4 (p. 704) to be displayed on the command-line 
screen. 

The second line of output text ( picA ) describes the raw butterfly image shown in Image 1 (p. 695) . 

The third line of output text for ( picB ) describes the beach scene shown in Image 2 (p. 699) and 
Image 3 (p. 703) . 

The last line of output text ( picC ) describes the cropped and flipped version of the butterfly image 
shown in Image 5 (p. 709) . 


3.3.22.6 Run the program 


I encourage you to copy the code from Listing 10 (p. 719) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 

Click here 18° and here !9° to download the two required input image files. 


189http://cnx.org/content /m44238 /latest /Prob02a.jpg 
10http://cnx.org/content /m44238 /latest /Prob02b.jpg 
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3.3.22.7 Summary 


In this module, you learned how to: 


e Work directly with individual pixels and keep track of coordinate values. 
e Copy a portion of one picture into a specific location in another picture. 
e Crop and flip a picture. 


3.3.22.8 What’s next? 


You will l earn to write a program to do green-screen processing in the next module. 


3.3.22.9 Online video links 


Select the following links to view online video lectures on the material in this module. 


e ITSE 2321 Lecture 07 19! 


Part01 19? 
Parto2 198 
Part03 194 


3.3.22.10 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Cropping, Flipping, and Combining Pictures 
e File: Java3014.htm 

e Published: 08/01/12 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


191http://www.youtube.com/playlist?list=PL3D7CCCOD884E2EF4 
192http://www-youtube.com/watch?v=AY1loMeuF WwY 
193http://www.youtube.com/watch?v=IWNm1xWA7wQ 
194http://www-youtube.com/watch?v=P0thqN0Fofs 
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3.3.22.11 Complete program listing 


A complete listing of the program discussed in this module is shown in Listing 10 (p. 719) below. 
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Listing 10 . Complete program listing. 


/*File Prob02 Copyright 2008 R.G.Baldwin 
Revised 12/16/08 
FOSSA I II ICI ICI I I I I KK IK 2 A 2K 12K 2K 2A 2K EE EEEE 2K 2k fk fC 2K 2K Cok ak af ak EN 
import java.awt.Color; 


public class Prob02{ 
public static void main(String[] args){ 
Picture[] pictures = new Prob02Runner() .run(); 


System. out.println(pictures[0]); 
System. out.println(pictures[1]) ; 
System. out.println(pictures[2]) ; 
}//end main method 
}//end class Prob02 


class ProbO2Runner{ 


public Prob02Runner () {//constructor 
System.out.println("Display your name here."); 
}//end constructor 


public Picture[] run(){ 
Picture picA = new Picture("Prob02a. jpg"); 
picA.explore() ; 
Picture picB = new Picture("Prob02b. jpg"); 
picB.addMessage("Display your name here.",10,20); 
picB.explore() ; 


Picture picC = cropAndFlip(picA,4,5,80,105); 


copyPictureWithCrop(picA, picB,82,70,4,5,77,101); 
copyPictureWithCrop(picC, picB,161,70,0,0,77,101); 


picB.explore(); 


Picture[] output = {picA,picB, picC}; 
return output; 
3//end run 


//Crops a picture to the specified coordinate values and 
// flips it around a vertical line at its center. 
private Picture cropAndFlip(Picture pic,int x1,int y1, 
int x2,int y2){ 
Picture output = new Picture(x2-x1+1,y2-y1+1); 


gee wate outpnt pecuidth Qs i http: tent /col11441/1.181 
Pixel pixel = vate or free at Connexions <http://cnx.org/content/co /1.181> 
Color color null; 
for(int col = x1;col < (x2+1);col++){ 

for(int row = yl;row < (y2+1);rowt+){ 
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Table 3.303 


-end- 
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3.3.23 Java3014r Review” 
3.3.23.1 Table of Contents 
Preface (p. 721) 
Questions (p. 721) 

1 (p. 721) , 2 (p. 729) 


Images (p. 730) 
Listings (p. 730) 
Answers (p. 731) 
Miscellaneous (p. 735) 


3.3.23.2 Preface 


This module contains review questions and answers keyed to the module titled Java3014: Cropping, Flipping, 
and Combining Pictures 1% . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.23.3 Questions 


3.3.23.3.1 Question 1 


True or False? The code in Listing 1 (p. 722) combined with the images in Image 1 (p. 723) and Image 2 
(p. 725) produces the output shown in Image 3 (p. 729) . 


195 This content is available online at <http://cnx.org/content/m45778/1.2/>. 
196 http://cnx.org/content /m44238 
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Listing 1 . Question 1. 


/*File Java3014ra Copyright 2013 R.G.Baldwin 

Revised 02/15/13 

FAG EEEE EEEE EEE EE EEEE EEE GI I A E 1 2k EE 21 21 E 4 4 24 E EE EE EE E / 
import java.awt.Color; 


public class Java3014ra{ 
public static void main(String[] args){ 
Picture[] pictures = new Java3014raRunner() .run(); 
}//end main method 
}//end class Java3014ra 


class Java3014raRunner{ 


public Picture[] run(){ 
Picture picA = new Picture("Prob02a. jpg"); 
Picture picB = new Picture("Prob02b. jpg"); 
Picture picC = cropAndFlip(picA,4,5,80,105); 
copyPictureWithCrop(picA, picB,130,10,4,5,77,101); 
copyPictureWithCrop(picC, picB,130,120,0,0,77,101); 
picB.explore(); 


Picture[] output = {picA,picB, picC}; 
return output; 


3//end run 


//Crops a picture to the specified coordinate values and 
// flips it around a vertical line at its center. 
private Picture cropAndFlip(Picture pic,int x1,int y1, 
int x2,int y2){ 
Picture output = new Picture(x2-x1+1,y2-y1+1); 


int width = output.getWidth() ; 
Pixel pixel = null; 
Color color null; 
for(int col = x1;col < (x2+1);col++){ 
for(int row = yl;row < (y2+1);rowt+){ 
color = pic.getPixel(col,row) .getColor() ; 
pixel = output. getPixel (width-col+x1-1,row-y1); 
pixel.setColor(color) ; 
}//end inner loop 
}//end outer loop 


return output; 
}//end crop and flip 


//Copies part ofvdihelseunce apinmurcodntatithe destdmabiban/coll1441/1.181> 
// picture with an offset on both axes after first 

// confirming that the part will fit. Does nothing if it 

// won?t fit. 

private void copyPictureWithCrop ( 
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Table 3.304 


Image 1 . Prob02a.jpg. 
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Table 3.305 
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Table 3.306 
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Image 3 


. Possible output image. 


Answer 1 (p. 731) 


3.3.23.3.2 Question 2 


Table 3.307 


True or False? The call to the run method in Listing 2 (p. 729) returns a reference to an object of the class 


Picture 


Listing 2 


. Question 2. 


continued on next page 
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Picture[] pictures = new Java3014raRunner().run(); 


Table 3.308 


Answer 2 (p. 731) 


3.3.23.4 Images 


Image 1 (p. 723) . Prob02a.jpg. 

Image 2 (p. 725) . Prob02b.jpg. 

Image 3 (p. 729) . Possible output image. 
Image 4 (p. 735) . Answer 1. 


3.3.23.5 Listings 


e Listing 1 (p. 722) . Question 1. 
e Listing 2 (p. 729) . Question 2. 


What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None = ex) 


Display your nam: 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


3.3.23.6 Answers 
3.3.23.6.1 Answer 2 


False. The call to the run method in Listing 2 (p. 729) returns a reference to an array object whose elements 
may or may not contain references to objects of the class Picture (or some subclass of the class Picture 
) . However, since array objects in Java may have a length of 0, without seeing the source code for the 
run method, it is impossible to know what is contained in the array object. 

Back to Question 2 (p. 729) 


3.3.23.6.2 Answer 1 


False. The code in Listing 1 (p. 722) combined with the images in Image 1 (p. 723) and Image 2 (p. 725) 
produces the output shown in Image 4 (p. 735) . 
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Image 4 . Answer 1. 


Table 3.309 


Back to Question 1 (p. 721) 


3.3.23.7 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java3014r Review 
e File: Java3014r.htm 

e Published: 02/15/13 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
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version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.24 Java3014s Slides'” 
3.3.24.1 Table of Contents 


e Instructions for viewing slides (p. 736) 
e Miscellaneous (p. 736) 


3.3.24.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3014: Cropping, Flipping, and Combining 
Pictures 19° . 

Click here 19° to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.24.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3014s Slides 
e File: Java3014s.htm 
e Published: 01/06/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


197This content is available online at <http://cnx.org/content /m45628/1.3/>. 
198http://cnx.org/content /m44238 
199http://cnx.org/content /m45628 /latest /a0-Index.htm 
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I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.25 Java3016: Green-Screen Processing” 
3.3.25.1 Table of Contents 


e Preface (p. 737) 
Viewing tip (p. 737) 

x Images (p. 737) 

x Listings (p. 738) 
Preview (p. 738) 
General background information (p. 759) 
Discussion and sample code (p. 759) 
Run the program (p. 768) 
Summary (p. 768) 
What’s next? (p. 769) 
Online video links (p. 769) 
Miscellaneous (p. 769) 
Complete program listing (p. 769) 


3.3.25.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 2% . 


3.3.25.2.1 Viewing tip 
I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.3.25.2.1.1 Images 


e Image 1 (p. 742) . Input image file Prob03a.bmp. 
e Image 2 (p. 746) . Input image file Prob03b.bmp. 
e Image 3 (p. 750) . Input image file Prob03c.bmp. 
(p. 754) . Input image file Prob03d_.jpg. 


20°This content is available online at <http://cnx.org/content /m44210/1.8/>. 
201 http://cnx.org/content /m44148 /latest / 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


734 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


e Image 5 (p. 758) . Output picture. 
e Image 6 (p. 758) . Required output text. 
e Image 7 (p. 765) . Front view of the skater after cropping. 


3.3.25.2.1.2 Listings 


. The driver class named Prob03. 


e Listing 1 (p. 759) 

e Listing 2 (p. 760) . Beginning of the class named Prob03Runner. 
e Listing 3 (p. 760) . Beginning of the run method. 

e Listing 4 (p. 766) . Remainder of the run method. 

e Listing 5 (p. 767) . The greenScreenDraw method. 

e Listing 6 (p. 771) . Complete program listing. 


3.3.25.3 Preview 


n this lesson, you will learn how to write a program to do green-screen processing to superimpose a 
source image onto a destination image while making the green background of the source image appear to be 
transparent. 

Program specifications 

Write a program named Prob03 that uses the class definition shown in Listing 1 (p. 759) and Ericson’s 
media library along with the image files in the following list to produce the five graphic output images shown 
in Image 1 (p. 742) through Image 5 (p. 758) . 


Prob03a.bmp 
Prob03b.bmp 
Prob03c.bmp 
Prob03d.jpg 
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Image 1 . Input image file Prob03a.bmp. 


Zoom 


x) 0 > v4] 0 > 


R: 192 G: 192 B 192 Color at location: = 


av World PATE 


Table 3.310 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


739 


E Prob03b bmp lol x| 


Zoom 


| DM 9 


R: 192 G: 192 B: 192 Color at location: — 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


740 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


E Prob03b bmp lo} x 


Zoom 


| DM 9 


R: 192 G: 192 B: 192 Color at location: — 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


741 


E Prob03b bmp lol x| 


Zoom 


| DM 9 


R: 192 G: 192 B: 192 Color at location: — 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


742 


CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Image 2 
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Image 3 
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Image 4 . Input image file Prob03d.jpg. 
Prob03d jpg 
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Image 5 . Output picture. 
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i Display your name here. 


Table 3.314 


New classes 

You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named Prob03 given in Listing 1 (p. 759) . 

Required output text 

In addition to the output images mentioned above, your program must display your name and one other 
line of text on the command-line screen as shown in Image 6 (p. 758) . 


Image 6 . Required output text. 


continued on next page 
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Display your name here. 
Picture, filename None height 256 width 344 


Table 3.315 


3.3.25.4 General background information 


This program receives three views of an ice skater in bmp files with a pure green background along with 
a jpg file containing a snow scene. 

All four files show the Alice 7°? runtime panel with the words World Running... and sever 
associated buttons. (See Image 1 (p. 742) .) 

Program behavior 

The program performs the following actions: 


Crops the snow scene to remove the Alice runtime panel. 
Crops the three views of the skater to remove the Alice runtime panel along with excess blank green 
background. 
Scales two of the views of the skater to smaller sizes. 
Does green-screen processing to place the three views of the skater at different locations in the snow 
scene. 

e Uses position along with size to create an optical illusion of a 3D scene of three ice skaters and a 
penguin standing at different locations on a frozen lake (see Image 5 (p. 758) ) . 


Programming skills required 
In order to write this program, the student must be able to, as a minimum, write a green-screen processing 
method. 


3.3.25.5 Discussion and sample code 


Will discuss in fragments 

I will discuss this program in fragments. A complete listing of the program is provided in Listing 6 (p. 
771) near the end of the lesson. 

The driver class named Prob03 

The driver class containing the main method is shown in Listing 1 (p. 759) . 


Listing 1 . The driver class named Prob03. 


import java.awt.Color; 


public class Prob03{ 
public static void main(String[] args){ 
ProbO3Runner obj = new ProbO03Runner() ; 
obj.run(); 
}//end main 
}//end class Prob03 


02 http://www.alice.org/ 
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Table 3.316 


The main method in Listing 1 (p. 759) instantiates a new object of the class named Prob03Runner 
and calls the method named run that belongs to that object. 

When the run method returns, the program terminates. 

Beginning of the class named Prob03Runner 

The beginning of the class named Prob03Runner , and its constructor, is shown in Listing 2 (p. 760) 


Listing 2 . Beginning of the class named Prob03Runner. 


class ProbO3Runner{ 


public Prob03Runner () {//constructor 
System.out.println("Display your name here."); 
}//end constructor 


Table 3.317 


The constructor simply displays the student’s name on the command line screen producing the first line 
of text. shown in Image 6 (p. 758) . 

Beginning of the run method 

The beginning of the run method that is called in Listing 1 (p. 759) is shown in Listing 3 (p. 760) . 


Listing 3 . Beginning of the run method. 


public void run()f{ 


//A view facing the front of the skater. 
Picture front = new Picture("Prob03a. bmp") ; 
front.explore() ; 

front = crop(front,123,59,110,256) ; 


//A view showing the right side of the skater. 
Picture right = new Picture("Prob03b. bmp") ; 
right .explore() ; 

right = crop(right,123,59,110,256) ; 


//A view showing the left side of the skater. 
Picture left = new Picture("Prob03c.bmp") ; 
left.explore() ; 

left = crop(left,123,59,110, 256); 


//This will be the background for the new picture. 
Picture snowScene = new Picture("Prob03d. jpg"); 
snowScene.explore(); 

snowScene = crop(snowScene,6,59,344, 256) ; 
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Table 3.318 


The code in Listing 3 (p. 760) instantiates, displays, and crops the four input images. 

All four images must be cropped to remove the Alice runtime window. In addition, the three skater 
images are also cropped to remove excess blank green background material. 

Image formats: bmp versus jpg 

Note that the three views of the skater are extracted from bmp image files instead of jpg image files. 
This is necessary in order to preserve the pure green background color. Storing the images as jpg files 
would corrupt the background color in the low order bits making it more difficult to achieve the green-screen 
processing required by this program. 

The method named crop 

Listing 3 calls the crop method four times in succession. once for each of the four Picture objects 
instantiated from the image files. 

I explained image cropping in an earlier module. The crop method used in this program is very similar 
to the methods that I explained in the earlier module, so I won’t explain it again in this module. You can 
view the crop method in detail in Listing 6 (p. 771) near the end of the module. 

Five incoming parameters 

The crop method requires five incoming parameters. The first parameter is a reference to the Picture 
object that is to be cropped. The remaining four integer parameters specify the rectangular area that is to 
be preserved after the picture is cropped. 

The rectangular area to be preserved 

The first two integers specify the column and row coordinates for the upper-left corner of the rectangular 
area that is to be preserved. The last two integers specify the width and the height of the rectangle that is 
to be preserved. 

Note that in all four cases, the height of the rectangular area that is to be preserved is 256 pixels. This 
will be important later on with respect to scaling two of the images. 

Returns a reference to a cropped picture 

The crop method returns a reference to a Picture object that is a cropped version of the picture 
whose reference is passed to the method. In each case, the code in Listing 3 (p. 760) replaces the reference 
to the original Picture object with the reference to the cropped Picture object. 

Front view of the skater after cropping 

If you were to display the Picture object referred to by the variable front after cropping, you would 

see the image shown in Image 7 (p. 765) . 
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| Image 7 . Front view of the skater after cropping. 
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Table 3.319 


Transparent pixels 

This is the image that appears as the center ice skater in Image 5 (p. 758) after green-screen processing. 
Note that all of the green pixels in Image 7 (p. 765) appear to be transparent in Image 5 (p. 758) . 

Remainder of the run method 

Continuing with the run method, Listing 4 (p. 766) calls the method named greenScreenDraw three 
times in succession to draw the three skater images at specific locations on the snow scene with green-screen 
processing. 
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Listing 4 . Remainder of the run method. 


//Draw the front view of the skater on the snowScene 
// at full size. 
greenScreenDraw (front, snowScene,117,0); 


//Draw the left side view of the skater on the 
// snowScene at half size. 

left = left. getPictureWithHeight (256/2); 
greenScreenDraw(left,snowScene, 55,64) ; 


//Draw the right side view of the skater on the 
// snowScene at one-third size. 

right = right.getPictureWithHeight (256/3) ; 
greenScreenDraw (right , snowScene, 260, 96) ; 


//Display students name on the final output and 
// display it. 
snowScene.addMessage("Display your name here.",10,15); 
snowScene.explore() ; 
System. out.println(snowScene) ; 
3//end run method 


Table 3.320 


Two skater images are scaled 

In two cases in Listing 4 (p. 766) , the method named getPictureWithHeight is called before calling 
the greenScreenDraw method. The getPictureWithHeight method is used to scale two of the 
images to a smaller size as shown in Image 5 (p. 758) . 

The getPictureWithHeight method 

The getPictureWithHeight method is defined in Ericson’s SimplePicture class and inherited into 
Ericson’s Picture class. 

The method requires a single integer input parameter, which specifies the height in pixels of a scaled 
output version of the picture object on which the method is called. 

According to the documentation, the method can be used to create a new picture with the specified 
height. The aspect ratio of the width and height will stay the same. 

Original height is 256 pixels 

Referring back to the parameters that were passed to the crop method in Listing 3 (p. 760) , you can 
see the height of all three cropped images is 256 pixels. 

Scale by 1/2 and 1/3 

Referring to the two calls to the getPictureWithHeight method in Listing 4 (p. 766) , you can see 
that one of the cropped images was replaced with an image having a height of 256/ 2 or 128 pixels. The 
other cropped image was replaced with an image having a height of 256/3 or 85 pixels. You can see the 
effect. of this scaling in Image 5 (p. 758) . 

The height of one of the images was not changed, which you can also see in Image 5 (p. 758) . 

Put the run method on hold 

Į will put the explanation of the run method on temporary hold at this point and explain the method 
named greenScreenDraw , which is shown in Listing 5 (p. 767) . 

Behavior of the greenScreenDraw method 

The greenScreenDraw method requires four incoming parameters: 
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A reference to a source image. 
A reference to a destination image 
The horizontal coordinate on the destination image where the upper-left corner of the source image 
will be drawn. 

e The vertical coordinate on the destination image where the upper-left corner of the source image will 
be drawn. 


Pure green pixels are required for transparency 

The method draws the source image onto the destination image at the specification location. However, 
pixels having a pure green color are not drawn on the destination image. The effect is to make it appear 
that those portions of the source image with pure green pixels become totally transparent allowing the pixels 
belonging to the destination image to show through. 

jpg image files are not satisfactory for this program 

Picture objects created from jpg image files typically won’t have a pure green background even if they 
had a pure green background before being compressed into the jpg format file. However, the bmp file format 
does not corrupt the pixel colors. Therefore, bmp images work well for this type of processing. 

The greenScreenDraw method 

The greenScreenDraw method is shown in its entirety in Listing 5 (p. 767) . 


Listing 5 . The greenScreenDraw method. 


private void greenScreenDraw( 

Picture source, 
Picture dest, 
//Place the upper-left corner 
// of the source image at the 
// following location in the 
// destination image. 
int destX, 
int destyY){ 

int width = source.getWidth() ; 

int height = source. getHeight (); 

Pixel pixel = null; 

Color color null; 


for(int row = O;row < height;row++){ 
for(int col = 0;col < width;col++){ 
color = source.getPixel(col,row) .getColor(); 
if (! (color.equals(Color.GREEN))){ 
pixel = dest.getPixel(destX + col,destY + row); 
pixel.setColor (color); 
}//end if 
}//end inner loop 
}//end outer loop 


}//end greenScreenDraw 


Table 3.321 
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Very similar to earlier methods 

This method is very similar to other methods that I have explained in earlier modules that use nested 

for loops to draw one image onto another image. 
The one new thing... 

The only thing that is really new in Listing 5 (p. 767) is the if statement that tests the color of source 
image pixels for a value of exactly Color.GREEN . If the color of the source pixel does not match that 
color exactly, it is drawn on the destination image replacing the pixel color previously at that location on 
the destination image. 

If the source pixel color does exactly match that color, it is not drawn on the destination image thereby 
leaving the color of the corresponding destination pixel unchanged. 

Listing 5 (p. 767) signals the end of the greenScreenDraw method. 

The weather forecast on television 

This is roughly how the TV stations superimpose a human weather forecaster onto a giant animated 
weather map. The forecaster is photographed with a video camera standing in front of a green or blue 
screen. At the same time, an animated video of the weather map is also created. 

Then each video frame of the forecaster is superimposed onto a video frame of the weather map. The 
green or blue pixels in the forecaster frame are not copied onto the weather map frame. This allows the 
weather map pixels to show with the exception of those that are replaced by the pixels that comprise the 
human forecaster. (The forecaster must be careful to avoid wearing clothing that matches the color of the 
green or blue screen.) 

Returning to the run method 
When the third call to the greenScreenDraw method returns in Listing 4 (p. 766) , the run method: 


e Adds the student’s name to the snow scene picture. 
e Displays the snow scene picture (see Image 5 (p. 758) ). 
e Displays information about the snow scene picture on the command line screen. 


The end of the program 
Then the run method in Listing 4 (p. 766) returns control to the main method in Listing 1 (p. 759) 
causing the program to terminate. 


3.3.25.6 Run the program 


I encourage you to copy the code from Listing 6 (p. 771) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 

Click the following links to download the required input images: 


. Prob03a.bmp 7% 
. Prob03b.bmp 2% 
. Prob03c.bmp °? 
. Prob03d.jpg 7°° 


A wrwm re 


3.3.25.7 Summary 


In this module, you learned how to write a program to do green-screen processing to superimpose a 
source image onto a destination image while making the green background of the source image appear to be 
transparent. 


203http://cnx.org/content /m44210/latest /Prob03a.bmp 
204http://cnx.org/content /m44210/latest /Prob03b.bmp 
205http://cnx.org/content /m44210/latest /Prob03c.bmp 
206 http://cnx.org/content /m44210/latest /Prob03d.jpg 
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3.3.25.8 What’s next? 


You will learn how to darken, brighten, and tint the colors ina Picture object in the next module. 


3.3.25.9 Online video links 


Select the following links to view online video lectures on the material in this module. 


e ITSE 2321 Lecture 08 207 


Part01 28 
Part02 29 
Part03 21° 


3.3.25.10 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Green-Screen Processing 
e File: Java3016.htm 

e Published: 08/01/12 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.3.25.11 Complete program listing 


A complete listing of the program discussed in this module is shown in Listing 6 (p. 771) below. 


Listing 6 . Complete program listing. 


continued on next page 
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210http://www.youtube.com/watch?v=4bM6qElbxpc 
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/*File Prob03 Copyright 2008 R.G.Baldwin 
Revised 12/17/08 
BOSSA A AS CIO I II I I I II I ICI IK 1K 1K EEE EEE 24 2k Fok ff 2K ak ak af 2k a / 
import java.awt.Color; 
public class Prob03{ 
public static void main(String[] args){ 
ProbO3Runner obj = new ProbO03Runner() ; 
obj .run(); 
}//end main 
}//end class Prob03 


class ProbO3Runner{ 


public Prob03Runner () {//constructor 
System.out.println("Display your name here."); 
}//end constructor 


public void run(){ 
//Instantiate, display and crop the four input 
// images. They must be cropped to remove the Alice 
// runtime window material. The three skater images 
// are also cropped to remove excess blank green 
// background. 


//Note that the three views of the skater are bmp 

// images instead of jpg images in order to preserve 
// the pure green background color. Storing the 

// images as jpg files would corrupt the background 
// color in the low order bits. 

//A view facing the front of the skater. 

Picture front = new Picture("Prob03a.bmp") ; 

front .explore() ; 

front = crop(front,123,59,110,256) ; 


//A view showing the right side of the skater. 
Picture right = new Picture("Prob03b. bmp") ; 
right .explore() ; 

right = crop(right,123,59,110,256) ; 


//A view showing the left side of the skater. 
Picture left = new Picture("Prob03c.bmp") ; 
left.explore() ; 

left = crop(left,123,59,110, 256); 


//This will be the background for the new picture. 
Picture snowScene = new Picture("Prob03d. jpg"); 
snowScene.explore(); 

snowScene = crop(snowScene,6,59,344, 256) ; 


//Draw the front vien gt thie skater ono tne snowScene e ceia 
// at full sinwila e for free at Connexions <http://cnx.org/content/co / > 


greenScreenDraw (front, snowScene,117,0); 


//Draw the left side view of the skater on the 
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Table 3.322 


-end- 
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3.3.26 Java3016r Review 
3.3.26.1 Table of Contents 
e Preface (p. 773) 
e Questions (p. 773) 
1 (p. 773) 


Images (p. 798) 
Listings (p. 799) 
Answers (p. 800) 
Miscellaneous (p. 800) 


3.3.26.2 Preface 


This module contains review questions and answers keyed to the module titled Java3016: Green-Screen 
Processing ?!? . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.26.3 Questions 


3.3.26.3.1 Question 1 


Given Image 1 (p. 778) , Image 2 (p. 782) , Image 3 (p. 786) , and Image 4 (p. 790) , which of the following 
output images is produced by the code in Listing 1 (p. 774) ? 

A. Image 5 (p. 794) 

B. Image 6 (p. 798) 


211This content is available online at <http://cnx.org/content /m45781/1.2/>. 
?12http://cnx.org/content /m44210 
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Listing 1 . Question 1. 


/*File Java3016ra Copyright 2013 R.G.Baldwin 
Revised 02/15/13 
FOS OI AIA ICI II II I I I EEEE EEE EEEE EEE EEE EEEE EEE 2k ak ak ak ak a / 
import java.awt.Color; 
public class Java3016raf{ 

public static void main(String[] args){ 

new Java3016raRunner().run(); 

}//end main 

}//end class Java3016ra 


class Java3016raRunner{ 
public void run(){ 


Picture snowScene = crop( 
new Picture("Prob03d. jpg") ,6,59, 344, 256) ; 


greenScreenDraw(crop(new Picture("Prob03a.bmp") , 
123,59,110,256) ,snowScene,117,0); 
greenScreenDraw( 
crop(new Picture("Prob03c.bmp") ,123,59,110, 256) . 
getPictureWithHeight (256/2) ,snowScene, 55,64) ; 
greenScreenDraw( 
crop(new Picture("Prob03b.bmp") ,123,59,110, 256). 
getPictureWithHeight (256/3) , snowScene, 260,96) ; 


snowScene.explore(); 


3//end run method 


private void greenScreenDraw(Picture source, 
Picture dest, 
int destX, 
int destY){ 
Pixel pixel = null; 
Color color null; 


for(int row = 0;row < source.getHeight () ;rowt++){ 
for(int col = 0;col < source.getWidth() ;col++t){ 
color = source.getPixel(col,row) .getColor() ; 
if ((!(color.equals(Color.GREEN) ))&& 
(!(color.getRed() < 40))){ 
dest .getPixel(destX + col,destY + row). 
setColor(color) ; 
}//end if 
}//end inner loop 
}//end outer loop 
3//end greenScraenbawWor free at Connexions <http://cnx.org/content /col11441/1.181> 


private Picture crop(Picture pic,int startCol, 
int startRow, 
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| Image 1 . Prob03a.bmp. 
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| Image 2 . Prob03b.bmp. 
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Image 5 . Possible output image. 


Table 3.328 
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Image 6 . Possible output image. 


Table 3.329 


Answer 1 (p. 800) 


3.3.26.4 Images 


e Image 1 (p. 778) . Prob03a.bmp. 

e Image 2 (p. 782) . Prob03b.bmp. 

e Image 3 (p. 786) . Prob03c.bmp. 

e Image 4 (p. 790) . Prob03d.jpg. 

e Image 5 (p. 794) . Possible output image. 
e Image 6 (p. 798) . Possible output image. 
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3.3.26.5 Listings 

e Listing 1 (p. 774) . Question 1. 
What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 


The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None KEX] 


Display your name 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Put your name here 


3.3.26.6 Answers 
3.3.26.6.1 Answer 1 


The code in Listing 1 (p. 774) produces the output image shown in Image 6 (p. 798) . 
Back to Question 1 (p. 773) 


3.3.26.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3016r Review 
e File: Java3016r.htm 

e Published: 02/17/13 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.27 Java3016s Slides” 
3.3.27.1 Table of Contents 


e Instructions for viewing slides (p. 801) 
e Miscellaneous (p. 801) 


3.3.27.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3016: Green-Screen Processing 7! . 

Click here ?15 to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.27.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3016s Slides 
e File: Java3016s.htm 
e Published: 01/06/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 


213This content is available online at <http://cnx.org/content /m45637/1.2/>. 
214http://cnx.org/content /m44210 
215http://cnx.org/content /m45637/latest /a0-Index.htm 
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a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


6 


3.3.28 Java3018: Darkening, Brightening, and Tinting the Colors in a Picture” 
3.3.28.1 Table of Contents 


e Preface (p. 802) 
Viewing tip (p. 802) 

x Images (p. 802) 

x Listings (p. 803) 
Preview (p. 803) 
General background information (p. 820) 
Discussion and sample code (p. 820) 
Run the program (p. 834) 
Summary (p. 834) 
What’s next? (p. 835) 
Online video links (p. 835) 
Miscellaneous (p. 835) 
Complete program listing (p. 835) 


3.3.28.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 7!" . 


3.3.28.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.3.28.2.1.1 Images 


e Image 1 (p. 807) . Input file Prob04a.bmp. 

e Image 2 (p. 811) . Input file Prob04b.bmp. 

e Image 3 (p. 815) . Input file Prob04c.jpg. 

e Image 4 (p. 819) . Required output image. 

e Image 5 (p. 820) . Required text output. 

e Image 6 (p. 825) . Cropped version of the snow scene image. 
e Image 7 (p. 833) . The skater with a red tint applied. 


216This content is available online at <http://cnx.org/content /m44234/1.6/>. 
217http://cnx.org/content /m44148 /latest / 
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3.3.28.2.1.2 Listings 


e Listing 1 (p. 820) . The driver class named Prob04. 

e Listing 2 (p. 821) . Beginning of the class named Prob04Runne. 
e Listing 3 (p. 821) . Beginning of the run method. 

e Listing 4 (p. 826) . Darken the background of the snow scene. 

e Listing 5 (p. 826) . Beginning of the darkenBackground method. 
e Listing 6 (p. 827) . Beginning of the processing loop. 

e Listing 7 (p. 828) . The else clause in the processing loop. 

e Listing 8 (p. 829) . Apply a red tint to the skater. 

e Listing 9 (p. 834) . The remainder of the run method. 

e Listing 10 (p. 835) . Complete program listing. 


3.3.28.3 Preview 


In this module, you will learn how to darken, brighten, and tint the colors ina Picture object. 
Program specifications 
Write a program named Prob04 that uses the class definition shown in Listing 1 (p. 820) and Ericson’s 
media library along with the image files in the following list to produce the four graphic output images shown 
in Image 1 (p. 807) through Image 4 (p. 819) . 


e Prob04a.bmp 
e Prob04b.bmp 
e Prob04c.jpg 
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Image 1 . Input file Prob04a.bmp. 
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Image 2 . Input file Prob04b.bmp. 
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Table 3.331 
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Image 3 . 
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Image 4 . Required output image. 
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Table 3.333 


New classes 

You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named Prob04 shown in Listing 1 (p. 820) . 

Required text output 

In addition to the four output images mentioned above, your program must display your name and the 
other line of text shown in Image 5 (p. 820) on the command-line screen. 
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Image 5 . Required text output. 


Display your name here. 
Picture, filename None height 293 width 392 


Table 3.334 


3.3.28.4 General background information 


This program uses a black ellipse on a green background (see Image 2 (p. 811) ) as a pattern to cause the 
pixels in a snow scene (see Image 3 (p. 815) ) at the location of the ellipse to be given a red tint and causes 
all other pixels in the snow scene to be darkened (see Image 4 (p. 819) ) . 

The program also causes a red skater in a green background (see Image 1 (p. 807) ) to be given a 
red tint and then drawn on the snow scene at the location of the red-tinted ellipse. The effect is that of a 
spotlight with a red tint shining on the skater (see Image 4 (p. 819) ) . 


3.3.28.5 Discussion and sample code 


Will discuss in fragments 

I will discuss this program in fragments. A complete listing of the program is provided in Listing 10 (p. 
835) near the end of the module. 

The driver class named Prob04 

The driver class containing the main method is shown in Listing 1 (p. 820) . 


Listing 1 . The driver class named Prob04. 


import java.awt.Color; 


public class Prob04{ 
public static void main(String[] args){ 
Prob04Runner obj = new ProbO04Runner() ; 
obj .run(); 
}//end main 
3//end class Prob04 


Table 3.335 


As has been the case in several earlier modules, the code in the main method instantiates an object of 
the class named Prob04Runner and calls the run method on that object. 

When the run method returns, the main method terminates causing the program to terminate. 

Beginning of the class named Prob04Runner 

The class named Prob04Runner begins in Listing 2 (p. 821) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


816 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Listing 2 . Beginning of the class named Prob04Runner. 


class Prob04Runner{ 


public Prob04Runner () {//constructor 
System.out.println("Display your name here."); 
}//end constructor 


Table 3.336 


Listing 2 (p. 821) shows the constructor for the class, which simply displays the student’s name on the 
command line screen as shown in Image 5 (p. 820) . 

Beginning of the run method 

The beginning of the run method, which is called in Listing 1 (p. 820) , is shown in Listing 3 (p. 821) . 


Listing 3 . Beginning of the run method. 


public void run()f{ 


Picture skater = new Picture("Prob04a. bmp") ; 
skater .explore(); 
skater = crop(skater,6,59,392,293) ; 


Picture hole = new Picture("Prob04b. bmp") ; 
hole.explore() ; 
hole = crop(hole,6,59,392, 293) ; 


Picture snowScene = new Picture("Prob04c. jpg"); 
snowScene.explore() ; 
snowScene = crop(snowScene,6,59,392, 293) ; 


Table 3.337 


Instantiate and display three Picture objects 

The code in Listing 3 (p. 821) instantiates Picture objects from the three image files and displays 
those pictures in Image 1 (p. 807) , Image 2 (p. 811) , and Image 3 (p. 815) . 

Crop the pictures 

Note that the images in those three pictures contain the Alice ?!® runtime window controls as a banner 
that reads World Running... and a line of buttons. 

The method named crop 

Listing 3 (p. 821) calls a method named crop on all three Picture objects to eliminate the Alice 
runtime controls. Note that the same rectangular area is preserved for all three images. Thus, all three 
images are the same size after cropping. 

The cropped snow scene image 


218http://www.alice.org/ 
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If you were to display the picture whose reference is stored in the variable named snowScene after 
the crop method returns, you would see the image shown in Image 6 (p. 825) with the Alice runtime 
controls no longer visible. 
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Image 6 . Cropped version of the snow scene image. 


Table 3.338 


The crop method 

The method named crop that was used to crop the three pictures is essentially the same as the cropping 
methods that I explained in earlier modules. Therefore, I won’t repeat that explanation here. You can view 
the crop method in its entirety in Listing 10 (p. 835) near the end of the module. 

Darken the background of the snow scene 

Listing 4 (p. 826) calls the method named darkenBackground to make all of the pixels darker in the 
snow scene except for those in the location of the ellipse as shown in Image 4 (p. 819) . The pixels at the 
location of the ellipse are given a red tint. 
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Listing 4 . Darken the background of the snow scene. 


darkenBackground (hole, snowScene) ; 


Table 3.339 


Put the run method on temporary hold 
I will put the explanation of the run method on hold at this point and explain the method named 
darkenBackground 
The method named darkenBackground 
The method named darkenBackground receives references to two Picture objects as parameters. It 
uses the first picture as a pattern from which it determines which pixels in the second picture (destination) 
should be darkened. 
The pattern and destination images 
In this case, a cropped version of the image of the black ellipse shown in Image 2 (p. 811) is the pattern. 
The cropped image of the snow scene shown in Image 6 (p. 825) is the destination image whose pixels will 
be darkened. 
Assumptions 
The darkenBackground method assumes that the pattern image has a pure green background as 
shown in Image 2 (p. 811) . It also assumes that the pattern and the destination have the same dimensions. 
Behavior of the method 
The darkenBackground method darkens every pixel in the destination that is at the location of a 
green pixel in the pattern. 
The method applies a red tint to every pixel in the destination that is at the location of a non-green pixel 
in the pattern 
Beginning of the darkenBackground method 
The darkenBackground method begins in Listing 5 (p. 826) . 


Listing 5 . Beginning of the darkenBackground method. 


private void darkenBackground(Picture pattern, 
Picture dest){ 


Pixel[] patternPixels = pattern.getPixels(); 
Pixel[] destPixels = dest.getPixels(); 

Color color = null; 

int red = 0; 

int green = 0; 

int blue = 0; 


Table 3.340 


Get two arrays of pixel data 
The darkenBackground method begins by calling the getPixels method on each of the picture 
objects to create a pair of array objects containing pixel data. 
You learned how to use the getPixels method in an earlier module. Recall that this approach is useful 
when you don’t need to be concerned about the locations of the pixels in an x-y coordinate system. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


822 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Arrays have the same length 

Because the two pictures have the same dimensions, the two arrays have the same length. 

A given array index specifies pixel data from the same location in both pictures. 

Beginning of the processing loop 

The method uses a for loop to traverse the two arrays of pixel data in parallel, using information from 
the pattern picture to make the color changes to the destination picture described above. The for loop 
begins in Listing 6 (p. 827) . 


Listing 6 . Beginning of the processing loop. 


for(int cnt = 0;cnt < patternPixels. length; cnt++){ 
color = patternPixels[cnt].getColor(); 
if (color.equals(Color.GREEN) ) { 
//Darken corresponding pixel in the destination. 
color = destPixels[cnt].getColor(); 
destPixels [cnt] .setColor(color.darker()); 


Table 3.341 


Behavior of the processing loop 
The loop begins by getting the color value of the next pixel in the pattern array. If the color of the 
pattern pixel is green, the code in Listing 6 (p. 827) : 


Gets the color from the corresponding pixel in the destination array. 
Calls the method named darker , which is a method of the Color class in the standard Sun library, 
to produce a darker version of the pixel color. 

e Replaces the pixel color in the destination array with the darker version of the color. 


Compare images to see the results 

If you compare Image 4 (p. 819) with Image 3 (p. 815) , you will see that (ignoring the skater and the 
ellipse) , all of the pixels in Image 4 (p. 819) are darker versions of the colors in Image 3 (p. 815) . 

The brighter method 

The Color class also provides a method named brighter which has the opposite effect. In particular, 
it can be used to brighten the color of a pixel. 

These two methods are very useful for making a pixel darker or brighter without having to know anything 
about the actual color of the pixel. 

The else clause in the processing loop 

If the color of the pattern pixel (tested in Listing 6 (p. 827) ) is not green, the code in the else clause 
in Listing 7 (p. 828) is executed. 


Listing 7 . The else clause in the processing loop. 


continued on next page 
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}else{ 
//Apply a red tint to the corresponding pixel in 
// the destination. 
color = destPixels[cnt] .getColor(); 
red = color.getRed(); 
if (red*1.25 < 255){ 
red = (int)(red * 1.25); 
}else{ 
red = 255; 
}//end else 
green = (int)(color.getGreen() * 0.8); 
blue = (int) (color.getBlue() * 0.8); 
destPixels[cnt] .setColor(new Color (red, green, blue) ) ; 
}//end else 
}//end for loop 


}//end darkenBackground 


Table 3.342 


The snow scene and the ellipse only... 

At this point, only the images from Image 2 (p. 811) (the ellipse) and Image 3 (p. 815) (the snow 
scene) are being processed. The image of the skater in Image 1 (p. 807) hasn’t entered the picture yet. 

Application of the ellipse pattern 

The code in Listing 7 (p. 828) is executed only if the pixel from the destination picture is at a location 
that matches one of the non-green (black) pixels in the ellipse in Image 2 (p. 811) . 

(The fact that the pixel is black is of no consequence. The only thing that matters is that it is not 

green.) 

The objective of the else clause 

The objective is to modify the pixel color in the destination picture at this location to give it a red tint 
as shown in Image 4 (p. 819) . 

Get, save, and modify the red color value 

Listing 7 (p. 828) begins by getting the color of the pixel from the current location in the destination 
picture. It extracts and saves the red color value of the pixel. Then, depending on the current value of the 
red color value, it either: 


e Multiplies the red color value by a factor of 1.25, or 
e Sets the red color value to the maximum allowable value of 255. 


Decrease the color values for blue and green 

Following this, it gets the green and blue color values and multiplies each of them by 0.8. 

Replace the old pixel color with the new color 

Finally, it replaces the pixel color with a new color using the modified values of red, green, and blue. 

The texture is preserved 

As you can see in Listing 4 (p. 826) , this process causes the pixels in locations that match the ellipse 
to take on a red tint, but the texture of the image is not destroyed as it would be if the pixels had simply 
been replaced by pixels that all have the same color of pink. 

The end of the darkenBackground method 

Listing 7 (p. 828) signals the end of the processing loop and the end of the darkenBackground 
method. 
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Apply a red tint to the skater 

Returning to where we left off in the run method in Listing 4 (p. 826) , the code in Listing 8 (p. 829) 
calls a method named redTint_ , passing a reference to the picture that contains a cropped image of the 
skater. The method applies a red tint to the skater. 


Listing 8 . Apply a red tint to the skater. 


redTint (skater) ; 


Table 3.343 


The redTint method assumes that the image being processed has a pure green background like that 
shown in Image 1 (p. 807) . The method applies an algorithm very similar to that shown in Listing 7 (p. 
828) to apply a red tint to every pixel that is not pure green. 

Because of the similarity of the code in the redTint method and the code in Listing 7 (p. 828) , 
a detailed explanation of the redTint method should not be required. You can view the method in its 
entirety in Listing 10 (p. 835) near the end of the module. 

The skater with the red tint applied 

If you were to display the picture referred to by skater immediately after the redTint method returns 

in Listing 8 (p. 829) , you would see the image shown in Image 7. 
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DER 


x @ jo > vaho 


R: 0 G: 255 BO Color at location: | | 
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Image 7 . The skater with a red tint applied. 


DAR) 
<a MM M 


R: 0 G: 255 B: 0 Color at location: Lj 


Table 3.344 


Compare Image 7 with Image 1 

You can see the effect of applying the red tint process to the skater by comparing Image 7 (p. 833) with 
Image 1 (p. 807) . Note that the process does not change the color of the green pixels. 

The remainder of the run method 

Continuing with the run method, Listing 9 (p. 834) calls a method named greenScreenDraw to 
draw the cropped, red-tinted skater on the snow scene as shown in Image 4 (p. 819) . 
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Listing 9 . The remainder of the run method. 


//Draw the skater on the snowScene. 
greenScreenDraw(skater,snowScene,0,0); 


//Display students name on the final output and 
// display it. 


snowScene.addMessage("Display your name here.",10,15); 


snowScene.explore() ; 
System. out.println(snowScene) ; 


3//end run method 


Table 3.345 


Behavior of the method 

The greenScreenDraw method copies all non-green pixels from a source image to a destination image 
at a specified location. This method is very similar to methods that I have explained in earlier modules. 
Therefore, an explanation of the method in this module should not be needed. 

You can view the greenScreenDraw method in its entirety in Listing 10 (p. 835) near the end of the 
module. 

Add text and display the final output image 

When the greenScreenDraw method returns, Listing 9 (p. 834) calls the addMessage method to 
display the student’s name on the snow scene and then calls the explore method to produce the output 
image shown in Image 4 (p. 819) . None of that should be new to you at this point. 

Display text and return 

Finally, Listing 9 (p. 834) displays some information on the command line screen as shown in Image 5 
(p. 820) and returns control to the main method in Listing 1 (p. 820) . 

Terminate the program 

Having nothing more to do, the main method terminates, causing the program to terminate and return 
control to the operating system. 


3.3.28.6 Run the program 


I encourage you to copy the code from Listing 10 (p. 835) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 

Click the following links to download the required input files: 


e Prob04a.bmp °!’ 
e Prob04b.bmp 77° 
e Prob04c.jpg 2?! 


3.3.28.7 Summary 


In this module, you learned how to darken, brighten, and tint the colors ina Picture object. 


219http://cnx.org/content /m44234 /latest /Prob04a.bmp 
220http://cnx.org/content /m44234/latest /Prob04b.bmp 
221 http://cnx.org/content /m44234/latest /Prob04c.jpg 
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3.3.28.8 What’s next? 


You will probably learn more than you already know about interfaces, arrays of type Object, etc., in the 
next module. 


3.3.28.9 Online video links 


Select the following links to view online video lectures on the material in this module. 


e ITSE 2321 Lecture 09 ??? 


Part01 228 
Part02 224 
Part03 275 


3.3.28.10 Miscellaneous 


This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java OOP: Darkening, Brightening, and Tinting the Colors in a Picture 
e File: Java3018.htm 

e Published: 08/01/12 

e Revised:12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.3.28.11 Complete program listing 


A complete listing of the program discussed in this module is shown in Listing 10 (p. 835) below. 


Listing 10 . Complete program listing. 


continued on next page 


222 http://www.youtube.com/playlist?list=PL11F9AC688AC89E56 
223http://www.youtube.com/watch?v=T-pcemz5XmQY 

224 http://www.-youtube.com/watch?v=T16J MwpBIUI 
?25http://www.youtube.com/watch?v=aXLKqYA_O0Ng 
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/*File Prob04 Copyright 2008 R.G.Baldwin 
FOSSA IO GIORGI SIA IOI RISC I I I I I I ISI A a Kk kk ak kk / 


import java.awt.Color; 
public class Prob04{ 
public static void main(String[] args){ 
Prob04Runner obj = new Prob04Runner() ; 
obj.run(); 
}//end main 
3//end class Prob04 


class Prob04Runner{ 


public Prob04Runner () {//constructor 
System.out.println("Display your name here."); 
}//end constructor 


public void run(){ 


Picture skater = new Picture("Prob04a. bmp") ; 
skater .explore(); 
skater = crop(skater,6,59,392,293) ; 


Picture hole = new Picture("Prob04b. bmp"); 
hole.explore() ; 
hole = crop(hole,6,59,392, 293) ; 


Picture snowScene = new Picture("Prob04c. jpg"); 
snowScene.explore() ; 
snowScene = crop(snowScene,6,59,392, 293) ; 


//Make all the pixels darker in the snow scene except 
// for those in the location of the hole. Make them 
// brighter. 

darkenBackground (hole, snowScene) ; 


//Apply a red tint to the skater 
redTint (skater) ; 


//Draw the skater on the snowScene. 
greenScreenDraw(skater,snowScene,0,0); 


//Display students name on the final output and 
// display it. 
snowScene.addMessage("Display your name here.",10,15); 


snowScene.explore(); 
System. out.println(snowScene) ; 


Available for fi i http: : 111441/1.181 
}//end run method able for free at Connexions <http://cnx.org/content/co /1.181> 


//Assumes the source has a pure green background. 
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-end- 
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Table 3.346 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


833 


3.3.29 Java3018r Review” 
3.3.29.1 Table of Contents 
e Preface (p. 838) 
e Questions (p. 838) 
1 (p. 838) 


Images (p. 859) 
Listings (p. 860) 
Answers (p. 861) 
Miscellaneous (p. 861) 


3.3.29.2 Preface 


This module contains review questions and answers keyed to the module titled Java3018: Darkening, Bright- 
ening, and Tinting the Colors in a Picture 227 . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.29.3 Questions 


3.3.29.3.1 Question 1 


Given Image 1 (p. 843) , Image 2 (p. 847) , and Image 3 (p. 851) , which of the following output images is 
produced by the code in Listing 1 (p. 839) ? 

A. Image 4 (p. 855) 

B. Image 5 (p. 859) 


226This content is available online at <http://cnx.org/content /m45782/1.2/>. 
27 http://cnx.org/content /m44234 
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Listing 1 . Question 1. 


/*File Java3018ra Copyright 2013 R.G.Baldwin 
FE EEEE EEEE EEE EEEE EEE EE EEE EEE I I I A E 21 21 EE 21 21 21 4 4 2 E 2 ff 2k 2 2 E / 


import java.awt.Color; 
public class Java3018raf{ 
public static void main(String[] args){ 
new Java3018raRunner().run(); 
}//end main 
}//end class Java3018ra 


class Java3018raRunner{ 


public Java3018raRunner(){//constructor 
System.out.println("Display your name here."); 
}//end constructor 


public void run(){ 


Picture skater = crop(new Picture("Prob04a.bmp") ,6,59, 392, 293) ; 
Picture hole = crop(new Picture("Prob04b.bmp") ,6,59, 392,293) ; 
Picture snowScene = crop(new Picture("Prob04c. jpg") ,6,59, 392, 293) ; 
processBackground (hole, snowScene) ; 

redTint (skater) ; 

greenScreenDraw(skater,snowScene,0,0); 

snowScene.explore() ; 


3//end run method 


private void redTint(Picture pic) { 
Pixel[] pixels = pic.getPixels(); 
Color color = null; 
int red = 0; 
int green = 0; 
int blue = 0; 
for(int cnt = 0;cnt < pixels.length;cnt++){ 
color = pixels[cnt].getColor(); 
//Apply a red tint to all non-green pixels 
if(! (color.equals(Color.GREEN) )) { 
//Increase the value of the red component 
red = color.getRed(); 
if (red*1.25 < 255){ 
red = (int) (red * 1.25); 
}else{ 
red = 255; 
}//end else 
//Decrease the value of blue and green 


green = (Anthbrobeteset arek tÀ Rltp://cnx.org/content/co111441/1.181> 
blue = (int) (color.getBlue()*0.8); 


//Apply the new color to the pixel. 
pixels[cnt].setColor(new Color(red,green,blue)): 


835 


Table 3.347 
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i) World Running... 


Ed 
Sane : 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


837 


ie) World Running... 


x| 
Si 
Take Picture 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


838 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Image 1 . Prob04a.bmp. 
(| World Running... 


X| 
Sine 


Table 3.348 
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r3 Word Running... 
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r3 World Running... 
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Image 2 . Prob04b.bmp. 


ie) World Running... 
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Table 3.349 
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Image 3 . Prob04c.jpg. 
(| World Running... 


— 


x| 
Take Picture 


Table 3.350 
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Image 4 . Possible output image. 
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Image 5 . Possible output image. 
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Answer 1 (p. 861) 


3.3.29.4 Images 


Image 1 (p. 843) . Prob04a.bmp. 
Image 2 (p. 847) . Prob04b.bmp. 

. 851) . Prob04c.jpg. 
Image 4 (p. 855) . Possible output image. 
Image 5 (p. 859) . Possible output image. 
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3.3.29.5 Listings 
e Listing 1 (p. 839) . Question 1. 
What is the meaning of the following two images? 
This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 


The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None KEX] 


Display your nami 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


3.3.29.6 Answers 
3.3.29.6.1 Answer 1 


The code in Listing 1 (p. 839) produces the output image shown in Image 4 (p. 855) . 
Back to Question 1 (p. 838) 


3.3.29.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3018r Review 
e File: Java3018r.htm 

e Published: 02/17/13 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.30 Java3018s Slides” 
3.3.30.1 Table of Contents 


e Instructions for viewing slides (p. 862) 
e Miscellaneous (p. 862) 


3.3.30.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3018: Darkening, Brightening, and Tinting 
the Colors in a Picture ??° . 

Click here 72° to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.30.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3018s Slides 
e File: Java3018s.htm 
e Published: 01/06/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 


228 This content is available online at <http://cnx.org/content /m45636/1.2/>. 
22°http://cnx.org/content /m44234 
30http://cnx.org/content /m45636/latest /a0-Index.htm 
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a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.31 Java3020: Interfaces, Object Arrays, etc.” 
3.3.31.1 Table of Contents 


e Preface (p. 863) 
Viewing tip (p. 863) 

x Images (p. 863) 

x Listings (p. 863) 
Preview (p. 864) 
General background information (p. 865) 
Discussion and sample code (p. 865) 
Run the program (p. 874) 
Summary (p. 875) 
What’s next? (p. 875) 
Online video links (p. 875) 
Miscellaneous (p. 875) 
Complete program listing (p. 876) 


3.3.31.2 Preface 

This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

3.3.31.2.1 Viewing tip 

I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 
3.3.31.2.1.1 Images 


e Image 1 (p. 864) . Command line output for Prob05. 


3.3.31.2.1.2 Listings 


Listing 1 (p. 865 
Listing 2 (p. 866 
Listing 3 (p. 86 
Listing 4 (p. 86 
Listing 5 (p. 868 

( 

( 

( 


) . Beginning of driver class for Prob05. 
) . The interface named Prob05X. 
) . Beginning of the class named Prob05MyClassA. 
) . The method named getModifiedData. 
) . The method named getData. 

Listing 6 (p. 868) . Overridden toString method. 

Listing 7 (p. 869) . Beginning of the class named Prob05MyClassB. 
Listing 8 (p. 870) . The method named getModifiedData. 


231 This content is available online at <http://cnx.org/content /m44214/1.6/>. 
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Listing 9 (p. 870) . The getData and toString methods. 
Listing 10 (p. 872) . Print three items of information. 
Listing 11 (p. 873) . Three more print statements. 

Listing 12 (p. 873) . Print the references to the two objects. 
Listing 13 (p. 877) . Complete program listing 


). 
JE 
Ve 
Jia 


3.3.31.3 Preview 
In this module, you will learn about : 


Interface definitions 

Implementing an interface in a class definition 

Defining interface methods in a class definition 

Storing references to new objects in elements of an array of type Object 
Casting elements to an interface type in order to call interface methods 
Parameterized constructors 

Overridden toString method 


Program specifications 


859 


Write a program named Prob05 that uses the class definition shown in Listing 1 (p. 865) to produce 


the output shown in Image 1 (p. 864) on the command line screen. 


Image 1 . Command line output for Prob05. 


Prob05 
Put your first name here 
Put your last name here 


-18 -17 -16 
-17 -17 -17 
-12 -12 -12 


Table 3.353 


No graphic output images required 


There are no graphic output images required by this program. Therefore, it can be compiled and executed 


without a requirement to have Ericson’s media library on the classpath. 
Required text output 


The output, which appears on the command line screen, consists of the six lines of text shown in Image 


1 (p. 864) . 


Because the program generates random data for testing, the actual values will differ from one run to the 


next. However, in all cases: 


e The values in the first row of numbers will be a sequence of consecutive integers in increasing algebraic 


order from left to right. 


e All three values in the second row of numbers will match the value of the center number in the first 


row of numbers. 


e All three values in the third row of numbers will be algebraically five greater than the values in the 


second row of numbers. 


New classes 


You may define new classes as necessary to cause your program to behave as required, but you may not 


modify the class definition for the class named Prob05 shown in Listing 1 (p. 865) . 
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3.3.31.4 General background information 


Among other things, this program illustrates: 


Interface definitions 

Implementing an interface in a class definition 

Defining interface methods in a class definition 

Storing references to new objects in elements of an array of type Object 
Casting elements to an interface type in order to call interface methods 
Parameterized constructors 

Overridden toString method 


3.3.31.5 Discussion and sample code 


Will explain in fragments 

I will explain this program in fragments. A complete listing of the program is provided in Listing 13 (p. 
877) near the end of the module. 

Beginning of driver class for Prob05 

The driver class for Prob05 begins in Listing 1 (p. 865) . 


Listing 1 . Beginning of driver class for Prob05. 


import java.util.*; 


class Prob05{ 
public static void main(String[] args){ 


Random generator = new Random(new Date().getTime()); 
int randomData = (byte)generator.nextInt(); 


Object[] vari = new Object[2]; 


var1[0] 
vari[1] 


new Prob05MyClassA(randomData) ; 
new ProbO5MyClassB(randomData) ; 


Table 3.354 


Behavior of the code in Listing 1 
Listing 1 (p. 865) does the following: 


Gets and saves a random value of type int 
Instantiates a new two-element array object of type Object . (A reference to any object of any 
class or interface type can be stored in an array element of type Object .) 

e Populates the array object with references to objects of the classes: 


Prob05MyClassA 
Prob05MyClassB 


The same random value is passed to the constructor for both objects when they are instantiated. 
Put the driver class on temporary hold 
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At this point, I am going to put the driver class named Prob05 on temporary hold and explain the 
class named Prob05MyClassA 

The interface named Prob05X 

Having glanced ahead, I know that the class named Prob05MyClassA implements the interface 
named Prob05X_ so I will explain that interface first. 

The interface named Prob05X is shown in its entirety in Listing 2 (p. 866) . 


Listing 2 . The interface named Prob05X. 


interface ProbO5x{ 
public int getModifiedData(); 
public int getData(); 
}//end interface 


Table 3.355 


An interface definition 
An interface definition can contain only two kinds of members: 


e Constants 
e Method declarations 


By now, you should have studied interfaces in my online tutorials. Therefore, this explanation will be very 
brief. 

Method declarations 

Listing 2 (p. 866) contains two method declarations. 

A method declaration does not have a body. Its purpose is to establish the programming interface for 
that method in any class that implements the interface (return type, name, arguments, etc.) 

A method declaration provides no information about the behavior of the method. 

A method declaration in an interface is implicitly abstract. 

A concrete definition is required 

Any class that implements an interface: 


e Must provide a concrete version of every method that is declared in the interface, or 
e The class must be declared abstract . (In this case, abstract essentially means incomplete.) 


The class named Prob05MyClassA 
The class named Prob05MyClassA_, which implements the interface named Prob05X , must 
provide concrete versions of the methods named: 


e public int getModifiedData() 
e public int getData() 


Beginning of the class named Prob05MyClassA 
The class named Prob05MyClassA_ begins in Listing 3 (p. 867) . 
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Listing 3 . Beginning of the class named Prob05MyClassA. 


class ProbO5MyClassA implements ProbO5x{ 
private int data;//instance variable 


ProbO5MyClassA(int inData){//constructor 
System. out.println("Prob05") ; 
System.out.println("Put your first name here"); 
data = inData; 

}//end constructor 


Table 3.356 


This class implements the interface named Prob05X 

A private instance variable 

Listing 3 (p. 867) begins by declaring a private instance variable of type int named data . Asa 
private instance variable, it is accessible by any method or constructor defined within the class but is not 
accessible to methods from outside the class. 

The constructor 

The constructor for the class is shown in its entirety in Listing 3 (p. 867) . 

The constructor begins by displaying the problem number and the student’s first name on the command 
line screen. 

Then it assigns the value of the incoming parameter named inData to the variable named data 
This makes that value available to the methods that are defined within the class. 

The method named getModifiedData 

We learned earlier 7°? that the class named Prob05MyClassA 


e must provide a concrete definition of the method named getModifiedData , 
e because that method is declared in the interface named Prob05X 
e which is implemented by the class. 


b 


With the exception of some very subtle differences (that are beyond the scope of this course) , that concrete 
definition must match the signature of the declared method. 

Code for the method named getModifiedData 

The method named getModifiedData is shown in its entirety in Listing 4 (p. 867) . 

When this method is called, it 


e subtracts a value of 1 from the value stored in the instance variable named data , and 


e returns that modified value. 


3 


Listing 4 . The method named getModifiedData. 


public int getModifiedData(){ 
return data - 1; 
}//end getModifiedData() 


232http://cnx.org/content /m44214/latest /Java30200ld.htm#concrete 
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Table 3.357 


The method named getData 
We also learned earlier that the class named Prob05MyClassA 


e must provide a concrete definition of the method named getData, 
e which is also declared in the interface named Prob05X 


Code for the method named getData 
The method named getData is shown in its entirety in Listing 5 (p. 868) . 
This method returns a copy of the value stored in the variable named data 


Listing 5 . The method named getData. 


public int getData(){ 
return data; 
}//end getData() 


Table 3.358 


A round trip 

When the code in Listing 1 (p. 865) instantiates an object of the Prob05MyClassA class, it passes 
a random value as a parameter to the constructor. 

The constructor shown in Listing 3 (p. 867) stores that random value in the instance variable named 
data 

When the method named getModifiedData is called, it returns a value that is the original random 
value less 1. 

When the method named getData is called, it returns a copy of the original random value. 

The toString method 

The class named Prob05MyClassA extends the class named Object by default. It inherits a method 
named toString from the class named Object . The inherited method has very specific behavior. 

Overridden toString method 

The code in Listing 6 (p. 868) overrides the inherited method to provide a different behavior when the 
method is executed in conjunction with an object of the Prob05MyClassA class. 

The new behavior is to construct and return a string version of the value obtained by adding 5 to the 
value stored in data , which is the original random value. 


Listing 6 . Overridden toString method. 


public String toString(){ 
return "" + (data + 5); 
}//end toString() 


}//end class ProbO5MyClassA 


Table 3.359 
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The end of the class named Prob05MyClassA 

Listing 6 (p. 868) also signals the end of the class definition for the class named Prob05MyClassA . 

The class named Prob05MyClassB 

Referring back to the code in the driver class in Listing 1 (p. 865) , we see that the driver also instantiates 
an object of the class named Prob05MyClassB , passing the same random value to the constructor for 
the class. 

The reference to the object is stored in the second element of the array object of type Object referred 
to by the reference variable named var1 

Beginning of the class named Prob05MyClassB 

The beginning of the class named Prob05MyClassB. is shown in Listing 7 (p. 869) . 


Listing 7 . Beginning of the class named Prob05MyClassB. 


class ProbO5MyClassB implements Prob05X{ 
private int data; 


ProbO5MyClassB(int inData){ 
System.out.println("Put your last name here"); 
data = inData; 

3//end constructor 


Table 3.360 


Implements Prob05X 

The first thing we notice is that this class also implements the interface named Prob05X_ . This requires 
that the class provide concrete definitions of the two methods declared in that interface. 

Save the incoming parameter value 

The constructor for the Prob05MyClassB class, which is shown in Listing 7 (p. 869) , saves the 
incoming parameter value in a private instance variable named data . 

Unrelated to the variable named data from before 

It is important to note that this variable named data is completely unrelated to the private instance 
variable named data that is declared in Listing 3 (p. 867) , even though they are the same type and they 
have the same name. 

They belong to two different objects. Objects do not share instance variables. 

The two objects are related 

However, even though the two objects instantiated in Listing 1 (p. 865) are instantiated from different 
classes, they are related in the sense that they have two ancestors in common. They both extend the class 
named Object by default and they both explicitly implement the interface named Prob05X_ . That 
means that they can both be treated as either type Object or type Prob05X 

Related through the interface by design 

Because all classes are direct or indirect subclasses of the class named Object , all objects instantiated 
for any class are related at the Object level. However, the objects in this program are related through the 
Prob05X_ interface only because I designed the program that way. 

The method named getModifiedData 

The method named getModifiedData is shown in Listing 8 (p. 870) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


865 


Listing 8 . The method named getModifiedData. 


public int getModifiedData(){ 
return data + 1; 
}//end getModifiedData() 


Table 3.361 


Same behavior is not required 

A comparison of Listing 8 (p. 870) with Listing 4 (p. 867) exposes a very important aspect of interface 
implementation. 

If two different classes implement the same interface, they each must provide concrete definitions of all 
the method declared in the interface. When providing such concrete definitions, both classes must match 
the method signatures of the declared methods. 

However, the behavior of a method as defined in one class is not required to be the same as the behavior 
of the method having the same signature in the other class. 

The behavior is different 

For example, the code in Listing 4 (p. 867) subtracts 1 from the value of data and returns that 
modified value. 

The code in Listing 8 (p. 870) adds 1 to the value of data and returns that modified value. 

Therefore, the behavior of the method named getModifiedData in an object instantiated from the 
class named Prob05MyClassB is completely different from the behavior of the method having the same 
signature in an object of the class named ProbO5MyClassA . 

The getData and toString methods 

Listing 9 (p. 870) shows the getData and toString methods as defined in the class named 

Prob05MyClassB 


Listing 9 . The getData and toString methods. 


public int getData(){ 
return data; 
}//end getData() 


public String toString(){ 
return "" + (data + 5); 


}//end toString() 


}//end class Prob05MyClassB 


Table 3.362 


The behavior is the same 

If you compare Listing 9 (p. 870) with Listing 5 (p. 868) and Listing 6 (p. 868) , you will see that these 
two methods are defined the same in both classes. Therefore, these two methods have the same behavior 
regardless of which of the two objects instantiated in Listing 1 (p. 865) they are called on. 

Back to the driver class named Prob05 

Returning now to the driver class named Prob05 where we left off in Listing 1 (p. 865) , Listing 10 
(p. 872) contains three statements that print information on the command line screen. 
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Listing 10 . Print three items of information. 


System. out.print ( 
((Prob05X) var1[0]).getModifiedData() +" "); 


System.out.print(randomData + " "); 


System. out .print1n( 
((Prob05X) var1[1]) .getModifiedData()); 


Table 3.363 


Three print statements 

The first two statements in Listing 10 (p. 872) call the print method and the last statement. calls the 
println method. 

When the println method is called, the onscreen cursor advances to the left side of the next line after 
the material has been printed. 

However, when the print method is called, the cursor remains at the right end of the printed material. 

Therefore, calling print print println in succession will cause three items of information to be printed 
on the same line. 

A cast is required 

Recall that the reference to each object instantiated in Listing 1 (p. 865) is stored in an array element 
as type Object 

A reference to any object can be stored in a reference of type Object because the Object class is 
the superclass of all classes. (References to array objects can also be stored as type Object but that fact 
is not germane to this program.) 

Only eleven methods can be called on type Object 

However, once an object’s reference is stored as type Object , the only methods that can be called 
on that object (without casting) are the eleven methods that are defined in the Object class. That 
group of eleven methods includes the method named toString but it does not include the methods named 
getData and getModifiedData 

Must change the type of the reference 

Therefore, the first statement in Listing 10 (p. 872) requires that a cast to be used to change the type 
of the reference back to a type on which the method can be called. There are a couple of choices in this 
regard. 

Could cast to the class type 

First, it is always possible to cast the reference back to the class from which the object was instanti- 
ated. Therefore, it would work to cast the reference from array element 0 in Listing 10 (p. 872) to type 
Prob05MyClassA and to cast the reference from array element 1 to type Prob05MyClassB 

Cast to the interface type 

In this program, there is another choice. Because both classes implement the interface named Prob05X 
, and the method named getModifiedData is declared in that interface, it also works to cast both 
references to the common interface type Prob05X 

That is what was done in Listing 10 (p. 872) . Both references were cast to the interface type Prob05X 


The printed values 

The first statement in Listing 10 (p. 872) calls the method named getModifiedData as defined in 
Listing 4 (p. 867) . This causes the original random value less 1 to be printed. 

The second statement in Listing 10 (p. 872) simply prints the original random value that was saved in 
the variable named randomData in Listing 1 (p. 865) . 
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The third statement in Listing 10 (p. 872) calls the method named getModifiedData as defined in 
Listing 8 (p. 870) . This causes the original random value plus 1 to be printed. 

Because this is a call to the println method, the onscreen cursor advances to the left side of the next 
line after the value is printed. 

The three statements in Listing 10 (p. 872) cause the first three values shown in Image 1 (p. 864) to be 
printed on the command line screen. 

Three more print statements 

Continuing with the driver class named Prob05 , Listing 11 (p. 873) shows three more print statements. 


Listing 11 . Three more print statements. 


System. out.print (((Prob05X) var1[0]).getData() + " "); 
System.out.print(randomData + " "); 
System. out .println(((Prob05X) var1[1]).getData()); 


Table 3.364 


A cast is required 

In this case, the getData method belonging to each of the objects is called in the first and third 
statements. (Once again a cast is required.) 

Behavior of the getData methods is the same 

Recall that the behavior of the getData method is the same in both objects. It simply returns a copy 
of the original random value that was passed to the constructor when each of the objects was instantiated. 

The three statements in Listing 11 (p. 873) produce the second set of three matching values shown in 
Image 1 (p. 864) . 

These three values match because all three print statements are printing essentially the same value. The 
original random value is printed in the middle statement in Listing 11 (p. 873) . A copy of the original 
random value is printed in the first and third statements. 

Print the references to the two objects 
Things get a little bit more complicated in Listing 12 (p. 873) . 


Listing 12 . Print the references to the two objects. 


System. out.print(((Prob05X)vari[0]) +" "); 
System. out.print (randomData + 5+" "); 
System. out.print1n(((Prob05X)var1i[1])); 


}//end main 
}//end class Prob05 


Table 3.365 


An automatic call to the toString method 

Whenever an object’s reference is passed to either the print method or the printIn method, the first 
thing that happens is that the toString method is called on the reference. The toString method always 
returns a reference to an object of the String class, and it is that string that is printed. 
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Inherited default behavior of the toString method 

As I mentioned earlier, the toString method is defined with default behavior in the Object class. 
Since every class is a subclass of the Object class, every class inherits that method. 

Ifthe toString method is not overridden in a class or in any of the superclasses of a given class and the 

toString method is called on an object of the given class, the default behavior of the toString method 
will occur. 
Can override to change the behavior 

However, any class can override the toString method to produce different behavior and can pass that, 

behavior down the inheritance hierarchy to subclasses of the class that overrides the method. 
The toString method is overridden 

In this program, the toString method is overridden in exactly the same way in both the 
Prob05MyClassB class and the Prob05MyClassB class. (See Listing 6 (p. 868) and Listing 9 
(p. 870) .) Therefore, when the toString method is called on an object of either class, it will return a 
string representation of the value stored in the variable named data plus 5. 

Pass object references to the print and println methods 

The first statement in Listing 12 (p. 873) passes the reference to the object stored in the first element 
of the array to the print method and the third statement passes the reference to the object stored in the 
second element of the array to the println method. 

Execute overridden toString methods and print the returned values 

The print and println methods cause the code in Listing 6 (p. 868) and Listing 9 (p. 870) to be 
executed. In both cases, this code returns a string that represents the original random value plus 5. This is 
the value that is displayed. 

Print the random value plus 5 

The second statement in Listing 12 (p. 873) adds five to the original random number and prints the 
result. These three statements produce the third line of text in Image 1 (p. 864) where all three values are 
the algebraic sum of the original random number plus 5. 

Important - The cast is not required 

Even though the references extracted from the array in the first and third statements in Listing 12 (p. 
873) are cast to the interface type Prob05X_, that cast is unnecessary. 

Because the original definition of the toString method appears in the class named Object , the 
toString method can be called on those objects even while they are being treated as though they are of 
type Object 

Runtime polymorphism 

Furthermore, a very powerful capability of OOP known as runtime polymorphism would cause the over- 
ridden versions of the methods defined in Listing 6 (p. 868) and Listing 9 (p. 870) to be executed instead 
of the default version of the method defined in the Object class. 

The end of the main method 

Listing 12 (p. 873) signals the end of the main method and the end of the class named Prob05 
When the main method has nothing further to do, it terminates causing the program to terminate and 
return control to the operating system. 


3.3.31.6 Run the program 


I encourage you to copy the code from Listing 13 (p. 877) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


3.3.31.7 Summary 


In this module, you learned about : 


e Interface definitions 
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Implementing an interface in a class definition 

Defining interface methods in a class definition 

Storing references to new objects in elements of an array of type Object 
Casting elements to an interface type in order to call interface methods 
Parameterized constructors 

Overridden toString method 


3.3.31.8 What’s next? 


You will learn how to scale images and how to rotate and translate images using the AffineTransform class 
in the next module. 


3.3.31.9 Online video links 
Select the following links to view online video lectures on the material in this module. 


e ITSE 2321 Lecture 10 238 


Part01 234 
Part02 25 
Part03 736 
Part04 237 


3.3.31.10 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java OOP: Interfaces, Object Arrays, etc. 
e File: Java3020.htm 

e Published: 08/02/12 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


233http://www.youtube.com/playlist? list=PL3DB0B7840C943C4C 
34 http://www.youtube.com/watch?v=10R_ Xgo9QEo 
235http://www.youtube.com/watch?v=vNPd6Sd7Wk8 
°36http://www.youtube.com/watch?v=_JFcPromgGk 

237 http://www-youtube.com/watch?v—A 3bgpy5dCtQ 
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3.3.31.11 Complete program listing 


A complete listing of the program discussed in this module is shown in Listing 13 (p. 877) below. 
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Listing 13 . Complete program listing. 


/*File Prob05 Copyright 2008 R.G.Baldwin 
FOSSA IOS GIAO CI SAI GI RII I II I I I ISI A a Kf ak ak ak ka 4 / 


import java.util.*; 


class Prob05{ 
public static void main(String[] args){ 


Random generator = new Random(new Date().getTime()); 
int randomData = (byte)generator.nextInt(); 


Object[] vari = new Object[2]; 


var1[0] 
vari[1] 


new ProbO5MyClassA(randomData) ; 
new Prob05MyClassB(randomData) ; 


System. out.print ( 

((Prob05X) vari[0]).getModifiedData() + " "); 
System.out.print(randomData + " "); 
System. out .print1n( 

((Prob05X) vari[1]) .getModifiedData()); 


System. out.print(((Prob05X)var1[0]).getData() + " "); 
System.out.print(randomData + " "); 
System. out .printin(((Prob05X)var1[1]).getData()); 


System. out.print(((Prob05X)vari[0]) +" "); 
System. out . print (randomData + 5+" "); 
System. out.print1n(((Prob05X)var1i[1])); 


}//end main 
}//end class Prob05 


interface Prob05X{ 
public int getModifiedData(); 
public int getData(); 

}//end interface 


class Prob05MyClassA implements Prob05X{ 
private int data; 


Prob05MyClassA(int inData){ 
System. out .println("Prob05"); 
System. out .println("Put your first name here"); 
data = inData; 

}//end constructor 


ETA G ilabl fi Cc i http: : tent/col11441/1.181 
public int E a e fee rt onnexions <http://cnx.org/content/co / > 


return data - 1; 
}//end getModifiedData() 
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Table 3.366 


-end- 


3.3.32 Java3020s Slides”? 
3.3.32.1 Table of Contents 


e Instructions for viewing slides (p. 878) 
e Miscellaneous (p. 878) 


3.3.32.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3020: Interfaces, Object Arrays, etc. 729 


Click here 74° to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.32.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3020s Slides 
e File: Java3020s.htm 
e Published: 01/06/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


238 This content is available online at <http://cnx.org/content /m45632/1.2/>. 
39 http://cnx.org/content /m44214 
240http://cnx.org/content /m45632/latest /a0-Index.htm 
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3.3.33 Java3022: Scaling, Rotating, and Translating Images using Affine 
Transforms” 


3.3.33.1 Table of Contents 


e Preface (p. 879) 
Viewing tip (p. 879) 

x Images (p. 879) 

x Listings (p. 879) 
Preview (p. 880) 
General background information (p. 891) 
Discussion and sample code (p. 891) 
Run the program (p. 898) 
Summary (p. 898) 
What’s next? (p. 898) 
Online video link (p. 898) 
Miscellaneous (p. 898) 
Complete program listing (p. 899) 


3.3.33.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 74? . 


3.3.33.2.1 Viewing tip 
I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.3.33.2.1.1 Images 


Image 1 (p. 882) . Input file named Prob01.jpg. 
Image 2 (p. 886) . First output image. 

Image 3 (p. 890) . Second output image. 

Image 4 (p. 891) . Required output text. 


3.3.33.2.1.2 Listings 


) . The driver class named Prob01. 
Listing 2 ( ) . Beginning of the class named Prob01Runner. 
Listing 3 ( ) . The run method. 
Listing 4 (p. 893) . Beginning of the method named rotatePicture. 
Listing 5 (p. 895) . Compute the dimensions of the new Picture object. 
( ) 
( ) 
( 


Listing 1 (p. 891 
P 

p. 892 
Listing 6 (p. 895) . Prepare the translation transform. 


Listing 7 (p. 896) . Concatenate the transforms. 
Listing 8 (p. 896) . Instantiate the new Picture object . 


241 This content is available online at <http://cnx.org/content /m44223/1.7/>. 
42 http://cnx.org/content /m44148/latest / 
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e Listing 9 (p. 897) . Perform the concatenated transform. 
e Listing 10 (p. 900) . Complete program listing. 


3.3.33.3 Preview 


In this module, you will learn how to scale images and how to rotate and translate images using the 
AffineTransform class. 

Program specifications 

Write a program named ProbO1 that uses the class definition shown in Listing 1 (p. 891) and Ericson’s 
media library along with the image file named Prob01.jpg (see Image 1 (p. 882) ) to produce the output 
images shown in Image 2 (p. 886) and Image 3 (p. 890) . 
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Image 1 . Input file named Prob01.jpg. 


Table 3.367 
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| ProbO1.jpg 


R: 3G. 1B: 2 Color at location: 


| Dispiäyou name here 2 
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| Probūl.jpg 


R: 3 G1 B: 2 Color at location: 


i Display your name here. . pT 
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| Probūl.jpg 


R: 3 G1 B: 2 Color at location: 


| Dispiäyou name here 2 
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Image 2 . First output image. 


ProbO1.jpg 


R: 3 G 1B: 2 Color at location: 


| Displäyyoür name here. 


Table 3.368 
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Image 3 . Second output image. 


Table 3.369 


Scale and rotate 
The image from the file named Prob01.jpg must be scaled and then rotated 30 degrees clockwise. A 
scale factor of 0.95 must be applied to the horizontal and a scale factor of 0.9 must be applied to the vertical. 
New classes 
You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named Prob01 shown in Listing 1 (p. 891) . 
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Required output text 
In addition to the two output images mentioned above, your program must display your name and the 
other line of text shown in Image 4 (p. 891) on the command-line screen. 


Image 4 . Required output text. 


Display your name here. 
Picture, filename None height 360 width 394 


Table 3.370 


3.3.33.4 General background information 


Writing the code from scratch to rotate an image can be a daunting task. However, the task is made much 
easier through the use of the standard AffineTransform class, which is included in the standard Java 
library. 

The AffineTransform class can also be used to scale and translate images. 


3.3.33.5 Discussion and sample code 


Will discuss in fragments 

I will discuss and explain this program in fragments. A complete listing of the program is provided in 
Listing 10 (p. 900) near the end of the module. 

The driver class named Prob01 

The driver class containing the main method is shown in Listing 1 (p. 891) . 


Listing 1 . The driver class named Prob01. 


import java.awt.Graphics2D; 
import java.awt.geom.AffineTransform; 
import java.awt.geom.Rectangle2D; 
import java.awt.Graphics; 


public class Prob01{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new Prob0iRunner().run(); 
}//end main method 
}//end class Prob01 


Table 3.371 


Instantiate a new object and call its run method 

As has been the case in several earlier modules, the code in the main method instantiates a new object 
of the class named Prob01Runner and calls the run method on that object. 

When the run method returns, the main method terminates causing the program to terminate. 

Beginning of the class named Prob01Runner 

The class named Prob0O1Runner begins in Listing 2 (p. 892) . 
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Listing 2 . Beginning of the class named Prob01Runner. 


class Prob01Runner{ 
public Prob01Runner () { 
System.out.println("Display your name here."); 
}//end constructor 


Table 3.372 


Listing 2 (p. 892) shows the constructor for the class, which simply displays the student’s name on the 
command line screen as shown in Image 4 (p. 891) . 

The run method 

The run method, which is called in Listing 1 (p. 891) , is shown in its entirety in Listing 3 (p. 892) . 


Listing 3 . The run method. 


public void run(){ 
Picture pic = new Picture("Prob01.jpg") ; 
//Add your name and display the picture. 
pic.addMessage("Display your name here.",10,20); 
pic.explore(); 


pic = pic.scale(0.95,0.9); 
pic = rotatePicture(pic, 30); 


pic.explore(); 
System. out.println(pic); 
3//end run 


Table 3.373 


Mostly familiar code 
You are already familiar with all of the code in Listing 3 (p. 892) except for the call to the scale method 
and the call to the rotatePicture method. 
The scale method 
The scale method is part of Ericson’s library. However, it is not included in the library on the CD in 
the back of my copy of her textbook. It is included in the zip files containing later versions, which can be 
downloaded from Ericson’s website. (See Java OOP: The Guzdial-Ericson Multimedia Class Library °% 
) 
The scale method is straightforward 
When the scale method is called on a Picture object, it creates and returns a reference to a new 
Picture object that is a scaled version of the original. 
Parameters 
The scale method requires two parameters of type double . The first parameter is the scale factor 
that is applied to the horizontal dimension of the picture. The second parameter is the scale factor that. is 
applied to the vertical dimension of the picture. 


43 http://cnx.org/content /m44148/latest / 
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Replace original picture with scaled picture 

The reference to the new Picture object returned by the scale method in Listing 3 (p. 892) is stored 
in the variable named pic overwriting the reference to the original Picture object. From this point 
forward, all operations are performed on the scaled version of the original picture. 

Beginning of the method named rotatePicture 

The method named rotatePicture begins in Listing 4 (p. 893) . 


Listing 4 . Beginning of the method named rotatePicture. 


private Picture rotatePicture(Picture pic,double angle) { 


//Prepare the rotation transform 
AffineTransform rotateTransform = 
new AffineTransform() ; 
rotateTransform.rotate (Math. toRadians(angle) , 
pic.getWidth()/2, 
pic.getHeight ()/2); 


Table 3.374 


Rotate and translate 

The rotatePicture method accepts a reference to a Picture object along with a rotation angle in 
degrees. 

It creates and returns anew Picture object that is of the correct size, containing the rotated version 
of the image as shown in Image 3 (p. 890) . 

The incoming image is rotated around its center by the specified rotation angle. Then it is translated to 
and drawn in the center of the new Picture object. 

Affine transforms 

The rotatePicture method uses affine transforms to rotate and translate the image. Affine transforms 
can also be used to scale images, but it is easier to scale images using Ericson’s scale method. 

However, the lack of complexity of the scale method is easily made up for by the complexity of affine 
transforms. 

Google me 

I have published several tutorials discussing and explaining the use of the AffineTransform class in 
Java. You can locate those modules by going to Google and searching for the following keywords: 
richard baldwin affine transform 
The AffineTransform class 
The AffineTransform class is part of the standard Java library. Here is part of what the documentation 
244 has to say about the class: 

"The AffineTransform class represents a 2D affine transform that performs a linear mapping from 2D 
coordinates to other 2D coordinates that preserves the "straightness" and "parallelness" of lines. Affine 
transformations can be constructed using sequences of translations, scales, flips, rotations, and shears." 

The ideas behind affine transforms 

One of the ideas behind affine transforms is that you can create an affine transform object and apply it 
to an unlimited number of other objects. This might be useful in a game program, for example, where a 
large number of enemy ships need to be rotated, translated, and scaled in unison. 

Concatenated affine transform objects 


44h ttp://java.sun.com/javase/6/docs/api/java/awt /geom/AffineTransform.html 
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Another idea is that you can create two or more affine transform objects, concatenate them, and apply 
the concatenated transform object to an unlimited number of other objects. 

Application of concatenated transform objects 

Applying a concatenated transform to an object is equivalent to applying one of the transform objects to 
the original object and then applying the other transform objects to the transformed objects in sequential 
fashion. Concatenation of transform objects can result in considerable computational savings in certain 
situations. 

A larger Picture object is required 

Looking back at Image 2 (p. 886) and Image 3 (p. 890) , you can see that the Picture object required 
to contain the rotated image must be larger than the Picture object required to contain the original image. 
You will learn how to compute the dimensions of the larger Picture object later in this module. 

Behavior of the rotatePicture method 

The rotatePicture method performs the following operations: 


e Prepare an AffineTransform object that can be used to rotate the incoming image around its center 
by the specified angle. 
Get the dimensions of a rectangle of sufficient size to contain the rotated image. 
Prepare an AffineTransform object that will translate the rotated image to the center of a new, 
larger Picture object having the dimensions computed above. 
Concatenate the rotation transform object with the translation transform object. 
Create anew Picture object with the dimensions computed above. 
Apply the concatenated transform to the incoming image and draw the transformed image in the new 
Picture object. 

e Return a reference to the new Picture object containing the rotated and translated image. 


Prepare the rotation transform 
Listing 4 (p. 893) begins by instantiating a new object of the AffineTransform class and saving the 
object’s reference in the local reference variable named rotateTransform 
Call an overloaded rotate method 
Then Listing 4 (p. 893) calls one of four overloaded rotate methods on the rotation transform object. 
Three parameters are required 
This version of the rotate method requires three parameters: 


e theta - the angle of rotation measured in radians 
e anchorx - the X coordinate of the rotation anchor point 
e anchory - the Y coordinate of the rotation anchor point 


To make a long story short... 
The rotate method prepares the transform object to rotate an image around the point specified by the 
last two parameters. 
The angle of rotation must be specified in radians. 
Convert from degrees to radians 
Listing 4 calls the static toRadians method of the Math class to convert the rotation angle from 
degrees to radians. The angle in radians is passed as the first parameter (theta) to the rotate method. 
Compute the anchor point 
Then the code in Listing 4 computes the coordinates of the center of the image and passes those coordi- 
nates to the rotate method as anchorx and anchory 
The dimensions of the new Picture object 
How would you compute the dimensions of the new Picture object required to barely contain the 
rotated image shown in Image 3 (p. 890) ? 
The computation of those dimensions is not rocket science, but would certainly require you to know quite 
a lot about dealing with angles and triangles. 
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Fortunately, we don’t have to perform that computation 

Ericson provides a method named getTransformEnclosingRect that will perform that computation 
for us, returning the required dimensions in the form of a reference to a standard Java Rectangle2D 
object. 

Compute the dimensions of the new Picture object 

The code in Listing 5 (p. 895) calls the getTransformEnclosingRect method on the previously 
scaled Picture object passing a reference to the rotation transform object to get the required dimensions 
fora Picture object that will contain the rotated image. 


Listing 5 . Compute the dimensions of the new Picture object. 


Rectangle2D rectangle2D = 
pic. getTransformEnclosingRect (rotateTransform) ; 


int resultWidth = (int) (rectangle2D.getWidth()); 
int resultHeight = (int) (rectangle2D.getHeight()); 


Table 3.375 


The dimensions of the rectangle 

After getting a reference to the rectangle, Listing 5 (p. 895) gets and saves the width and height of 
the rectangle. These values will be used later to instantiate anew Picture object of the same size as the 
rectangle. 

Prepare the translation transform 

Listing 6 (p. 895) prepares a translation transform that can be used to translate the rotated image to 
the center of the new Picture object. 


Listing 6 . Prepare the translation transform. 


AffineTransform translateTransform = 
new AffineTransform() ; 
translateTransform. translate ( 
(resultWidth - pic.getWidth())/2, 
(resultHeight - pic.getHeight())/2); 


Table 3.376 


A new AffineTransform object 

Listing 6 (p. 895) begins by instantiating a new object of the AffineTransform class and saving the 
object’s reference in the local reference variable named translateTransform 

Call the translate method on the transform object 

Then Listing 6 (p. 895) calls the translate method on the AffineTransform object. 

According to the documentation 74° , the required parameters of the translate method are: 


e tx- the distance by which coordinates are translated in the X axis direction 


245 http://java.sun.com/javase/6/docs/api/java/awt /geom/AffineTransform.html#translate%28double,%20double%29 
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e ty - the distance by which coordinates are translated in the Y axis direction 


Compute the translation distance components 
Listing 6 (p. 895) computes the distance from the center of the image to the center of the new Picture 
object and passes the X and Y components of this distance to the translate method. 
Two AffineTransform objects 
At this point, we have two different AffineTransform objects. One is capable of rotating the image 
by a specified angle. The other is capable of translating the image by a specified amount. 
We could apply the two transforms sequentially to the image being careful to rotate before we translate. 
(The order of rotation and translation makes a huge difference.) 
A more computationally economical approach 
The preferred approach is to concatenate the two transform objects and apply only the concatenated 
transform object to the image. This is particularly important if the transforms are going to be applied to a 
large number of images such as in a game program for example. 
Concatenate the transforms 
Listing 7 (p. 896) calls the concatenate method on the translation transform passing a reference to 
the rotation transform as a parameter. This modifies the translation transform in such a way that it can 
be used to rotate the image around its center point and then translate it to the center of the new Picture 
object. 


Listing 7 . Concatenate the transforms. 


translateTransform. concatenate (rotateTransform) ; 


Table 3.377 


Instantiate the new Picture object 
Listing 8 (p. 896) instantiates a new Picture object with the dimensions computed in Listing 5 (p. 
895) . This Picture object will be used to contain and return the rotated image. 


Listing 8 . Instantiate the new Picture object . 


Picture result = new Picture( 
resultWidth,resultHeight) ; 


Table 3.378 
Perform the concatenated transform 


Listing 9 performs the rotation and translation, draws the modified image in the new Picture object, 
and returns a reference to the new Picture object. 
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Listing 9 . Perform the concatenated transform . 


Graphics2D g2 = (Graphics2D)result.getGraphics() ; 
g2.drawlmage (pic. getImage () ,translateTransform,nul1) ; 
return result; 


}//end rotatePicture 
}//end class Prob01Runner 


Table 3.379 


Call the getGraphics method 

Listing 9 (p. 897) begins by calling Ericson’s getGraphics method on the new Picture object and 
casting the returned value to the standard type Graphics2D 

A cast is required 

Ericson’s getGraphics method returns a reference to the graphics context of the Picture object as 
type Graphics . That reference must be cast to type Graphics2D before the drawImage method 
can be called on the reference. 

Call the drawImage method 

Then Listing 9 (p. 897) calls the standard drawImage method on the reference to the graphics context 
passing three parameters to the method. This is one of two overloaded versions of the drawImage method 
defined in the standard Graphics2D class. 

The first parameter 

The first required parameter for this version of the drawImage method is a reference to an object of 
type Image containing the image that is to be drawn. In this case, Ericson’s getImage method is called 
on the Picture object to get the image and pass it as the first parameter. 

The second parameter 

The second required parameter is a reference to an AffineTransform object that is to be applied to 
the image before it is drawn. Our concatenated transform object is passed as the second parameter. 

The third parameter 

The third required parameter is a reference to an object of the standard type ImageObserver or null 
. If you would like to know more about the use of an ImageObserver object, go to Google and search 
for the following keywords: 

richard baldwin java imageobserver 

We don’t need an image observer in this case so Listing 9 (p. 897) passes null for the third parameter. 

When the drawImage method returns 

When the drawImage method returns, the image will have been rotated, translated, and drawn in the 
center of the new Picture object as shown in Image 3 (p. 890) . 

Return a Picture and terminate the method 

Listing 9 (p. 897) returns a reference to the Picture object, (which now contains the rotated image) 
and terminates, returning control to the run method in Listing 3 (p. 892) . 

Return to the run method 

Returning to the run method in Listing 3 (p. 892) , we see that the remaining code in the run 
method: 


e Calls Ericson’s explore method on the returned Picture object producing the screen output shown 
in Image 3 (p. 890) . 

e Passes the returned Picture object tothe printIn method producing the last line of text output 
shown in Image 4 (p. 891) . 
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e Returns control the main method in Listing 1 (p. 891) , causing the program to terminate as soon 
as the user dismisses both images from the screen. 


3.3.33.6 Run the program 


I encourage you to copy the code from Listing 10 (p. 900) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. For example, try reversing the 
order of translation and rotation beginning with Listing 7 (p. 896) . Make certain that you can explain why 
your changes behave as they do. 

Click Prob01.jpg 74° to download the required input image file. 


3.3.33.7 Summary 


You learned how to scale images and how to rotate and translate images using the AffineTransform class. 


3.3.33.8 What’s next? 


In the next module, you will learn how to mirror images both horizontally and vertically. 


3.3.33.9 Online video link 
Select the following link to view an online video lecture on the material in this module. 


e ITSE 2321 Lecture 11 247 


3.3.33.10 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java OOP: Scaling, Rotating, and Translating Images using Affine Transforms 


e File: Java3022.htm 
e Published: 08/02/12 
e Revised:12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


46 http://cnx.org/content /m44223/latest /Prob01.jpg 
247 http://vimeo.com/channels/itse2321/21211960 
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3.3.33.11 Complete program listing 


A complete listing of the program discussed in this module is shown in Listing 10 (p. 900) below. 
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Listing 10 . Complete program listing. 


/*File Prob01 Copyright 2008 R.G.Baldwin 
Revised 12/17/08 
FE AG EEEE EEEE EEE EE EEEE EEE EEEE 21 21 EE 21 21 E EEE E EE EE EE E / 
import java.awt.Graphics2D; 
import java.awt.geom.AffineTransform; 
import java.awt.geom.Rectangle2D; 
import java.awt.Graphics; 


public class Prob01{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new ProbO1Runner().run(); 
}//end main method 
}//end class Prob01 


class Prob01Runner{ 
public Prob01Runner(){ 
System.out.println("Display your name here."); 
}//end constructor 


public void run(){ 
Picture pic = new Picture("Prob01.jpg") ; 
//Add your name and display the picture. 
pic.addMessage("Display your name here.",10,20); 
pic.explore(); 
pic = pic.scale(0.95,0.9); 
pic = rotatePicture(pic, 30); 


pic.explore(); 
System. out.println(pic); 
}//end run 


//This method accepts a reference to a Picture object 

// along with a rotation angle in degrees. It creates 

// and returns a new Picture object that is of the 

// correct size to contain and display the incoming 

// picture after it has been rotated around its center 
// by the specified rotation angle and translated to the 
// center of the new Picture object. 

private Picture rotatePicture(Picture pic,double angle) { 


//Set up the rotation transform 
AffineTransform rotateTransform = 
new AffineTransform() ; 

rotateTransform.rotate (Math. toRadians(angle) , 

pic.getWidth() /2, 

pic.getHeight ()/2); 
//Get the required’ ainenS ions OP a Lect Rife HAE WET OE Ist 
// contain the rotated image. 
Rectangle2D rectangle2D = 
pic. getTransformEnclosingRect (rotateTransform) ; 
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Table 3.380 


-end- 
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3.3.34 Java3022r Review” 
3.3.34.1 Table of Contents 
Preface (p. 902) 
Questions (p. 902) 

1 (p. 902) 


Images (p. 913) 
Listings (p. 913) 
Answers (p. 915) 
Miscellaneous (p. 915) 


3.3.34.2 Preface 


This module contains review questions and answers keyed to the module titled Java3022: Scaling, Rotating, 
and Translating Images using Affine Transforms 74° . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.34.3 Questions 


3.3.34.3.1 Question 1 


Given the input image in Image 1 (p. 905) , which of the following output images is produced by the code 
in Listing 1 (p. 903) ? 

A. Image 2 (p. 909) 

B. Image 3 (p. 913) 


?48This content is available online at <http://cnx.org/content /m45783/1.2/>. 
49http://cnx.org/content /m44223 
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Listing 1 . Question 1. 


/*File Java3022ra Copyright 2013 R.G.Baldwin 

Revised 02/17/13 

FE AA EEEE EEEE EEE IOI I I I I I I A E 21 2k EE 21 21 2k 4 4 24 E EE EE 2 2 E / 
import java.awt.Graphics2D; 

import java.awt.geom.AffineTransform; 

import java.awt.geom.Rectangle2D; 

import java.awt.Graphics; 


public class Java3022raf{ 
public static void main(String[] args){ 
new Java3022raRunner().run(); 
}//end main method 
}//end class Java3022ra 


class Java3022raRunner{ 
public void run(){ 
procPix(new Picture("Prob01.jpg") .scale(0.7,0.7) ,-30); 
}//end run 


private void procPix(Picture pic,double angle){ 


AffineTransform xformA = new AffineTransform(); 
xformA.rotate(Math.toRadians (angle) ,pic.getWidth() /2, 
pic. getHeight ()/2); 


Rectangle2D rectangle2D = 
pic.getTransformEnclosingRect (xformA) ; 

int resultWidth = (int) (rectangle2D.getWidth()); 

int resultHeight = (int) (rectangle2D.getHeight()); 


AffineTransform xformB = new AffineTransform(); 
xformB.translate((resultWidth - pic.getWidth())/2, 
(resultHeight - pic.getHeight())/2); 


xformB.concatenate(xformA) ; 
Picture result = new Picture( 
resultWidth,resultHeight) ; 


Graphics2D g2 = (Graphics2D)result.getGraphics() ; 
g2.drawIlmage(pic.getImage() ,xformB,nul1) ; 
result.explore(); 


}//end 


}//end class Java3022raRunner 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


899 


Table 3.381 
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Image 1 . Prob01.jpg. 


Table 3.382 
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Image 3 . Possible output image. 


Table 3.384 
Answer 1 (p. 915) 


3.3.34.4 Images 


e Image 1 (p. 905) . Prob01.jpg. 
e Image 2 (p. 909) . Possible output image. 
e Image 3 (p. 913) . Possible output image. 


3.3.34.5 Listings 
e Listing 1 (p. 903) . Question 1. 
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What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None KEX] 


Display your name 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


910 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Prob05a.jpg 
Put your name here 


3.3.34.6 Answers 
3.3.34.6.1 Answer 1 


The code in Listing 1 (p. 903) produces the output image shown in Image 3 (p. 913) . 
Back to Question 1 (p. 902) 


3.3.34.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3022r Review 
e File: Java3022r.htm 

e Published: 02/17/13 

e Revised 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.35 Java3022s Slides’” 
3.3.35.1 Table of Contents 


e Instructions for viewing slides (p. 916) 
e Miscellaneous (p. 916) 


3.3.35.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3022: Scaling, Rotating, and Translating 
Images using Affine Transforms 7°! . 

Click here 75? to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.35.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3022s Slides 
e File: Java3022s.htm 
e Published: 01/06/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 


250This content is available online at <http://cnx.org/content /m45639/1.2/>. 
51 http://cnx.org/content /m44223 
252http://cnx.org/content /m45639/latest /a0-Index.htm 
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a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.36 Java3024: Mirroring Images” 
3.3.36.1 Table of Contents 


e Preface (p. 917) 
Viewing tip (p. 917) 

x Images (p. 917) 

x Listings (p. 918) 
Preview (p. 918) 
Discussion and sample code (p. 933) 
Run the program (p. 941) 
Summary (p. 941) 
What’s next? (p. 941) 
Online video link (p. 941) 
Miscellaneous (p. 941) 
Complete program listing (p. 941) 


3.3.36.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 74 . 


3.3.36.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.3.36.2.1.1 Images 


Image 1 (p. 920) . Input file named Prob02a.jpg. 

Image 2 (p. 924) . First output image. 

Image 3 (p. 928) . Second output image. 

Image 4 (p. 932) . Third output image. 

Image 5 (p. 933) . Required output text. 

Image 6 (p. 939) . Picture output from the mirrorUpperQuads method. 


253This content is available online at <http://cnx.org/content /m44228/1.7/>. 
254http://cnx.org/content /m44148/latest / 
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3.3.36.2.1.2 Listings 


. The driver class named Prob02. 


e Listing 1 (p. 933) 

e Listing 2 (p. 934) . Beginning of the class named Prob02Runner. 
e Listing 3 (p. 934) . The run method. 

e Listing 4 (p. 935) . The method named mirrorUpperQuads. 

e Listing 5 (p. 940) . The method named mirrorHoriz. 

e Listing 6 (p. 942) . Complete program listing. 


3.3.36.3 Preview 


In this module, you will learn how to mirror images, both horizontally and vertically. 

Program specifications 

Write a program named Prob02 that uses the class definition shown in Listing 1 (p. 933) and Ericson’s 
media library along with the image file named Prob02a.jpg (shownin Image 1 (p. 920) ) to produce 
the three graphic output images shown in Image 2 (p. 924) , Image 3 (p. 928) , and Image 4 (p. 932) . 
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Image 1 . Input file named Prob02a.jpg. 


Table 3.385 
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| ProbO2a.jpg 


R: 3G. 1 B: 2 Color at location: 


| Dispiäyou name here 2 
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| ProbO2a.jpg 


R: 3G. 1 B: 2 Color at location: 


i Displayiyounmame here > ™ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


918 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


| ProbO2a.jpg 


R: 3G. 1 B: 2 Color at location: 


| Dispiäyou name here 2 
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Image 2 . First output image. 


ProbO0?a.jpa 


R: 3G: 1B: 2 Color at location: 


| Displäyyoür name here. 


Table 3.386 
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Image 3 . Second output image. 


Table 3.387 
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Image 4 . Third output image. 


Table 3.388 


New classes 
You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named Prob02 shown in Listing 1 (p. 933) . 
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Rotate and mirror 

The image from the file named Prob02a.jpg is rotated by 35 degrees. It is not scaled. Then the top-left 
quadrant of the picture containing the rotated image is mirrored into the top-right quadrant. Following this, 
the top half of the picture is mirrored into the bottom half. 

Required output text 

In addition to the three output images mentioned above, your program must display your name and the 
other line of text shown in Image 5 (p. 933) on the command-line screen 


Image 5 . Required output text. 


Display your name here. 
Picture, filename None height 404 width 425 


Table 3.389 


3.3.36.4 Discussion and sample code 


Will discuss in fragments 

I will discuss and explain this program in fragments. A complete listing of the program is provided in 
Listing 6 (p. 942) near the end of the module. 

The driver class named Prob02 


The driver class containing the main method is shown in Listing 1 (p. 933) . 


Listing 1 . The driver class named Prob02. 


public class Prob02{ 
public static void main(String[] args){ 
new ProbO2Runner().run(); 
}//end main method 
}//end class Prob02 


Table 3.390 


Instantiate a new object and call its run method 

The code in the main method instantiates a new object of the class named Prob0O2Runner and 
calls the run method on that object. 

When the run method returns, the main method terminates causing the program to terminate. 

Beginning of the class named Prob02Runner 

The beginning of the class named Prob02Runner , including the constructor, is shown in Listing 2 
(p. 934) . 
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Listing 2 . Beginning of the class named Prob02Runner. 


class Prob02Runner{ 
public Prob02Runner () { 
System.out.println("Display your name here."); 
}//end constructor 


Table 3.391 


The constructor displays the student’s name, producing the first line of output text shown in Image 5 
(p. 933) . 

The run method 

The run method that is called in Listing 1 (p. 933) is shown in its entirety in Listing 3 (p. 934) . 


Listing 3 . The run method. 


public void run(){ 
Picture pix = new Picture("Prob02a. jpg"); 
//Add your name and display the output picture. 
pix.addMessage("Display your name here.",10,20); 
//Display the input picture. 
pix.explore(); 


pix = rotatePicture(pix, 35); 
pix.explore(); 


pix = mirrorUpperQuads (pix); 

pix = mirrorHoriz (pix); 

pix.explore(); 

System. out .println(pix); 
3//end run 


Table 3.392 


Very familiar code 

Except for the calls to the methods named mirrorUpperQuads and mirrorHoriz in Listing 3 (p. 
934) , you should already be familiar with all of the code in Listing 3. 

The rotatePicture method 

For example, the call to the method named rotatePicture is essentially the same as code that I 
explained in an earlier module. Therefore, I won’t explain that method again in this module. You will find 
the code for the method named rotatePicture in Listing 6 (p. 942) near the end of the module. 

Operate on the picture with the rotated image 

The original picture is replaced by a picture containing the rotated image shown in Image 3 (p. 928) . 
From this point forward, all operations are performed on the Picture object containing the rotated image. 

The method named mirrorUpperQuads 

The method named mirrorUpperQuads that is called in the run method in Listing 3 (p. 934) is 
shown in Listing 4 (p. 935) . 
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Behavior of the method named mirrorUpperQuads 
This method mirrors the upper-left quadrant of a picture into the upper-right quadrant as shown in 
Image 6 (p. 939) . 


Listing 4 . The method named mirrorUpperQuads. 


private Picture mirrorUpperQuads(Picture pix) { 


Pixel leftPixel = null; 

Pixel rightPixel = null; 

int midpoint = pix.getWidth()/2; 
int width = pix.getWidth(); 


for(int row = O;row < pix.getHeight()/2;rowt+){ 
for(int col = 0;col < midpoint;col++){ 
leftPixel = pix.getPixel(col,row) ; 
rightPixel = 
pix.getPixel (width-1-col, row) ; 
rightPixel.setColor(leftPixel.getColor()); 
}//end inner loop 
}//end outer loop 


return pix; 
}//end mirrorUpperQuads 


Table 3.393 


Declare four working variables 

Listing 4 (p. 935) begins by declaring and initializing four working variables. The purpose of these 
variables should be obvious on the basis of their names and their initialization expressions. 

Copy the pixel colors 

Then Listing 4 (p. 935) uses a double nested for loop to copy the colors from the pixels in the upper-left 
quadrant into the pixels in the upper-right quadrant. This is done in such a way as to form a mirror image 
about the center point as shown in Image 6 (p. 939) . 

The outer loop 

The outer loop iterates on the rows of pixels in the top half of the image. Only the top half of the image 
is processed in this method because the top half will be mirrored into the bottom half later on. 

The inner loop 

The inner loop iterates on the columns in the left half of the image, copying pixel colors from the left 
half into the pixels in the right half. 

Destruction of pixel colors 

The colors in the pixels in the upper-right quadrant are overwritten by this method. 

In effect, this method and the one following it destroys all of the pixel colors originally in the right half 
of the picture of the rotated image and all of the pixel colors originally in the bottom half of the picture. 

The final picture shown in Listing 4 (p. 935) contains only pixel from the upper-left quadrant of the 
picture with the rotated image. 

Return a modified Picture object 

Finally, the code in Listing 4 (p. 935) returns the modified Picture object to the run method in 
Listing 3 (p. 934) . 
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At this point, the picture with the rotated image is replaced by the version of the picture returned by 
the mirrorUpperQuads method. 
Picture output from the mirrorUpperQuads method 


(p. 939) . 
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Image 6 . Picture output from the mirrorUpperQuads method. 


Table 3.394 


The upper-left quadrant has been mirrored 
As you can see from Image 6 (p. 939) , at this point in the process, the upper-left quadrant has been 
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mirrored into the upper-right quadrant, but the bottom half of the picture is undisturbed. It’s time to do 
something about that. 

Call the mirrorHoriz method 

The next statement in the run method in Listing 3 (p. 934) is a call to the mirrorHoriz method 
passing the picture shown in Image 6 (p. 939) as a parameter. 

The method named mirrorHoriz 

The method named mirrorHoriz is shown in Listing 5 (p. 940) . This method mirrors the top half of 
a picture into the bottom half of the same picture. It will be used to mirror the top half of the picture in 
Image 6 (p. 939) into the bottom half. 


Listing 5 . The method named mirrorHoriz. 


private Picture mirrorHoriz(Picture pix){ 


Pixel topPixel = null; 

Pixel bottomPixel = null; 

int midpoint = pix.getHeight()/2; 
int height = pix.getHeight(); 


for(int col = 0;col < pix.getWidth() ;col++){ 
for(int row = O;row < midpoint;rowt+){ 
topPixel = pix.getPixel(col,row) ; 
bottomPixel = 
pix.getPixel(col,height-1-row) ; 
bottomPixel .setColor (topPixel.getColor()); 
}//end inner loop 
}//end outer loop 


return pix; 
}//end mirrorHoriz method 


}//end class Prob02Runner 


Table 3.395 


Very similar to the mirrorUpperQuads method 
This method is very similar to the previous method named mirrorUpperQuads 
Four working variables and a nested for loop 
As before, Listing 5 (p. 940) declares and initializes four working variables. These variables are used in 
a nested for loop to copy pixel colors from the top half of the picture into the pixels in the bottom half. 
The outer and inner loops 
In this case, the outer loop iterates on all of the columns going from left to right. 
The inner loop iterates on rows, from the top row to the vertical midpoint, copying the colors from the 
pixels from the top half into the pixels in the bottom half. 
The end of the class 
Listing 5 (p. 940) also signals the end of the class named Prob02Runner and the end of the program. 
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3.3.36.5 Run the program 


I encourage you to copy the code from Listing 6 (p. 942) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 

Click Prob02a.jpg ?55 to download the required input image file for this program. 


3.3.36.6 Summary 


You learned how to mirror images both horizontally and vertically. 


3.3.36.7 What’s next? 


In the next module, you will learn to use a variety of Java2D classes including Gradient Paint. 


3.3.36.8 Online video link 


Select the following link to view an online video lecture on the material in this module. 


e ITSE 2321 Lecture 12 756 


3.3.36.9 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java OOP: Mirroring Images 
e File: Java3024.htm 

e Published: 08/04/12 

e Revised: 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.3.36.10 Complete program listing 


A complete listing of the program discussed in this module is shown in Listing 6 (p. 942) below. 


255http://cnx.org/content /m44228 /latest /Prob02a.jpg 
2°Shttp://vimeo.com/channels/itse2321/21217708 
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Listing 6 . Complete program listing. 


/*File Prob02 Copyright 2008 R.G.Baldwin 
FAG EEEE EEEE EEE ICAI AI I I IG GI I A 1 21k EE 21 21 E 4 2 E EE 4 2k EE E / 
import java.awt.Graphics2D; 
import java.awt.geom.AffineTransform; 
import java.awt.geom.Rectangle2D; 
import java.awt.Graphics; 


public class Prob02{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new ProbO2Runner().run(); 
}//end main method 
}//end class Prob02 


class Prob02Runner{ 
public Prob02Runner () { 
System.out.println("Display your name here."); 
}//end constructor 


public void run(){ 
Picture pix = new Picture("Prob02a. jpg"); 
//Add your name and display the output picture. 
pix.addMessage("Display your name here.",10,20); 
//Display the input picture. 
pix.explore(); 


pix = rotatePicture (pix, 35); 
pix.explore(); 


pix = mirrorUpperQuads (pix); 

pix = mirrorHoriz (pix); 

pix.explore(); 

System. out.println(pix); 
3//end run 


private Picture rotatePicture(Picture pix, 
double angle) { 


//Set up the rotation transform 
AffineTransform rotateTransform = 
new AffineTransform() ; 
rotateTransform.rotate (Math. toRadians(angle) , 
pix.getWidth() /2, 
pix.getHeight ()/2); 


//Get the required dimensions of a rectangle that will 

// contain the ene er 

Rectang] e2D Raib for fc C http: tent /coll1441/1.181 
pix.get liebe for ge af Conne gut é STE SE fontent/co pe 

int resultWidth = Se 

int resultHeight = (int) (rectangle2D.getHeight()); 
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Table 3.396 


-end- 
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3.3.37 Java3024r Review” 
3.3.37.1 Table of Contents 
e Preface (p. 944) 
e Questions (p. 944) 
1 (p. 944) 


Images (p. 956) 
Listings (p. 956) 
Answers (p. 957) 
Miscellaneous (p. 957) 


3.3.37.2 Preface 


This module contains review questions and answers keyed to the module titled Java3024: Mirroring Images 
258 


The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.37.3 Questions 


3.3.37.3.1 Question 1 


Given the input image shown in Image 1 (p. 947) , which of the following output images is produced by the 
code in Listing 1 (p. 945) ? 

A. Image 2 (p. 951) 

B. Image 3 (p. 955) 


257This content is available online at <http://cnx.org/content/m45784/1.2/>. 
>8http://cnx.org/content /m44228 
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Listing 1 . Question 1. 


/*File Java3024ra Copyright 2013 R.G.Baldwin 

FE EEEE EEEE EEE EEEE EEE EE EEEE EE I I I A E 1 2k 21 4 24 21 21 24 4 24 E EE E 2k EE E / 
import java.awt.Graphics2D; 

import java.awt.geom.AffineTransform; 

import java.awt.geom.Rectangle2D; 

import java.awt.Graphics; 


public class Java3024raf{ 
public static void main(String[] args){ 
new Java3024raRunner().run(); 
}//end main method 
}//end class Java3024ra 


class Java3024raRunner{ 

public void run(){ 
Picture pix = new Picture("Prob02a. jpg"); 
pix = rotatePicture(pix, 35); 
pix = mirrorUpperQuads (pix); 
pix = mirrorHoriz (pix); 
pix.explore(); 
System. out .println(pix); 

3//end run 


private Picture rotatePicture(Picture pix, 
double angle) { 


AffineTransform rotateTransform = 
new AffineTransform() ; 
rotateTransform.rotate (Math. toRadians(angle) , 
pix.getWidth() /2, 
pix.getHeight ()/2); 


Rectangle2D rectangle2D = 
pix.getTransformEnclosingRect (rotateTransform) ; 

int resultWidth = (int) (rectangle2D.getWidth()); 

int resultHeight = (int) (rectangle2D.getHeight()); 


AffineTransform translateTransform = 
new AffineTransform() ; 
translateTransform. translate ( 
(resultWidth - pix.getWidth())/2, 
(resultHeight - pix.getHeight())/2); 


translateTransform. concatenate (rotateTransform) ; 
Picture result = new Picture( 
resultWidth, resultHeight) ; 


Graphics2D g2amilbGraph ies 2) easulibngeneHaApha esto /rontent /coll1441/1.181> 
g2.drawlmage (pix. getImage () ,translateTransform,nul1) ; 


return result; 
}//end rotatePicture 


941 


Table 3.397 
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Image 1 . Prob02a.jpg. 


Table 3.398 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


943 


eA None 
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Image 2 . Possible output image. 


Table 3.399 
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Image 3 . Possible output image. 


Brne 


R: 255 G. 255 B 255 Color at location: T 


Table 3.400 


Answer 1 (p. 957) 
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3.3.37.4 Images 


e Image 1 (p. 947) . Prob02a.jpg. 
e Image 2 (p. 951) . Possible output image. 
e Image 3 (p. 955) . Possible output image. 


3.3.37.5 Listings 
e Listing 1 (p. 945) . Question 1. 
What is the meaning of the following two images? 
This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 


The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None Lex) 


Display your name 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


3.3.37.6 Answers 
3.3.37.6.1 Answer 1 


The code in Listing 1 (p. 945) produces the output image shown in Image 2 (p. 951) . 
Back to Question 1 (p. 944) 


3.3.37.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3024r Review 
e File: Java3024r.htm 

e Published: 02/18/13 

e Revised 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.38 Java3024s Slides”? 
3.3.38.1 Table of Contents 


e Instructions for viewing slides (p. 958) 
e Miscellaneous (p. 958) 


3.3.38.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3024: Mirroring Images 7°° . 


Click here 7°! to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.38.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3024s Slides 
e File: Java3024s.htm 
e Published: 01/06/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
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a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.39 Java3026: GradientPaint and other Java2D Classes” 
3.3.39.1 Table of Contents 


e Preface (p. 959) 
Viewing tip (p. 959) 

x Images (p. 959) 

x Listings (p. 959) 
Preview (p. 960) 
Discussion and sample code (p. 964) 
Run the program (p. 977) 
Summary (p. 977) 
What’s next? (p. 977) 
Online video link (p. 977) 
Miscellaneous (p. 977) 
Complete program listing (p. 978) 


3.3.39.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 7° . 


3.3.39.2.1 Viewing tip 
I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.3.39.2.1.1 Images 


e Image 1 (p. 963) . Required graphic output. 
e Image 2 (p. 964) . Required text output. 
e Image 3 (p. 971) . A drawing of an ellipse. 


3.3.39.2.1.2 Listings 


e Listing 1 (p. 964) . The driver class named Prob03. 
e Listing 2 (p. 965) . Beginning of the class named Prob03Runner. 
e Listing 3 (p. 965) . Beginning of the method named process. 
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e Listing 4 (p. 966) . Translate the origin to the center of the image. 

e Listing 5 (p. 966) . Draw the black horizontal and vertical axes. 

e Listing 6 (p. 972) . Draw the solid green filled ellipse in the upper-left quadrant. 
e Listing 7 (p. 973) . Draw a circle with a gradient fill in the upper-right quadrant. 
e Listing 8 (p. 976) . Code for the remaining two quadrants.. 

e Listing 9 (p. 979) . Complete program listing. 


3.3.39.3 Preview 


In this module you will learn to use the GradientPaint class along with a variety of other Java2D classes. 
Program specifications 
Write a program named Prob03 that uses the class definition shown in Listing 1 (p. 964) and Ericson’s 
media library along with the image file named Prob03.jpg to produce the graphic output image shown 
in Image 1 (p. 963) . (Note that the image in the file named Prob03.jpg is a blank white image. You could 
also create this blank image using one of the constructors for the Picture class.) 
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R: 255 G: 0 B: 0 Color at location: D 
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Display your name here. 
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Image 1 . Required graphic output. 
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Display your name here. 


Table 3.401 


Circles with gradient paint 

The program draws four circles in the quadrants of a Cartesian coordinate system. One is filled with 
solid green. The other three are filled with cyclic gradient paint from green to blue. 

The number of cycles varies in each circle, as do the axes along which the gradient occurs. 

The background is set to Color.RED. 

New classes 

You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named Prob03 shown in Listing 1 (p. 964) . 

Required text output 

In addition to the output image mentioned above, your program must display your name and the other 
line of text shown in Image 2 (p. 964) . 
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Image 2 . Required text output. 


Display your name here. 
Picture, filename Prob03.jpg height 300 width 300 


Table 3.402 


3.3.39.4 Discussion and sample code 


Will discuss in fragments 

I will discuss and explain this program in fragments. A complete listing of the program is provided in 
Listing 9 (p. 979) near the end of the module. 

The driver class named Prob03 


The driver class containing the main method is shown in Listing 1 (p. 964) . 


Listing 1 . The driver class named Prob03. 


public class Prob03{ 
public static void main(String[] args){ 
new ProbO3Runner().run(); 
}//end main method 
}//end class Prob03 


Table 3.403 


If you have been studying the earlier modules in this series, no explanation of Listing 1 (p. 964) should 
be required. 

Beginning of the class named Prob03Runner 

The class named ProbO3Runner begins in Listing 2 (p. 965) . 
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Listing 2 . Beginning of the class named Prob03Runner. 


class Prob03Runner{ 
public Prob03Runner () { 
System.out.println("Display your name here."); 
}//end constructor 


public void run(){ 
Picture pic = new Picture("Prob03.jpg") ; 
// Picture pic = new Picture(300, 300); 


pic.setAl1PixelsToAColor(Color.RED) ; 
process (pic); 


//Add your name and display the output picture. 
pic.addMessage("Display your name here.",10,20); 
pic.explore(); 
System. out.println(pic); 

}//end run 


Table 3.404 


Avoiding use of a blank input image file 

This program was originally written using an early version of Ericson’s class library that didn’t support 
the second statement in the run method. (That statement was disabled by turning it into a comment 
in Listing 2 (p. 965) ) Asa result, with that library, it was necessary to read an image file containing a 
blank white image to create a Picture object with a blank white image. 

No longer a problem 

That problem was rectified with an update to her library and the disabled statement can be substituted 
for the statement immediately above it. If you do that, you won’t need the input image file. 

Except for that, and the call to the method named process _, you should already understand all of the 
code in Listing 2 (p. 965) . 

Beginning of the method named process 

The method named process begins in Listing 3 (p. 965) . 


Listing 3 . Beginning of the method named process. 


private void process(Picture pic) { 
Graphics2D g2 = (Graphics2D) (pic. getGraphics()); 


int width = pic. getWidth(); 
int height = pic.getHeight(); 


Table 3.405 
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Java2D graphics 

This is basically a module on the use of classes from the Java2D section of the standard class library. 
(See my lessons 300 through 324 on Java2D graphics here ?®* .) Classes from Ericson’s library are used 
mainly to support the display aspects of the program. 

What are Java2D graphics? 

Although the capabilities provided by Java2D graphics are wide and varied, in one way or another, they 
generally have to do with the creation of images by drawing. 

A graphics context is required 

In order to use the methods that will be using, it is necessary to gain access to the graphics context of 
an object as type Graphics2D . The first statement in Listing 3 (p. 965) calls Ericson’s getGraphics 
method to gain access to the graphics context of a Picture object. 

A cast to type Graphics2D is required 

However, the getGraphics method returns a reference to the graphics context as type Graphics 
In order for us to use it to do what we want to do, we must cast it to type Graphics2D . This gives us 
access to many more methods that would be the case without the cast. 

Save as type Graphics2D in a variable named g2 

The graphics context for the Picture object is saved in Listing 3 (p. 965) as type Graphics2D 
The reference is saved in the reference variable named g2 

Save the width and height of the Picture object 

The last two statements in Listing 3 (p. 965) get and save the width and the height of the image 
encapsulated in the Picture object. 

Translate the origin to the center of the image 

By default, the origin (with coordinates of 0,0) is in the upper-left corner of the image. However, we 
would like to be able to work with a coordinate system in which the origin is at the center. 

Listing 4 (p. 966) calls the translate method to move the origin to the center of the image. 


Listing 4 . Translate the origin to the center of the image. 


g2.translate(width/2,height/2) ; 


Table 3.406 


(Fortunately, you already understand affine transforms. Otherwise, you might not be able to understand 
the documentation for the translate method.) 
From this point forward... 

From this point forward, we can think of the coordinates of the pixel at the very center of the object as 
having values of 0,0. Locations to the left of center have negative X coordinates and locations above the 
center have negative Y coordinates. 

Draw the black horizontal and vertical axes 

The next thing we want to do is to draw the black horizontal and vertical axes that you see in the center 

of the image in Image 1 (p. 963) . This is accomplished by the code in Listing 5 (p. 966) . 


Listing 5 . Draw the black horizontal and vertical axes. 


continued on next page 
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//Set the drawing color to black 
g2.setColor(Color.BLACK) ; 


//Draw x-axis 
g2.draw(new Line2D.Double(-width/2, 0.0, 
width/2, 0.0)); 


//Draw y-axis 
g2.draw(new Line2D.Double(0.0, -width/2, 
0.0, height/2)); 


Table 3.407 


Set the drawing color to black 
Listing 5 (p. 966) begins by calling the setColor method to set the drawing color to Color. BLACK. 
(BLACK is a static constant in the Color class that represents the color black.) 
A new Line2D.Double object 
The fourth line of code in Listing 5 (p. 966) instantiates a new object of the Line2D.Double class. This 
object represents a line extending between two points specified by coordinate values passed as parameters 
to the constructor. 
A black horizontal line 
The first pair of coordinate values specifies the left end of the black horizontal line in Image 1 (p. 963) . 
The second pair of coordinate values specifies the right end of the black horizontal line in Image 1 (p. 963) . 
(See my Lesson Number 300 7° for an explanation of the somewhat unusual name of a class consisting 
of two words separated by a period: Line2D.Double .) 
Pass the line object to the Draw method 
The new object’s reference is passed to the draw method, which is responsible for causing the line to 
be drawn on the graphics context. 
A black vertical axis 
The last statement in Listing 5 (p. 966) draws the black vertical line shown in Image 1 (p. 963) . 
Coordinates relative to the origin at the center 
Note that in both cases, the end points of the line are specified using coordinate values that are relative 
to the origin, which is positioned at the center of the drawing context. 
Draw the solid green filled ellipse in the upper-left quadrant 
In case you are unfamiliar with the term, an ellipse is the 2D shape shown in the upper-left. quadrant 
of Image 3 (p. 971) . A circle is an ellipse with the major and minor axes having the same lengths. 
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Image 3 . A drawing of an ellipse. 
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Table 3.408 


There is no circle class 

Java does not provide a Circle2D.Double class but it does provide an Ellipse2D.Double class, 
which you can use to draw circles. 

(The Graphics class also provides a drawOval method that can be used to draw circles but those 
circles won’t suffice for what we will be doing in this module.) 

Four constructor parameters 

The constructor for the Ellipse2D.Double class requires four parameters of type double . The first 
two parameters are the X and Y coordinates of the upper-left corner of an imaginary rectangle. 

The next two parameters are the width andthe height of the imaginary rectangle. 

The sides of the imaginary rectangle are parallel to the X and Y axes, but can be rotated using affine 
transforms. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


967 


An ellipse inside an imaginary rectangle 

The ellipse is constructed inside the imaginary rectangle such that it is symmetrical about its horizontal 
and vertical axes and it touches all four sides of the rectangle. (The documentation refers to the rectangle 
as a framing rectangle.) 

How do you construct a circle? 

If the rectangle is actually a square, then the ellipse becomes a circle. 

Construct an ellipse inside an imaginary square 

The first statement in Listing 6 (p. 972) constructs an object of type Ellipse2D.Double inside a 
128x128 square that just fits in the upper left quadrant of our Cartesian coordinate system shown in Image 
1 (p. 963) . The circle object’s reference is saved in the reference variable named _ circlel 


Listing 6 . Draw the solid green filled ellipse in the upper-left quadrant. 


//Upper left quadrant 
Ellipse2D.Double circlel = 
new Ellipse2D.Double(-128, -128,128,128) ; 


//Solid GREEN fill 
g2.setPaint (Color.GREEN) ; 


g2.fill(circle1); 


g2.draw(circle1); 


Table 3.409 


Set the painting color 

The statement near the middle of Listing 6 (p. 972) sets the painting color to Color.GREEN 

(Note that Listing 6 (p. 972) calls setPaint whereas Listing 5 (p. 966) calls setColor . I 
will leave it as an exercise for the student to study the documentation in order to understand the difference 
between setColor and setPaint .) 

Fill the circle referred to by circle1 

The second statement from the bottom in Listing 6 (p. 972) calls the fill method of the Graphics2D 
class passing the circle object’s reference as a parameter. Although this can get quite complex, in this simple 
case, it causes the circle object to be filled with the paint color (green) . 

Draw the filled circle object 

Finally, the last statement in Listing 6 (p. 972) calls the draw method of the Graphics2D class 
to cause the filled circle to be drawn inside the framing rectangle that was specified when the circle was 
constructed. This results in the filled green circle in the upper-left quadrant in Image 1 (p. 963) . 

Draw a circle with a gradient fill in the upper-right quadrant 

This is where things tend to get a little complicated. 

If you compare the circles in the upper-left and upper-right quadrants in Image 1 (p. 963) , you will see 
that they look considerably different. 

Difference caused by parameter to the setPaint method 

If you compare the code in Listing 6 (p. 972) with the code in Listing 7 (p. 973) , you will see that 
except for the coordinate values that position the circle, the only difference is the parameter that is passed 
to the setPaint method. 
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Listing 7 . Draw a circle with a gradient fill in the upper-right quadrant. 


//Upper right quadrant 
//Gradient GREEN to BLUE, cyclic along horizontal 
// axis. 
Ellipse2D.Double circle2 = 
new Ellipse2D.Double(0.0,-128,128,128) ; 
g2.setPaint(new GradientPaint ( 
64,0,Color.GREEN, 
64,-32,Color.BLUE,true)) ; 
g2.fill(circle2) ; 
g2.draw(circle2) ; 


Table 3.410 


A simple color paint versus a gradient paint 

Listing 6 (p. 972) passes an object of the simple Color class representing the color green to the 
setPaint method. 

Listing 7 (p. 973) passes an object of the GradientPaint class to the setPaint method. 

Therefore, we need to understand the behavior of an object of the GradientPaint class. 

Constructor parameters 

There are four overloaded constructors for the GradientPaint class. The constructor used in Listing 
7 is one of the most complicated. It requires the following parameters: 


x1 - x coordinate of the first specified Point in user space 

yl - y coordinate of the first specified Point in user space 

color1 - Color at the first specified Point 

x2 - x coordinate of the second specified Point in user space 

y2 - y coordinate of the second specified Point in user space 

color2 - Color at the second specified Point 

cyclic - true if the gradient pattern should cycle repeatedly between the two colors; false otherwise 


Two points and two colors 

Basically, the class allows you to specify two points and two colors (plus one additional boolean param- 
eter) when you construct an object of the class. 

One of the colors is associated with each point. 

An imaginary line segment 

Think of the two points as being at the ends of an imaginary line segment, which can be at any angle 
relative to the horizontal. 

Colors at the ends of the line segment 

When a shape is drawn using a gradient fill, one of the colors will appear at one end of the line segment 
and the other color will appear at the other end of the line segment. 

The color will change 

The color will change gradually from one color to the other along the imaginary line segment connecting 
the two points. 

Perpendicular color bands on the sides 

The colors extend out to the sides of the imaginary line segment in bands that are perpendicular to the 
line segment. 

The cyclic parameter 
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If the last (cyclic) parameter is set to false, the color will only change along the imaginary line segment. 
Areas beyond each end of the line segment will be the colors that are specified for the points at the ends of 
the line segment. 

(This parameter was not set to false for any of the circles in Image 1.) 
If the cyclic parameter is true... 

The pattern of color change that occurs along the line segment will extend in a cyclic fashion beyond the 
ends of the line segment all the way to infinity. 

Compare constructor parameters with upper-right quadrant 

Now consider the parameter values used in Listing 7 (p. 973) and compare them with the image in the 
upper-right quadrant in 

A simple color paint versus a gradient paint 

Listing 6 passes an object of the simple Color class representing the color green to the setPaint 
method. 

Listing 7 passes an object of the GradientPaint class to the setPaint method. 

Therefore, we need to understand the behavior of an object of the GradientPaint class. 

Constructor parameters 

There are four overloaded constructors for the GradientPaint class. The constructor highlighted in 

yellow in Listing 7 is one of the most complicated. It requires the following parameters: 


x1 - x coordinate of the first specified Point in user space 

yl - y coordinate of the first specified Point in user space 

color1 - Color at the first specified Point 

x2 - x coordinate of the second specified Point in user space 

y2 - y coordinate of the second specified Point in user space 

color2 - Color at the second specified Point 

cyclic - true if the gradient pattern should cycle repeatedly between the two colors; false otherwise 


Two points and two colors 

Basically, the class allows you to specify two points and two colors (plus one additional boolean param- 
eter) when you construct an object of the class. 

One of the colors is associated with each point. 

An imaginary line segment 

Think of the two points as being at the ends of an imaginary line segment, which can be at any angle 
relative to the horizontal. 

Colors at the ends of the line segment 

When a shape is drawn using a gradient fill, one of the colors will appear at one end of the line segment 
and the other color will appear at the other end of the line segment. 

The color will change 

The color will change from one color to the other along the imaginary line segment connecting the two 
points. 

Perpendicular color bands on the sides 

The colors extend out to the sides of the imaginary line segment in bands that are perpendicular to the 
line segment. 

The cyclic parameter 

If the last (cyclic) parameter is set to false, the color will only change along the imaginary line segment. 
Areas beyond each end of the line segment will be the colors that are specified for the points at the ends of 
the line segment. 

(This parameter was not set to false for any of the circles in Image 1.) 

If the cyclic parameter is true... 

The pattern of color change that occurs along the line segment will extend in a cyclic fashion beyond the 
ends of the line segment all the way to infinity. 

Compare constructor parameters with upper-right quadrant 
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Now consider the parameter values used in Listing 7 (p. 973) and compare them with the image in the 
upper-right quadrant in Image 1 (p. 963) . 

The location of the first point 

The diameter of each circle in Image 1 (p. 963) is 128 pixels. The first point for the upper-right quadrant 
in Image 1 (p. 963) is on the X axis at the point where the circle touches the X axis. This point is specified 
to have a color of green. 

The location of the second point 

The second point is 32 pixels directly above the first point. Therefore, the imaginary line segment is 
perpendicular to the X axis. It extends from the X axis one-fourth of the way to the top of the circle. The 
second point is specified to have a color of blue. 

The color change 

As a result, the color changes from green to blue along the 32-pixel line segment. Color bands extend to 
the right and left, perpendicular to the line segment. 

The cyclic parameter 

The cyclic parameter is set to true, so the pattern repeats along the remaining vertical dimension of the 
circle. The color changes from blue back to green along the next 32-pixel vertical distance causing the circle 
to be green at the center. 

The pattern repeats again resulting in a blue band three-fourths of the way from the bottom to the top 
of the circle and a green band at the top of the circle. 

That’s all there is to it 

Now that you know the scheme, you should be able to examine the code in Listing 8 (p. 976) for the 
remaining two quadrants and understand how the constructor parameters resulted in the color patterns that 
you see in Image 1 (p. 963) . 
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Listing 8 . Code for the remaining two quadrants. 


//Lower left quadrant 
//Gradient GREEN to BLUE, cyclic along vertical axis. 
//norizontal axis 
Ellipse2D.Double circle3 = 
new Ellipse2D.Double(-128,0.0,128,128) ; 
g2.setPaint ( 
new GradientPaint ( 
-128,-64,Color.GREEN, 
-107,-64,Color.BLUE,true)); 
g2.fill(circle3) ; 
g2.draw(circle3) ; 


//Lower right quadrant 
//Gradient GREEN to BLUE, cyclic along 
// 45 degree angle 
Ellipse2D.Double circle4 = 
new Ellipse2D.Double(0,0,128,128) ; 
g2.setPaint ( 
new GradientPaint ( 
19,19,Color.GREEN, 
64,64,Color.BLUE,true)); 


g2.fill(circle4) ; 
g2.draw(circle4) ; 


}//end process 


}//end class Prob03Runner 


Table 3.411 


An interesting anomaly 

I will point out one interesting anomaly, however. Even though we shifted the origin to the center, we 
did not change the direction that represents positive values on the Y axis. 

Coordinates above the center are negative and coordinates below the center are positive. 

Where is the line segment? 

If you examine the constructor parameters for the lower-left quadrant in Listing 8 (p. 976) , you will see 
that the imaginary line segment isn’t in the lower-left quadrant. 

The line segment is 21 pixels in length, parallel to the horizontal axis. However, it is 64 pixels above the 
horizontal axis. That is not in the lower-left quadrant. 

The effect is... 

The effect is as though the color gradient fills the universe, and is based on a line segment placed anywhere 
in the universe. 

However, we only see the color gradient through the shape that we specify as a parameter to the fill 
method. In other words, that shape is a window through which we can see a background consisting of 
gradient color changes. 

Our window is in the lower-left quadrant 
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In this case, that shape is the circle in the lower-left quadrant, so we see the gradient color effect in the 
lower-left quadrant. 

How about the bottom-right quadrant 

I stated earlier that the imaginary line segment can be at any angle relative to the horizontal axis. 

For the bottom right quadrant, the line segment is 64 pixels in length. It lies along a line that goes 
through the origin and is at 45 degrees clockwise relative to the horizontal. 

Where is the line segment positioned? 

One end of the line segment is at the center of the circle. The other end of the line segment is at the 
point where the 45-degree line intersects the edge of the circle closest to the origin. 

You can take it from there 

You should be able to take it from there and explain the color gradient in the circle in the lower-right 
quadrant. Recall that the diameter of the circle is 128 pixels. The length of the line segment is 64 pixels or 
one-half the diameter. 

The end of the class 

Listing 8 (p. 976) signals the end of the class named ProbO3Runner and the end of the program. 


3.3.39.5 Run the program 


I encourage you to copy the code from Listing 9 (p. 979) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. For example, try setting the cyclic 
constructor parameter to false and observe the effect. Make certain that you can explain why your changes 
behave as they do. 

Click Prob03.jpg 26° to download the input image file if you elect to use it. 
3.3.39.6 Summary 


In this module, you learned to use the GradientPaint class along with a variety of other Java2D classes. 


3.3.39.7 What’s next? 


In the next module, you will Learn how to use shapes to clip images during the drawing process. 


3.3.39.8 Online video link 


Select the following link to view an online video lecture on the material in this module. 


e ITSE 2321 Lecture 13 267 


3.3.39.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: GradientPaint and other Java2D Classes 
e File: Java3026.htm 

e Published: 08/04/12 

e Revised: 12/07/14 


66http://cnx.org/content /m44242/latest /Prob03.jpg 
67 http://vimeo.com/channels/itse2321/21220418 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.3.39.10 Complete program listing 


A complete listing of the program discussed in this module is provided in Listing 9 (p. 979) below. 
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Listing 9 . Complete program listing. 


/*File Prob03 Copyright 2008 R.G.Baldwin 
FE AG I OA I IAAI I ICI AI AI I I I I I I A 1 21 21 21 4 24 21 21 E EEE E EE E E 2 2k E / 
import java.awt.geom.Line2D; 
import java.awt.geom.Ellipse2D; 
import java.awt.Color; 
import java.awt.Graphics; 
import java.awt.Graphics2D; 
import java.awt.GradientPaint ; 


public class Prob03{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new ProbO3Runner().run(); 
}//end main method 
}//end class Prob03 


class ProbO3Runner{ 
public Prob03Runner () { 
System.out.println("Display your name here."); 
}//end constructor 


public void run(){ 
Picture pic = new Picture("Prob03.jpg") ; 
pic.setAl1PixelsToAColor(Color.RED) ; 


process (pic); 
//Add your name and display the output picture. 
pic.addMessage("Display your name here.",10,20); 
pic.explore(); 
System. out.println(pic); 

3//end run 


private void process(Picture pic) { 
Graphics2D g2 = (Graphics2D) (pic.getGraphics()) ; 


int width = pic.getWidth(); 
int height = pic.getHeight(); 


//Translate origin to center of Frame 
g2.translate(width/2,height/2) ; 
g2.setColor(Color.BLACK) ; 

//Draw x-axis 

g2.draw(new Line2D.Double(-width/2,0.0,width/2,0.0)); 
//Draw y-axis 

g2.draw(new Line2D.Double(0.0,-width/2,0.0,height/2)) ; 


//Upper left quadrant, Solid GREEN fill 

B11ipse2D. Doull eo feat Connexions <http://cnx.org/content/col11441/1.181> 
new Ellipse2D.Double(-128, -128,128,128) ; 

g2.setPaint (Color.GREEN) ; 


g2.fill(circle1); 


975 


Table 3.412 


-end- 
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3.3.40 Java3026r Review” 
3.3.40.1 Table of Contents 
e Preface (p. 981) 
e Questions (p. 981) 
1 (p. 981) 


Images (p. 990) 
Listings (p. 990) 
Answers (p. 992) 
Miscellaneous (p. 992) 


3.3.40.2 Preface 


This module contains review questions and answers keyed to the module titled Java3026: GradientPaint and 
other Java2D Classes 7° . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.40.3 Questions 


3.3.40.3.1 Question 1 


Which of the following output images is produced by the program shown in Listing 1 (p. 982) ? 
A. Image 1 (p. 986) 
B. Image 2 (p. 990) 


268 This content is available online at <http://cnx.org/content /m45785/1.2/>. 
6°http://cnx.org/content /m44242 
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Listing 1 . Question 1. 


/*File Java3026ra Copyright 2013 R.G.Baldwin 

FE EEEE EE EEE EEEE EEEE EEE EE EE EEEE KI I A E 21 21 21 4 24 21 21 E EEE E EE EE 2 2k E / 
import java.awt.geom.Line2D; 

import java.awt.geom.Ellipse2D; 

import java.awt.Color; 

import java.awt.Graphics; 

import java.awt.Graphics2D; 

import java.awt.GradientPaint ; 


public class Java3026raf{ 
public static void main(String[] args){ 
new Java3026raRunner ().run(); 
}//end main method 
}//end class Java3026ra 


class Java3026raRunner{ 
public void run(){ 
Picture pic = new Picture(300,300) ; 
pic.setAl1PixelsToAColor(Color.RED) ; 
process (pic); 
pic.explore(); 
}//end run 


private void process(Picture pic) { 
Graphics2D g2 = (Graphics2D) (pic.getGraphics()) ; 


int width = pic.getWidth(); 
int height = pic.getHeight(); 


g2.translate(width/2,height/2) ; 
g2.setColor (Color.BLACK) ; 
g2.draw(new Line2D.Double(-width/2,0.0,width/2,0.0)); 
g2.draw(new Line2D.Double(0.0,-width/2,0.0,height/2)) ; 
Ellipse2D.Double circlel = 

new Ellipse2D.Double(-128, -128,128,128) ; 


g2.setPaint (new GradientPaint (-64,-64,Color.BLUE, 
-~32,-32,Color.GREEN,true)) ; 

g2.fill(circle1); 

g2.draw(circle1); 


Ellipse2D.Double circle2 = 

new Ellipse2D.Double(0.0,-128,128,128) ; 
g2.fill(circle2) ; 
g2.draw(circle2) ; 


Ellipse2D. Douhi#labkr Gi @3e at Connexions <http://cnx.org/content/coll1441/1.181> 


new Ellipse2D.Double(-128,0.0,128,128) ; 
g2.fill(circle3) ; 
g2.draw(circle3) ; 
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Table 3.413 
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Image 1 . Possible output image. 
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Table 3.414 
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Image 2 . Possible output image. 
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Table 3.415 


Answer 1 (p. 992) 


3.3.40.4 Images 


e Image 1 (p. 986) . Possible output image. 
e Image 2 (p. 990) . Possible output image. 


3.3.40.5 Listings 
e Listing 1 (p. 982) . Question 1. 
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What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 

The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None KEX] 


Display your name 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Put your name here 


3.3.40.6 Answers 
3.3.40.6.1 Answer 1 


The code in Listing 1 (p. 982) produces the output image shown in Image 1 (p. 986) . 
Back to Question 1 (p. 981) 


3.3.40.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3026r Review 
e File: Java3026r.htm 

e Published: 02/18/13 

e Revised 12/07/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.41 Java3026s Slides” 
3.3.41.1 Table of Contents 


e Instructions for viewing slides (p. 993) 
e Miscellaneous (p. 993) 


3.3.41.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3026: GradientPaint and other Java2D 
Classes 271 . 

Click here 2”? to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.41.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3026s Slides 
e File: Java3026s.htm 
e Published: 01/06/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 


270This content is available online at <http://cnx.org/content /m45643/1.2/>. 
271 http://cnx.org/content /m44242 
272http://cnx.org/content /m45643/latest /a0-Index.htm 
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a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 


was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 


in Austin, TX. 


-end- 


3.3.42 Java3028: Clipping Images” 
3.3.42.1 Table of Contents 


e Preface (p. 994) 
Viewing tip (p. 994) 

x Images (p. 994) 

x Listings (p. 995) 
Preview (p. 995) 
Discussion and sample code (p. 1006) 
Run the program (p. 1009) 
Summary (p. 1009) 
What’s next? (p. 1009) 
Online video link (p. 1009) 
Miscellaneous (p. 1010) 
Complete program listing (p. 1010) 


3.3.42.2 Preface 


989 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 


using Java. 


The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 


Multimedia Class Library 7% . 


3.3.42.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 


following links to easily find and view the images and listings while you are reading about them. 


3.3.42.2.1.1 Images 


e Image 1 (p. 997) . Input file named Prob04a.jpg. 
e Image 2 (p. 1001) . First output image. 

e Image 3 (p. 1005) . Second output image. 

e Image 4 (p. 1006) . Required text output. 


273 This content is available online at <http://cnx.org/content /m44246/1.7/>. 
274http://cnx.org/content /m44148/latest:/ 
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3.3.42.2.1.2 Listings 


e Listing 1 (p. 1006) . The driver class named Prob04. 

e Listing 2 (p. 1007) . Beginning of the class named Prob04Runner. 
e Listing 3 (p. 1007) . Clip the picture and display your name. 

e Listing 4 (p. 1008) . The method named clipToEllipse. 

e Listing 5 (p. 1011) . Complete program listing. 


3.3.42.3 Preview 


In this module, you will learn how to use shapes to clip images during the drawing process. 

Program specifications 

Write a program named Prob04 that uses the class definition shown in Listing 1 (p. 1006) and Ericson’s 
media library along with the image file named Prob04a.jpg (see Image 1 (p. 997) ) to produce the 
graphic output images shown in Image 2 (p. 1001) and Image 3 (p. 1005) . Don’t forget to display your 
name in the output image as shown. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


991 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


992 


CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Image 1 . Input file named Prob04a.jpg. 


Table 3.416 
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Image 2 


. First output image. 


E: 259 G: 299 B: 255 Color at location: | | 


Table 3.417 
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Image 3 . Second output image. 
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Table 3.418 


New classes 
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You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named Prob04 shown in Listing 1 (p. 1006) . 

Rotate, mirror, and clip 

The program rotates a Picture object by 35 degrees with no scaling. Then it does a four-way mirror 
on the rotated picture. Finally, it clips the image to an elliptical format as shown in Image 3 (p. 1005) . 

Required output text 

In addition to the two output images shown above, your program must display your name and the other 
line of text shown in Image 4 (p. 1006) . 


Image 4 . Required text output. 


Display your name here. 
Picture, filename None height 404 width 425 


Table 3.419 


3.3.42.4 Discussion and sample code 


Will discuss in fragments 

I will discuss and explain this program in fragments. A complete listing of the program is provided in 
Listing 5 (p. 1011) near the end of the module. 

The driver class named Prob04 

The driver class containing the main method is shown in Listing 1 (p. 1006) . 


Listing 1 . The driver class named Prob04. 


public class Prob04{ 
public static void main(String[] args){ 
new ProbO04Runner().run(); 
}//end main method 
}//end class Prob04 


Table 3.420 


If you have been studying the earlier modules in this collection, no explanation of Listing 1 (p. 1006) 
should be required. 

Beginning of the class named Prob04Runner 

The class named Prob04Runner begins in Listing 2 (p. 1007) . 
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Listing 2 . Beginning of the class named Prob04Runner. 


class Prob04Runner{ 


public Prob04Runner () { 
System.out.println("Display your name here."); 
}//end constructor 


public void run(){ 
Picture pix = new Picture("Prob04a. jpg"); 


//Rotate and mirror the picture. 
pix = rotatePicture (pix, 35); 
pix = mirrorUpperQuads (pix); 
pix = mirrorHoriz (pix); 


pix.explore(); 


Table 3.421 


Nothing new here 

There is nothing new in Listing 2 (p. 1007) . 

After instantiating a new Picture object from the given image file, Listing 2 (p. 1007) calls three 
methods to rotate, mirror, and display the picture, producing the graphic output shown in Image 2 (p. 
1001) . 

All of the code to accomplish this is essentially the same as code that I have explained in earlier modules. 

Clip the picture and display your name 

Then Listing 3 (p. 1007) calls the clipToElIlipse method to clip the picture to an ellipse on a red 
background as shown in Image 3 (p. 1005) . The clipToEllipse method is new to this module, so I will 
explain it shortly. 


Listing 3 . Clip the picture and display your name. 


pix = clipToFllipse(pix) ; 


//Add your name and display the output picture. 
pix.addMessage("Display your name here.",10,20); 
pix.explore(); 


System. out .println(pix); 
3//end run 


Table 3.422 


The remaining code in Listing 3 (p. 1007) is a repeat of code that I have explained in earlier modules, 
so I won’t have anything further to say about it. 
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The method named clip ToEllipse 


The method named clipToEllipse is shown in its entirety in Listing 4 (p. 1008) . 


Listing 4 . The method named clipToEllipse. 


private Picture clipToEllipse(Picture pix){ 
Picture result = 
new Picture(pix.getWidth() ,pix.getHeight ()); 
result.setAll1PixelsToAColor (Color.RED) ; 


//Get the graphics2D object 
Graphics2D g2 = (Graphics2D) (result.getGraphics()) ; 


//Create an ellipse for clipping 
Ellipse2D.Double ellipse = 
new Ellipse2D.Double (28,64, 366,275) ; 


//Use the ellipse for clipping 
g2.setClip(ellipse) ; 


//Draw the image 

g2.drawIlmage (pix. getImage() ,0,0,pix.getWidth() , 
pix.getHeight(), 
null); 


return result; 


}//end clipToEllipse 


Table 3.423 


Behavior of the clipToEllipse method 


The clipToEllipse method receives an incoming parameter that is a reference to an object of the 
Picture class. Basically, here is what the method does: 


Instantiate a Picture object with an all white background that is the same size as the incoming 
Picture object. 

Call Ericson’s setAllPixelsToAColor method to convert the white background into a red back- 
ground. 

Call Ericson’s getGraphics method to get the Graphics object encapsulated in the red Picture 
object. 

Cast the Graphics object’s reference to type Graphics2D 

Construct a new Ellipse2D.Double object with the position, width, and height specified by the 
constructor parameters. 

Call Sun’s setClip method to set the clipping area on the red Picture object to match the position 
and shape of the ellipse. 

Call Ericson’s getImage method to get the Image object encapsulated in the incoming Picture 
object. 

Call Sun’s drawImage method to draw that portion of the incoming picture that fits inside the 
ellipse on the red Picture object. 
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The new code 
The only code in Listing 4 (p. 1008) that is new to this module is the call to the setClip method. 
The setClip method is defined in the Graphics class and inherited into the Graphics2D class. 
(Among other things, that means that it wasn’t necessary for me to cast the Graphics object to type 
Graphics2D in Listing 4 (p. 1008) .) 
The setClip method 

There are a couple of overloaded versions of the setClip method. The one used in Listing 4 (p. 1008) 

requires an incoming parameter of the interface type Shape . 
The Shape interface 

Briefly, Sun tells us that the Shape interface "provides definitions for objects that represent some 
form of geometric shape." 

There are several dozen classes that implement the Shape interface, one of which is the class named 
Ellipse2D.Double . Therefore, the object of that type that is instantiated in Listing 4 (p. 1008) satisfies 
the type requirement for being passed to the setClip method. 

Behavior of the setClip method 
With regard to the behavior of the setClip method, Sun tells us that the method 
"Sets the current clipping area to an arbitrary clip shape." 
What is the significance of the clipping area? 
The closest answer that I can find for that question is the following statement in Sun’s description of the 
Graphics class: 
"All rendering operations modify only pixels which lie within the area bounded by the current clip, which 
is specified by a Shape in user space and is controlled by the program using the Graphics object." 
In other words... 

The clipping area is analogous to the current clip . In this case, the position and shape of the current 
clip is the position and shape of the ellipse. 

When the image is later drawn on the red Picture object, only those pixels within the ellipse are 
modified to show the image. The remaining pixels retain their original color, which was set to red early in 
Listing 4 (p. 1008) . 

End of discussion 

That concludes my explanation of this program. You will find the methods that I didn’t discuss in Listing 

5 (p. 1011) near the end of the module. 


3.3.42.5 Run the program 


I encourage you to copy the code from Listing 5 (p. 1011) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 

Click Prob04a.jpg 2” to download the required input image file. 


3.3.42.6 Summary 


In this module, you learned how to use shapes to clip images during the drawing process. 


3.3.42.7 What’s next? 


In the next module, you will learn how to merge pictures. 


3.3.42.8 Online video link 


Select the following link to view an online video lecture on the material in this module. 


275 http://cnx.org/content /m44246 /latest /Prob04a.jpg 
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3.3.42.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java OOP: Clipping Images 
e File: Java3028.htm 

e Published: 08/06/12 

e Revised: 12/08/14 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.3.42.10 Complete program listing 


A complete listing of the program discussed in this module is provided in Listing 5 (p. 1011) below. 


276http://vimeo.com/channels/itse2321/21221510 
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Listing 5 . Complete program listing. 


/*File Prob04 Copyright 2008 R.G.Baldwin 
FE EEEE EE EEE EEEE EEEE EEE EE EEEE EEE EEEE 21 21 EE 21 21 21 4 4 24 E 2 ff 2k 2 2k E / 
import java.awt.Graphics2D; 
import java.awt.geom.AffineTransform; 
import java.awt.geom.Rectangle2D; 
import java.awt.Graphics; 
import java.awt.geom.Ellipse2D; 
import java.awt.Color; 


public class Prob04{ 
public static void main(String[] args){ 
new ProbO4Runner().run(); 
}//end main method 
}//end class Prob04 


class Prob04Runner{ 
public Prob04Runner () { 
System.out.println("Display your name here."); 
}//end constructor 


public void run(){ 
Picture pix = new Picture("Prob04a. jpg"); 


//Rotate and mirror the picture. 
pix = rotatePicture (pix, 35); 
pix = mirrorUpperQuads (pix); 
pix = mirrorHoriz (pix); 


pix.explore(); 


//Clip the picture to an ellipse on a red background. 
pix = clipToFllipse (pix); 


//Add your name and display the output picture. 
pix.addMessage("Display your name here.",10,20); 
pix.explore(); 


System. out .println(pix); 
3//end run 


private Picture clipToEllipse(Picture pix) f{ 
Picture result = 
new Picture(pix.getWidth() ,pix.getHeight ()); 
result.setAl1PixelsToAColor(Color.RED) ; 


//Get the graphics2D object 
Graphics2D g2 = (Graphics2D) (result.getGraphics()) ; 
Di Cneaba. an RLE for free pt Connexions <http://cnx.org/content /col11441/1.181> 
Ellipse2D.Double ellipse = 
new Ellipse2D.Double(28, 64,366,275) ; 
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Table 3.424 


-end- 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1008 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


3.3.43 Java3028r Review” 
3.3.43.1 Table of Contents 
e Preface (p. 1013) 
e Questions (p. 1013) 
1 (p. 1013) 


Images (p. 1025) 
Listings (p. 1025) 
Answers (p. 1026) 
Miscellaneous (p. 1026) 


3.3.43.2 Preface 


This module contains review questions and answers keyed to the module titled Java3028: Clipping Images 
278 


The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.43.3 Questions 


3.3.43.3.1 Question 1 


Given the input image shown in Image 1 (p. 1016) , which of the following output images is produced by 
the code in Listing 1 (p. 1014) ? 

A. Image 2 (p. 1020) 

B. Image 3 (p. 1024) 


277 This content is available online at <http://cnx.org/content/m45786/1.2/>. 
278http://cnx.org/content /m44246 
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Listing 1 . Question 1. 


/*File Java3028ra Copyright 2013 R.G.Baldwin 

FE AG EEE EEEE EEE I I IIA AI I ICI GK I I A E 1 2k EE 21 21 E EEE E EE EE 2 2k E / 
import java.awt.Graphics2D; 

import java.awt.geom.AffineTransform; 

import java.awt.geom.Rectangle2D; 

import java.awt.Graphics; 

import java.awt.geom.Ellipse2D; 

import java.awt.Color; 


public class Java3028raf{ 
public static void main(String[] args){ 
new Java3028raRunner().run(); 
}//end main method 
}//end class Java3028ra 


class Java3028raRunner{ 


public void run(){ 
Picture pix = new Picture("Prob04a. jpg"); 
pix = rotatePicture(pix, 35); 
pix = mirrorUpperQuads (pix); 
pix = mirrorHoriz (pix); 


pix = clipToFllipse (pix); 
pix.explore(); 
3//end run 
[fiasco sss sn sess sss sss soso sess as secs ste // 


private Picture clipToEllipse(Picture pix) f{ 
Picture result = 
new Picture(pix.getWidth() ,pix.getHeight ()); 
result .setAl1PixelsToAColor(Color.RED) ; 
Graphics2D g2 = (Graphics2D) (result.getGraphics()); 
Ellipse2D.Double ellipse = 
new Ellipse2D.Double(28,64, 366,275) ; 
g2.setClip(ellipse) ; 
g2.drawIlmage (pix.getImage() ,0,0,pix.getWidth(), 
pix.getHeight(), 
null); 
return result; 
}//end clipToEllipse 


private Picture rotatePicture(Picture pix, 
double angle){ 


AffineTransform rotateTransform = 
new AffineTransform() ; 
rotateTransform.rotate (Math. toRadians(angle) , 


Available for fR4%t CVWaabhL XP: / /cnx.org/content /col11441/1 .181> 
pix.getHeight ()/2); 


Rectangle2D rectangle2D = 
pix.getTransformEnclosingRect (rotateTransform);: 
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| None 
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| None 
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R: 255 G: 0 B: 0 Color at location: io 


Table 3.427 
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None 
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None 
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None 
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Image 3 . Possible output image. 


R: 255 G. 0 B: 0 Color at location: E 


= = M 


Table 3.428 


Answer 1 (p. 1026) 
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3.3.43.4 Images 


e Image 1 (p. 1016) . Prob04a.jpg 
e Image 2 (p. 1020) . Possible output image. 
e Image 3 (p. 1024) . Possible output image. 


3.3.43.5 Listings 

e Listing 1 (p. 1014) . Question 1. 
What is the meaning of the following two images? 

This image was inserted here simply to insert some space between the questions and the answers to keep 
them from being visible on the screen at the same time. 


The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 
Oriented Programming. 


None Lex) 


Display your nam, 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


3.3.43.6 Answers 
3.3.43.6.1 Answer 1 


The code in Listing 1 (p. 1014) produces the output image shown in Image 3 (p. 1024) . 
Back to Question 1 (p. 1013) 


3.3.43.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3028r Review 
e File: Java3028r.htm 

e Published: 02/18/13 

e Revised 12/08/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.44 Java3028s Slides” 
3.3.44.1 Table of Contents 


e Instructions for viewing slides (p. 1027) 
e Miscellaneous (p. 1027) 


3.3.44.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3028: Clipping Images 7®° . 

Click here 78! to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.44.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3028s Slides 
e File: Java3028s.htm 
e Published: 01/06/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 


279This content is available online at <http://cnx.org/content /m45646/1.2/>. 
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a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.45 Java3030: Merging Pictures” 
3.3.45.1 Table of Contents 


e Preface (p. 1028) 
Viewing tip (p. 1028) 


x Images (p. 1028) 
x Listings (p. 1028) 


Preview (p. 1029) 

Discussion and sample code (p. 1039) 
Run the program (p. 1044) 
Summary (p. 1044) 

Online video link (p. 1044) 
Miscellaneous (p. 1044) 

Complete program listing (p. 1044) 


3.3.45.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 7°° . 


3.3.45.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the images and listings while you are reading about them. 


3.3.45.2.1.1 Images 


e Image 1 (p. 1032) . Input file named Prob05a.jpg. 
e Image 2 (p. 1036) . Input file named Prob05b.jpg. 
e Image 3 (p. 1039) . Required graphic output image. 
e Image 4 (p. 1039) . Required output text. 


3.3.45.2.1.2 Listings 


e Listing 1 (p. 1041) . The driver class named Prob05. 
e Listing 2 (p. 1041) . Beginning of the class named Prob05Runner. 
e Listing 3 (p. 1041) . The run method of the Prob05Runner class. 


282TThis content is available online at <http://cnx.org/content /m44247/1.7/>. 
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e Listing 4 (p. 1042) . Beginning of the merge method. 
e Listing 5 (p. 1043) . Do the merge. 
e Listing 6 (p. 1045) . Complete program listing. 


3.3.45.3 Preview 


In this module, you will learn how to do a linear merge on two pictures based on the distance of each pixel 
from the left side of the picture. 

Program specifications 

Write a program named Prob05 that uses the class definition shown in Listing 1 (p. 1041) and Ericson’s 
media library along with the image files named Prob05a.jpg and Prob05b.jpg (see Image 1 (p. 1032) 
and Image 2 (p. 1036) ) to produce the graphic output image shown in Image 3 (p. 1039) . 


x] 
Take Picture 
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Image 1 . Input file named Prob05a.jpg. 


E 
Take Picture 


Table 3.429 
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Table 3.430 
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Display your name here. 


Display your name here. 
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B None 


Display your name here. 
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Image 3 . Required graphic output image. 


Display your name here. 


Table 3.431 


Required output text 
In addition to the output image mentioned above, your program must display your name and the other 


line of text shown in Image 4 on the command-line screen. 


Image 4 . Required output text. 


Display your name here. 
Picture, filename None height 252 width 330 


Table 3.432 


3.3.45.4 Discussion and sample code 
This program does a linear merge on two pictures based on the distance of each pixel from the left side of 
the picture. The program also adds a sun with a gradient and the student’s name to the picture. 


Will discuss in fragments 

I will discuss and explain this program in fragments. A complete listing of the program is provided in 
Listing 6 (p. 1045) near the end of the module. 

The driver class named Prob05 

The driver class containing the main method is shown in Listing 1 (p. 1041) . 
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Listing 1 . The driver class named Prob05. 


public class Prob05{ 
public static void main(String[] args){ 
new ProbO5Runner().run(); 
}//end main method 
}//end class Prob05 


Table 3.433 


The code in Listing 1 (p. 1041) shouldn’t require an explanation at this stage in the course. 
Beginning of the class named Prob05Runner 
The class named Prob05Runner begins in Listing 2 (p. 1041) . 


Listing 2 . Beginning of the class named Prob05Runner. 


class ProbO5Runner{ 
public Prob05Runner () { 
System.out.println("Display your name here."); 
}//end constructor 


Table 3.434 


As with Listing 1 (p. 1041) , the code in Listing 2 (p. 1041) shouldn’t require an explanation. 

The run method of the Prob05Runner class 

Listing 1 (p. 1041) calls the run method on an object of the Prob05Runner class. The run 
method is shown in its entirety in Listing 3 (p. 1041) . 


Listing 3 . The run method of the Prob05Runner class. 


public void run(){ 
Picture penguin = new Picture("Prob05a. jpg"); 
Picture hare = new Picture("Prob05b. jpg"); 
merge (hare, penguin) ; 
hare = crop(hare,6,58, 330,252) ; 
hare.addMessage("Display your name here.",10,20); 
drawSun (hare) ; 
hare.show() ; 
System. out.println(hare) ; 
3//end run 


Table 3.435 
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The only thing in Listing 3 (p. 1041) that I haven’t explained in earlier modules is the call to the merge 
method, so I will limit my discussion to that method. 
The merge method 
The merge method is used to merge the image in Image 1 (p. 1032) with the image in Image 2 (p. 
1036) to produce the image shown in Image 3 (p. 1039) . 
(Note, however, that the merged image was cropped to eliminate the buttons at the top of F igure 1 (p. 
1032) and Image 2 (p. 1036) before displaying it in Image 3 (p. 1039) .) 
A linear merge 
The merge method does a linear merge on two pictures based on the distance of each pixel from the 
left side of the picture. 
The method assumes that both pictures have the same dimensions. 
Beginning of the merge method 
The merge method begins in Listing 4 (p. 1042) . 


Listing 4 . Beginning of the merge method. 


private void merge(Picture left,Picture right) { 
int width = left.getWidth(); 
int height = left.getHeight (); 


double scaleL 
double scaleR 
int redL = 0; 
int greenL = 0; 
int blueL = 0; 
int redR = 0; 
int greenR = 0; 

int blueR = 0; 

Pixel pixelL = null; 
null; 


0; 
0; 


Pixel pixelR 


Table 3.436 
The code in Listing 4 (p. 1042) simply declares and initializes a large number of working variables. 


Do the merge 
The merge is accomplished in the nested for loop in Listing 5 (p. 1043) . 
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Listing 5 . Do the merge. 


for(int row = O;row < height;row++){ 
for(int col = 0;col < width;col++){ 

scaleR = (double) col/width; 

scaleL = 1.0 - scaleR; 

pixelL = left.getPixel(col,row) ; 

pixelR = right.getPixel(col,row) ; 


redL = pixelL.getColor() .getRed(); 
greenL = pixelL.getColor() .getGreen() ; 
blueL = pixelL.getColor() .getBlue() ; 


redR = pixelR.getColor() .getRed(); 
greenR = pixelR.getColor() .getGreen() ; 
blueR = pixelR.getColor() .getBlue() ; 


redL = (int) (redL*scaleL + redR*scaleR) ; 
greenL = (int) (greenL*scaleL + greenR*scaleR) ; 
blueL = (int) (blueL*scaleL + blueR*scaleR) ; 


pixelL.setColor(new Color(redL,greenL,blueL)) ; 
}//end inner loop 
}//end outer loop 
}//end merge 


Table 3.437 


Difficult to explain 
Although the code in Listing 5 (p. 1043) is long, tedious, and ugly, it isn’t complicated However, it is 
somewhat difficult to explain in words. 
Two scale factors 
The body of the for loop begins by computing a pair of scale factors named scaleR and _ scaleL 
The factor named scaleR has a maximum value of 1.0 and is directly proportional to the distance of the 
current pixel from the left edge of the picture. 
The factor named scaleL also has a maximum value of 1.0 and is inversely proportional to the distance 
of the pixel from the left edge. 
Get and save color components 
The red, green, and blue values for the same pixel location in each of the pictures are obtained and saved. 
Compute a new set of color values 
A new set of red, green, and blue color values are computed as the sum of scaled versions of the pixel 
colors from the rabbit image pixel and the penguin image pixel. 
The nature of the scaling 
The scaling is such that the pixel colors from the rabbit image contribute most heavily to output pixels 
to the left of center and pixel colors from the penguin image contribute most heavily to output pixels to the 
right of center. 
You can see the effect of this scaling algorithm in Image 3 (p. 1039) . 
The pixels in the horizontal center 
The pixels along a vertical line at the center of the output image contain equal contributions of colors 
from both images. 
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You can view the drawSun and crop methods in Listing 6 (p. 1045) near the end of the module. 


3.3.45.5 Run the program 


I encourage you to copy the code from Listing 6 (p. 1045) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 


why your changes behave as they do. 
Click Prob05a.jpg 784 and Prob05b.jpg 78° to download the required input image files. 
3.3.45.6 Summary 


In this module, you learned how to merge two pictures. 


3.3.45.7 Online video link 
Select the following link to view an online video lecture on the material in this module. 


e ITSE 2321 Lecture 15 286 


3.3.45.8 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java OOP: Merging Pictures 
e File: Java3030.htm 

e Published: 08/07/12 

e Revised: 12/08/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.3.45.9 Complete program listing 


A complete listing of the program discussed in this module is provided in Listing 6 (p. 1045) below. 


284http://cnx.org/content /m44247 /latest /Prob05a.jpg 
85http://cnx.org/content /m44247 /latest /Prob05b.jpg 
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Listing 6 . Complete program listing. 


/*File Prob05 Copyright 2008 R.G.Baldwin 
FE IG IAG I IOI I IOI AI AI I I I I I EE 21 21 21 4 24 21 21 21 EEE E EE E 2k 2 2 E / 
import java.awt.Color; 
import java.awt.Graphics2D; 
import java.awt.Graphics; 
import java.awt.GradientPaint ; 
import java.awt.geom.Ellipse2D; 


public class Prob05{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new ProbO5Runner().run(); 
}//end main method 
}//end class Prob05 


class ProbO5Runner{ 
public Prob05Runner () { 
System.out.println("Display your name here."); 
}//end constructor 


public void run(){ 
Picture penguin = new Picture("Prob05a. jpg") ; 
Picture hare = new Picture("Prob05b. jpg"); 
merge (hare, penguin) ; 
hare = crop(hare,6,58,330, 252) ; 
hare.addMessage("Display your name here.",10,20); 
drawSun (hare) ; 
hare. show() ; 
System. out.println(hare) ; 

3//end run 


private void drawSun(Picture pic) { 


Graphics2D g2d = (Graphics2D) (pic. getGraphics()); 
int width = 75; 

int height = 50; 

int center = pic.getWidth()/2; 

int xCoor = center - width/2; 

int yCoor = 75; 


//Create the gradient for painting from yellow to red 
// with yellow at the left of the sun and red at the 
// right. 
GradientPaint gPaint = new GradientPaint( 
xCoor, yCoortheight/2, 
Color. YELLOW, 


xCoor+width eo phat oa ght/ 
Available for free ab oane aaia >!) /cnx. eighty 2 xt /coll1441/1. 181> 


//Set the gradient and draw the ellipse 
g2d. setPaint (gPaint) ; 
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Table 3.438 


-end- 
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3.3.46 Java3030r Review’ 
3.3.46.1 Table of Contents 
e Preface (p. 1047) 
e Questions (p. 1047) 
1 (p. 1047) 


Images (p. 1064) 
Listings (p. 1065) 
Answers (p. 1066) 
Miscellaneous (p. 1066) 


3.3.46.2 Preface 


This module contains review questions and answers keyed to the module titled Java3030: Merging Pictures 
288 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


3.3.46.3 Questions 
3.3.46.3.1 Question 1 


Given the two input images shown in Image 1 (p. 1052) and Image 2 (p. 1056) , which of the following 
two output images is produced by the code in Listing 1 (p. 1048) ? Note that the differences in the two 
possible output images are subtle. Also note the RGB color values shown at the same cursor location in all 
four images. 

A. Image 3 (p. 1060) 

B. Image 4 (p. 1064) 


287 This content is available online at <http://cnx.org/content /m45787/1.2/>. 
88http://cnx.org/content /m44247 
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Listing 1 . Question 1. 


/*File Java3030ra Copyright 2013 R.G.Baldwin 

FAG EEE EEEE EEE I ICI AI I ICI I GI I A E 21 2k EE 21 21 E EEE E EE E 2k EE E / 
import java.awt.Color; 

import java.awt.Graphics2D; 

import java.awt.Graphics; 

import java.awt.GradientPaint ; 

import java.awt.geom.Ellipse2D; 


public class Java3030raf{ 
public static void main(String[] args){ 
new Java3030raRunner().run(); 
}//end main method 
}//end class Java3030ra 


class Java3030raRunner{ 

public void run(){ 
Picture penguin = new Picture("Prob05a. jpg"); 
penguin. explore() ; 
Picture hare = new Picture("Prob05b. jpg"); 
hare.explore() ; 
merge (hare, penguin) ; 
hare.explore(); 

3//end run 


private void merge(Picture left,Picture right) { 
int width = left.getWidth(); 
int height = left.getHeight(); 


double scaleL 
double scaleR 
int redL = 0; 
int greenL = 0; 
int blueL = 0; 
int redR = 0; 
int greenR = 0; 
int blueR = 0; 
Pixel pixelL 
Pixel pixelR 


0; 
0; 


lv 


null; 
null; 


for(int row = O;row < height;row++){ 
for(int col = 0;col < width;col++){ 
scaleR = (double) col/width; 
scaleR *= scaleR; 
scaleL = 1.0 - scaleR; 
pixelL = left.getPixel(col,row) ; 
pixelR = right.getPixel(col,row) ; 


redL = pixediabgebe oben ( Umabkiedds Xhttp://cnx.org/content /coll1441/1.181> 


greenL = pixelL.getColor() .getGreen() ; 
blueL = pixelL.getColor() .getBlue() ; 


redR = pixelR.getColor().getRed(); 
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Table 3.439 
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B Prob05a.jpg 
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Image 1 . One of two input images. 
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Table 3.440 
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Table 3.441 
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Image 3 . Possible output image. 
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Table 3.442 
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Table 3.443 


Answer 1 (p. 1066) 


3.3.46.4 Images 


Image 1 (p. 1052 
Image 2 (p. 1056 
Image 3 (p. 1060 
Image 4 (p. 1064 


One of two input images. 

The second of two input images. 
Possible output image. 

Possible output image. 


Ja 
Ja 
Ja 
). 
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3.3.46.5 Listings 
e Listing 1 (p. 1048) . Question 1. 
What is the meaning of the following two images? 
This image was inserted here simply to insert some space between the questions and the answers to keep 


them from being visible on the screen at the same time. 
The image is also an example of the kinds of things that we do in my course titled ITSE 2321, Object- 


Oriented Programming. 
None ER 


Display your name 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


3.3.46.6 Answers 
3.3.46.6.1 Answer 1 


The code in Listing 1 (p. 1048) produces the output image shown in Image 3 (p. 1060) . 
Back to Question 1 (p. 1047) 


3.3.46.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java3030r Review 
e File: Java3030r.htm 

e Published: 02/18/13 

e Revised 12/08/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.3.47 Java3030s Slides” 
3.3.47.1 Table of Contents 


e Instructions for viewing slides (p. 1067) 
e Miscellaneous (p. 1067) 


3.3.47.2 Instructions for viewing slides 


This module contains lecture slides keyed to the module titled Java3030: Merging Pictures 79° . 


Click here 7°! to open an index to the slides. 

Then use the links beginning with the label "aa" to open the first slide that you want to view in a new 
window in your browser. 

Then use the [Next] and [Prev] links on the individual slides to navigate back and forth through the 
slides. 

You can also use the links on the index page to jump to a particular slide to avoid having to cycle through 
the slides in sequence. 


3.3.47.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Java3030s Slides 
e File: Java3030s.htm 
e Published: 01/06/13 


NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 


289This content is available online at <http://cnx.org/content /m45648/1.2/>. 
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a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4 The Java Collections Framework 


3.4.1 Java4010: Getting Started with Java Collections” 
3.4.1.1 Table of Contents 


e Preface (p. 1069) 
Viewing tip (p. 1069) 
x Listings (p. 1069) 


e Preview (p. 1069) 
e Generics (p. 1070) 
e Introduction (p. 1070) 


A quiz (p. 1070) 

Elements of the Framework are easy to use (p. 1070) 
Don’t reinvent the wheel (p. 1070) 

Collections Framework encourages reuse (p. 1070) 


e Sample program (p. 1070) 
e Interesting code fragments (p. 1071) 


An object of the TreeSet class (p. 1071) 
Collection is an interface (p. 1071) 
What is a TreeSet object? (p. 1071) 
x What does ascending element order mean? (p. 1071) 
What does log(n) time cost mean? (p. 1071) 
A TreeSet object is a Set (p. 1071) 
A TreeSet object is a SortedSet (p. 1072) 
A TreeSet object is a Collection (p. 1072) 
Populate the Collection (p. 1072) 
Don’t know, don’t care (p. 1073) 
Polymorphism in action (p. 1073) 
Add five elements with some duplicates (p. 1073) 
Filter out the duplicates (p. 1073) 
Notification of duplicates (p. 1073) 
Sort the elements (p. 1073) 
The TreeSet object is now populated (p. 1073) 
Get an Iterator object (p. 1074) 
x Again, don’t know, don’t care (p. 1074) 
x An Iterator object acts as a doorkeeper (p. 1074) 
x Traverse the collection (p. 1074) 
x Four elements with no duplicates (p. 1075) 


* 
* 
* 
* 


* * * * * * ¥* 


An editorial opinion (p. 1075) 


?92This content is available online at <http://cnx.org/content /m46135/1.5/>. 
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What kind of knowledge is needed? (p. 1075) 

The same concept applies to software design (p. 1075) 
An analogy (p. 1075) 

Its time to reinvent the CS2 curriculum (p. 1076) 


* * * * 


Run the program (p. 1076) 
Summary (p. 1076) 

What’s next? (p. 1077) 
Miscellaneous (p. 1077) 

Complete program listing (p. 1077) 


3.4.1.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming in 
general and the Java Collections framework in particular. 

The purpose of this module is to introduce you to the Java Collections Framework. Once you learn how 
to use the framework, it is unlikely that you will need to reinvent common data structures, search algorithms, 
or sorting algorithms again, because those capabilities are neatly packaged within the framework. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 79? in 
Oracle’s Java Tutorials 794 . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.1.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


3.4.1.2.1.1 Listings 


Listing 1 (p. 1071) . A new object of the TreeSet class. 
Listing 2 (p ) . Populate the collection. 
Listing 3 (p. 1072) . The Populator class. 
Listing 4 (p. 1074) . Get an Iterator object. 
Listing 5 (p. 1075) . Traverse the collection. 
( ) 


Listing 6 (p. 1078) . Complete program listing 


3.4.1.3 Preview 


This module provides a brief introduction to the use of the Java Collections Framework . The framework 
is designed to encourage you to reuse rather than to reinvent collections and maps. 

A collection represents a group of objects, known as its elements. Some collections allow duplicate 
elements while others do not. Some collections are ordered and others are not. (Maps will be discussed in 
future modules.) 

The Collections Framework is defined by a set of interfaces and associated contracts, and provides 
concrete implementations of the interfaces for the most common data structures. In addition, the framework 
also provides several abstract implementations, which are designed to make it easier for you to create new 
and different implementations while still maintaining the structural polymorphic integrity of the framework. 


293http://docs.oracle.com/javase/tutorial/collections/index.html 
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3.4.1.4 Generics 


The code in this series of modules is written with no thought given to Generics 79° . As a result, if you copy 
and compile the code, you will probably get warnings about unchecked or unsafe operations 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.1.5 Introduction 
3.4.1.5.1 A quiz 


Let’s begin with a little quiz to establish your baseline knowledge of the Collections Framework. Take a look 
at the program in Listing 6 (p. 1078) near the end of this module. Which of the following is the output 
produced by that program? 


A. Compiler Error 
B. Runtime Error 
C. 44321 

D. 12344 

E. 1234 

F. None of the above. 


If your answer was 1234 (and it wasn’t a guess) then you may already know quite a lot about the use of 
the Collections Framework. If not, keep reading to begin learning about the framework. 


3.4.1.5.2 Elements of the Framework are easy to use 


This simple introductory program is not intended to do anything useful. Instead, it was designed to illustrate 
several important features of the framework, including the ease with which elements of the framework can 
be reused in your programs. 


3.4.1.5.3 Don’t reinvent the wheel 


As many of you already know, I am a college professor. I specialize in teaching OOP using Java. In the past, 
many college courses in Data Structures (often referred to as CS2 courses) have emphasized the concept of 
reinventing the wheel . Students were required to learn how to reinvent a variety of complex data structures 
in order to successfully complete the course. 

Hopefully, with the conversion of these CS2 courses to Java OOP, the emphasis will change to reuse 
instead of reinvent 


3.4.1.5.4 Collections Framework encourages reuse 


The Java Collections Framework is designed to encourage programmers to reuse existing interfaces and 
classes instead of inventing new ones. In the event that it is necessary to invent a new class or interface, the 
programmer is encouraged to integrate it into the framework in a polymorphic manner. 


3.4.1.6 Sample program 


I am going to provide a brief discussion of the sample program (shown in Listing 6 (p. 1078) ) in this 
module. Later, I will provide more detailed discussions of many of the features used in that program. 
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3.4.1.7 Interesting code fragments 


I will break this program down and discuss it in fragments. 


3.4.1.7.1 An object of the TreeSet class 


The code fragment in Listing 1 (p. 1071) instantiates an object of the TreeSet class and stores the object’s 
reference in a reference variable of type Collection named ref 


Listing 1 . A new object of the TreeSet class. 


class Worker{ 
public void doIt(){ 
Collection ref = new TreeSet(); 


Table 3.444 


3.4.1.7.2 Collection is an interface 


The TreeSet class implements the SortedSet interface, which extends the Set interface, which in turn 
extends the Collection interface. Thus, a TreeSet object is a Collection . Therefore, a reference 
toa TreeSet object can be stored in a reference variable of type Collection , and can be treated as the 
generic type Collection 


3.4.1.7.3 What is a TreeSet object? 


Among other things, in CS2 courses, we worry about the time and memory cost of a collection. According 
to Sun, the TreeSet class guarantees that the sorted set will be in ascending element order, and provides 
guaranteed log(n) time cost for the basic operations ( add , remove and contains ). 


3.4.1.7.3.1 What does ascending element order mean? 


Again, according to Sun, the elements will be sorted according to the natural order of the elements (see 
the Comparable interface) or by a comparator (see the Comparator interface) provided at the time the 
set is created. This depends on which overloaded constructor is used. I will have more to say about these 
alternatives in a subsequent module. 


3.4.1.7.3.2 What does log(n) time cost mean? 
I’m not going to try to explain the details of log(n) time cost here. Suffice it to say that the add , remove 
, and contains methods execute very fast. (I will have more to say about this is a subsequent module.) 


3.4.1.7.3.3 A TreeSet object is a Set 


An object of the TreeSet class also isa Set . One of the characteristics of a Java Set (an object that 
implements the Set interface) is that it can contain no duplicate elements. Therefore, a TreeSet object 
can contain no duplicate elements. If the add method of a TreeSet object is called in an attempt to 
add a duplicate element, the element will not be added. 
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3.4.1.7.3.4 A TreeSet object is a SortedSet 


The TreeSet class also implements the SortedSet interface. This guarantees that the contents of a 
TreeSet object will be in ascending element order, regardless of the order in which the elements are added. 
(In a subsequent module, I will discuss how comparisons are made to enforce the ordering of the elements.) 


3.4.1.7.3.5 A TreeSet object is a Collection 


Because an object of the TreeSet class isa Collection , a reference to such an object can be passed to 
any method that requires an incoming parameter of type Collection . The receiving method can call any 
method on that reference that is declared in the Collection interface . (I will discuss such methods in 
detail in subsequent modules.) 


3.4.1.7.4 Populate the Collection 


The statement in Listing 2 (p. 1072) passes the TreeSet object’s reference to a method named fillit 
, which is a static method of the Populator class. (The Populator class is a class of my own design 
whose only purpose is to illustrate the polymorphic behavior achieved using the Collections Framework.) 
The behavior of this method is to add elements to the incoming Collection object without regard for the 
actual type of the object (the class from which the object was instantiated). 


Listing 2 . Populate the collection. 


Populator.fillIt (ref); 


Table 3.445 


At this point, I am going to discuss the fillIt method of the Populator class called in Listing 2 (p. 
1072) . The entire class definition of the Populator class, including the fillit method, is shown in Listing 
3 (p. 1072) . 


Listing 3 . The Populator class. 


class Populator{ 

public static void fillIt(Collection ref){ 
ref.add(new Integer (4)); 
ref.add(new Integer (4)); 
ref.add(new Integer (3)); 
ref.add(new Integer (2)); 
ref.add(new Integer(1)); 

}//end fillIt() 

}//end class populator 


Table 3.446 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1068 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


3.4.1.7.4.1 Don’t know, don’t care 


As you can see in the above fragment, the fillIt method receives the reference to the TreeSet object as 
type Collection . This method doesn’t know, and doesn’t care, what the actual type of the object is. All 
it cares about is that the object is a Collection object. (Otherwise, the object’s reference couldn’t be 
passed in as a parameter. A type mismatch would occur.) 

Because the incoming parameter is a reference to a Collection object, the fillIt method can call the 
add method on the object with confidence that the behavior of the add method will be appropriate for 
the specific type of object involved. (For example, the behavior of the add method for an object of the 
TreeSet class will probably be different from the behavior of the add method for an object of some other 
class that implements the Collection interface.) 


3.4.1.7.4.2 Polymorphism in action 


The great thing about polymorphic behavior is that the author of the fillIt method doesn’t need to be 
concerned about the implementation details of the add method. 


3.4.1.7.4.3 Add five elements with some duplicates 


The code in the fillit method adds five elements to the object. Each element is a reference to a new object 
of type Integer . Two of the objects encapsulate the int value 4, and thus are duplicates. 

The int values encapsulated in the Integer objects are not in ascending order. Rather, they are 
added to the object in descending order. (They could be added in any order and the end result would be 
the same.) 


3.4.1.7.4.4 Filter out the duplicates 


The add method for the TreeSet object filters out the duplicate element in order to satisfy the contract 
of the Collection interface. 


3.4.1.7.4.5 Notification of duplicates 


In this case, the author didn’t care what happens in the case of duplicate elements. If the author of the fillIt 
method does care what happens in the case of duplicates, she can find out when an object is a duplicate. 

According to the contract of the Collection interface, the add method must return true if the call 
to the method modifies the contents of the object and must return false if the collection does not permit 
duplicates and the collection already contains the specified element. 


3.4.1.7.4.6 Sort the elements 


Even though the elements are passed to the add method in descending order (or could be passed in any 
other order), they are stored and maintained in the TreeSet object in such a way that they can later be 
accessed in ascending order. 


3.4.1.7.4.7 The TreeSet object is now populated 


When the fillIt method returns, the TreeSet object contains four (not five) elements with no duplicates. 
Each element is a reference to an object of type Integer . Those references are maintained in such a way as 
to make them accessible in ascending order, based on the int values encapsulated in each of the Integer 
objects. 
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3.4.1.7.5 Get an Iterator object 


Returning now to the doIt method in the Worker class that was called in Listing 1 (p. 1071) , the 
statement in Listing 4 (p. 1074) calls the iterator method on the TreeSet object’s reference that is 
stored in the reference variable of type Collection 


Listing 4 . Get an Iterator object. 


Iterator iter = ref.iterator(); 


Table 3.447 


The call to the iterator method on any Collection object returns an instance of a class that 
implements the Iterator interface. The Iterator object can be used to traverse the collection, gaining 
access to each element in order. (The concept of in order means different things for different kinds of 
collections. For a collection instantiated from the TreeSet class, in order means in ascending order.) 


3.4.1.7.5.1 Again, don’t know, don’t care 


Again, the author of the method that uses the Collection object doesn’t need to know or care about the 
internal implementation of the collection, or the implementation of the methods of the Iterator object. 
They simply do what they do, and can be used for their intended purpose. 

3.4.1.7.5.2 An Iterator object acts as a doorkeeper 


The Iterator interface declares three methods: 


hasNext() 
next () 
remove() 


You might say that an Iterator object acts as a doorkeeper for the collection object that it represents, 
providing access to the contents of the collection in a very specific manner. 


3.4.1.7.5.3 Traverse the collection 


The code fragment in Listing 5 (p. 1075) below shows how the first two of the above methods can be used 
to 


e Traverse the collection, accessing each of the object’s elements in succession. 
e Display the value encapsulated in the object referred to by each element. 


As mentioned earlier, when the collection is an object instantiated from the TreeSet class, access to the 
elements is provided in ascending order. 
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Listing 5 . Traverse the collection. 


while(iter.hasNext()){ 
System.out.print(iter.next()); 
}//end while loop 


Table 3.448 


3.4.1.7.5.4 Four elements with no duplicates 


At this point, the TreeSet object contains four elements, with no duplicates. Each of the elements is a 
reference to an object of type Integer . The code in the loop in Listing 5 (p. 1075) causes each of those 
elements to be accessed and displayed in ascending order. This causes the following text to appear on the 
screen: 

1234 


3.4.1.7.6 An editorial opinion 


In my opinion, this is the kind of knowledge that a computer science student in a modern data structures 
course should be learning. This is a far departure from courses of the past where CS2 students were required 
to memorize the intricate details of how to implement various data structures. 


3.4.1.7.6.1 What kind of knowledge is needed? 


Does an architect need to understand the detailed inner workings of an air conditioning compressor in order 
to design a cooling system into a building? Of course not! 

However, the architect does need to know the tradeoffs among the available cooling systems in terms of 
initial cost, operating cost, size, efficiency, etc. 

Does an audio technician need to understand the detailed inner workings of an electronic audio equalizer 
in order to construct an integrated audio system? Absolutely not! If that were a requirement, there would 
likely be very few audio systems in existence. 

However, the audio technician does need to understand the tradeoffs among the various available audio 
equalizers. 


3.4.1.7.6.2 The same concept applies to software design 


Does an OOP software designer need to know the detailed inner workings of the various kinds of collection 
objects in order to use them effectively? No! 

However, the software designer does need to know the tradeoffs among the various types of collection 
objects in terms of their operational behavior. 

Modern CS2 students should be learning about the performance and operational differences among the 
different types of collections, and how to use available frameworks to create and use those collections. They 
should not be wasting their time learning how to reinvent them. They have more important ways to spend 
their time, and they have more important things to learn. 


3.4.1.7.6.3 An analogy 


Frankly, I don’t care how the programmers at Sun implemented the TreeSet class, so long as the behavior 
of objects instantiated from that class meets the published specifications. 
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As an analogy, I also don’t care how they implemented the Random class, so long as objects instantiated 
from the Random class provide the pseudo random values that I need in my programs. 

I see no conceptual differences between the TreeSet class and the Random class from a software 
reuse viewpoint. 


e I can instantiate an object of the Random class to produce pseudo random values, without caring 
how those values are actually generated. However, if I am working in cryptography, I might need to 
know how many such values can be generated before the sequence repeats. 

e I can use any of the thirty or so methods of the Math class to produce a variety of complex 
mathematical values without caring about how those values are actually produced. However, since 
many of those values are approximations, I might need to know something about the quality of the 
approximation. 

e Ican instantiate an object of the TreeSet class to create a collection object, which guarantees that 
the sorted set will be in ascending element order, and provide log(n) time cost for the basic operations 
of add , remove , and contains . As long as I know that, I have very little need to know exactly 
how the collection object is implemented. 


3.4.1.7.6.4 Its time to reinvent the CS2 curriculum 


Pm confident that the future employers of most students share my opinion on this. I don’t know of any 
employer who wants their programmers to spend time and dollars reinventing the classical data structures. 
What those employers are looking for is a staff of programmers who understand the tradeoffs among the 
data structures, and when it is appropriate to use each of the different structures. 

It is time to reinvent the curriculum in CS2 courses by 


e Encouraging the understanding of techniques for software reuse. 
e Teaching when, why, and how each of the different structures should be used. 
e Discouraging the reinvention of those structures. 


3.4.1.8 Run the program 


I encourage you to copy the code from Listing 6 (p. 1078) and paste it into your text editor. Then compile 
and execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 


3.4.1.9 Summary 


In this module, I have provided a brief introduction to the use of the Java Collections Framework . The 
framework is designed to encourage you to reuse rather than to reinvent collections and maps (I will have 
more to say about maps in a future module). 

A collection represents a group of objects, known as its elements. 

While some collections allow duplicate elements, others do not. Some collections are ordered and others 
are not ordered. 

The Collections Framework is defined by a set of interfaces and associated contracts. The framework 
provides concrete implementations of the interfaces (classes) for the most common data structures. In 
addition, the framework also provides several abstract implementations, which are designed to make it easier 
for you to create new and different concrete implementations. 

The TreeSet class is a concrete implementation of the SortedSet interface. The SortedSet 
interface extends Set , which extends Collection . Thus,a TreeSet object isa SortedSet . Also 
it isa Set ,andit isa Collection 
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The TreeSet class guarantees that the sorted set will be in ascending element order, and provides 
guaranteed log(n) time cost for the basic operations ( add , remove and contains ). 

TreeSet objects can be treated as the generic type Collection . Methods declared in the Collection 
interface can be called on a TreeSet object without regard for the actual class from which the object was 
instantiated. (This is polymorphic behavior.) 

When such methods are called, the author of the program can have confidence that the behavior of the 
method will be appropriate for an object of the class from which the object was instantiated. In my opinion, 
this is the true essence of object-oriented behavior. 


3.4.1.10 What’s next ? 


This is the first module in a miniseries on the Collection Framework. Subsequent modules will teach you 
how to use the framework for creating and using various types of collections and maps. 

Once you learn how to use the framework, it is unlikely that you will need to reinvent classical data 
structures, search algorithms, or sorting algorithms, because those capabilities are neatly packaged within 
the framework. 


3.4.1.11 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java0410: Getting Started with Java Collections 
e File: Java0410.htm 

e Published: 04/18/13 

e Revised: 12/08/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


3.4.1.12 Complete program listing 


A complete listing of the program is provided in Listing 6 (p. 1078) below. 
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Listing 6 . Complete program listing. 


import java.util.TreeSet; 
import java.util.Collection; 
import java.util.Iterator; 


public class AP400{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class AP400 


class Worker{ 

public void doIt(){ 
Collection ref = new TreeSet(); 
Populator.fillIt (ref); 
Iterator iter = ref.iterator(); 
while (iter.hasNext())f{ 

System.out.print(iter.next()); 

}//end while loop 
System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt( 
Collection ref){ 
ref.add(new Integer (4)); 
ref.add(new Integer (4)); 
ref.add(new Integer (3)); 
ref.add(new Integer (2)); 
ref.add(new Integer(1)); 
}//end fillIt() 
}//end class populator 


Table 3.449 


-end- 
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3.4.2 Java4010r Review ” 
3.4.2.1 Table of Contents 

e Preface (p. 1079) 

e Questions (p. 1079) 


1 (p. 1079) , 2 (p. 1079) , 3 (p. 1079) , 4 (p. 1079) , 5 (p. 1079) , 6 (p. 1080) , 7 (p. 1081) , 8 
(p. 1081) , 9 (p. 1081) , 10 (p. 1081) , 11 (p. 1081) , 12 (p. 1081) , 13 (p. 1081) , 14 (p. 1081) 
, 15 (p. 1081) , 16 (p. 1082) , 17 (p. 1082) , 18 (p. 1082) , 19 (p. 1082) , 20 (p. 1082) , 21 (p. 
1082) , 22 (p. 1082) , 23 (p. 1082) , 24 (p. 1083) , 25 (p. 1083) 

e Listings (p. 1083) 

e Answers (p. 1084) 

e Miscellaneous (p. 1087) 


3.4.2.2 Preface 
This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 
This module contains review questions and answers keyed to the module titled Java4010: Getting Started 
with Java Collections 297 . 
Once you study that module, you should be able to answer the review questions in this module. 
The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 
3.4.2.3 Questions 
3.4.2.3.1 Question 1 
True or False? The Collections framework is designed to encourage to reinvent collections and maps. 
Answer 1 (p. 1087) 
3.4.2.3.2 Question 2 
True or False? Some collections allow duplicate elements while others do not. 
Answer 2 (p. 1087) 
3.4.2.3.3 Question 3 
True or False? All collections are ordered. 
Answer 3 (p. 1087) 
3.4.2.3.4 Question 4 


True or False? The Collections Framework is defined by a set of interfaces and associated contracts, and 
provides concrete implementations of the interfaces for the most common data structures. 

Answer 4 (p. 1086) 
3.4.2.3.5 Question 5 


Several questions in this module will be based on Listing 1 (p. 1080) below. 


296 This content is available online at <http://cnx.org/content /m48040/1.5/>. 
97 http://cnx.org/content /m46135 /latest /?collection=col11441/latest 
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Listing 1 . Used with several different questions. 


import java.util.TreeSet; 
import java.util.Collection; 
import java.util.Iterator; 


public class AP400{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class AP400 


class Worker{ 

public void doIt(){ 
Collection ref = new TreeSet(); 
Populator.fillIt (ref); 
Iterator iter = ref.iterator(); 
while (iter.hasNext())f{ 

System.out.print(iter.next()); 

}//end while loop 
System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt( 
Collection ref){ 
ref.add(new Integer (4)); 
ref.add(new Integer (4)); 
ref.add(new Integer (3)); 
ref.add(new Integer (2)); 
ref.add(new Integer(1)); 
}//end fillIt() 
}//end class populator 


Table 3.450 


True or False? Listing 1 (p. 1080) instantiates an object of the TreeSet class and stores the object’s 


reference in a reference variable of type Object named ref 


Answer 5 (p. 1086) 


3.4.2.3.6 Question 6 


True or False? The TreeSet class implements the SortedSet interface, which extends the Set interface, 


which in turn extends the Collection interface. 
Answer 6 (p. 1086) 
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3.4.2.3.7 Question 7 


True or False? A reference toa TreeSet object cannot be stored in a reference variable of type Collection 


Answer 7 (p. 1086) 


3.4.2.3.8 Question 8 

True or False? The TreeSet class guarantees that the sorted set will be in ascending element order 
Answer 8 (p. 1086) 

3.4.2.3.9 Question 9 


True or False? The TreeSet class provides guaranteed log(n) time cost for the basic operations ( add , 
remove and contains ). 

Answer 9 (p. 1086) 
3.4.2.3.10 Question 10 


True or False? A TreeSet object can contain duplicate elements. 
Answer 10 (p. 1086) 


3.4.2.3.11 Question 11 

True or False? A TreeSet object is not a SortedSet. 
Answer 11 (p. 1086) 

3.4.2.3.12 Question 12 

True or False? A TreeSet object is a Collection. 
Answer 12 (p. 1086) 

3.4.2.3.13 Question 13 


True or False? Because an object of the TreeSet class is a Collection , a reference to such an object 
can be passed to any method that requires an incoming parameter of type Collection . The receiving 
method can call any method on that reference that is declared in the Collection interface . 

Answer 13 (p. 1086) 


3.4.2.3.14 Question 14 


True or False? The behavior of the fillIt method in Listing 1 (p. 1080) is to add elements to the incoming 
Collection object without regard for the actual type of the object (the class from which the object was 
instantiated). 

Answer 14 (p. 1085) 


3.4.2.3.15 Question 15 


True or False? In Listing 1 (p. 1080) , a reference to an object of type Button (see the Java documentation) 
could be passed as a parameter to the fillIt method. 
Answer 15 (p. 1085) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1077 


3.4.2.3.16 Question 16 


True or False? In Listing 1 (p. 1080) , the fillIt method can call the add method on the incoming object 
with confidence that the behavior of the add method will be appropriate for the specific type of object 
involved. 

Answer 16 (p. 1085) 


3.4.2.3.17 Question 17 


True or False? In Listing 1 (p. 1080) , when the fillIt method returns, the TreeSet object contains five 
elements. 
Answer 17 (p. 1085) 


3.4.2.3.18 Question 18 


True or False? In Listing 1 (p. 1080) , when the fillIt method returns, the TreeSet object contains four 
(not five) elements with no duplicates. Each element is a reference to an object of type Integer . Those 
references are maintained in such a way as to make them accessible in descending order, based on the int 
values encapsulated in each of the Integer objects. 

Answer 18 (p. 1085) 


3.4.2.3.19 Question 19 


True or False? The call to the iterator method on any Collection object returns an instance of a class 
that implements the Iterator interface. 
Answer 19 (p. 1085) 


3.4.2.3.20 Question 20 
True or False? An Iterator object can be used to traverse a Collection object, gaining access to each 
element in order 
Answer 20 (p. 1085) 
3.4.2.3.21 Question 21 
True or False? The concept of in order means the same thing for all Collection objects. 
Answer 21 (p. 1085) 
3.4.2.3.22 Question 22 


True or False? 
The Iterator interface declares three methods: 


e hasNext() 
e next() 
e remove() 


Answer 22 (p. 1084) 


3.4.2.3.23 Question 23 


True or False? The Iterator object associated with a particular Collection object provides access to 
the contents of the collection in a very specific way. 
Answer 23 (p. 1084) 
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3.4.2.3.24 Question 24 


True or False? The while loop in the Worker class in Listing 1 (p. 1080) traverses the collection 


e accessing each of the object’s elements in succession, and 
e displaying the value encapsulated in the object referred to by each element. 


Answer 24 (p. 1084) 


3.4.2.3.25 Question 25 


True or False? Listing 1 (p. 1080) causes the following text to appear on the screen: 
44321 
Answer 25 (p. 1084) 

3.4.2.4 Listings 


e Listing 1 (p. 1080) . Used with several different questions. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


aeti 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


3.4.2.5 Answers 
3.4.2.5.1 Answer 25 
False. Listing 1 (p. 1080) causes the following text to appear on the screen: 
1234 
Back to Question 25 (p. 1083) 
3.4.2.5.2 Answer 24 
True. 
Back to Question 24 (p. 1083) 
3.4.2.5.3 Answer 23 
True. 
Back to Question 23 (p. 1082) 
3.4.2.5.4 Answer 22 


True. 
Back to Question 22 (p. 1082) 
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3.4.2.5.5 Answer 21 


False. The concept of in order means different things for different Collection objects. For a collection 

instantiated from the TreeSet class, for example, in order means in ascending order. However, that may 

not be the case for a different object instantiated from a class that implements the Collection interface. 
Back to Question 21 (p. 1082) 


3.4.2.5.6 Answer 20 


True. 
Back to Question 20 (p. 1082) 


3.4.2.5.7 Answer 19 


True. 
Back to Question 19 (p. 1082) 


3.4.2.5.8 Answer 18 


False. In Listing 1 (p. 1080) , when the fillIt method returns, the TreeSet object contains four (not 
five) elements with no duplicates. Each element is a reference to an object of type Integer . Those 
references are maintained in such a way as to make them accessible in ascending order, based on the int 
values encapsulated in each of the Integer objects. 

Back to Question 18 (p. 1082) 


3.4.2.5.9 Answer 17 


False. In Listing 1 (p. 1080) , when the fillIt method returns, the TreeSet object contains four (not 
five) elements with no duplicates. 
Back to Question 17 (p. 1082) 


3.4.2.5.10 Answer 16 


True. For example, the behavior of the add method for an object of the TreeSet class will probably be 
different from the behavior of the add method for an object of some other class that implements the 
Collection interface. 

Back to Question 16 (p. 1082) 


3.4.2.5.11 Answer 15 


False. The fillIt method receives the reference as type Collection . This method doesn’t know, and 
doesn’t care, what the actual type of the object is. All it cares about is that the object is a Collection 
object. (Otherwise, the object’s reference couldn’t be passed in as a parameter. A type mismatch would 
occur.) A TreeSet object isa Collection because the TreeSet class implements the Collection 
interface. A Button object is not a Collection because the Button class does not implement the 
Collection interface. 

Back to Question 15 (p. 1081) 


3.4.2.5.12 Answer 14 


True. 
Back to Question 14 (p. 1081) 
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3.4.2.5.13 Answer 13 
True. 

Back to Question 13 (p. 1081) 
3.4.2.5.14 Answer 12 
True. 

Back to Question 12 (p. 1081) 
3.4.2.5.15 Answer 11 


False. The TreeSet class implements the SortedSet interface. This guarantees that the contents of a 
TreeSet object will be in ascending element order, regardless of the order in which the elements are added. 
Back to Question 11 (p. 1081) 


3.4.2.5.16 Answer 10 
False. An object of the TreeSet class also is a Set . One of the characteristics of a Java Set 
(an object that implements the Set interface) is that it can contain no duplicate elements. Therefore, a 
TreeSet object can contain no duplicate elements. 
Back to Question 10 (p. 1081) 
3.4.2.5.17 Answer 9 
True. 
Back to Question 9 (p. 1081) 
3.4.2.5.18 Answer 8 
True. 
Back to Question 8 (p. 1081) 
3.4.2.5.19 Answer 7 
False. a TreeSet object isa Collection . Therefore, a reference to a TreeSet object can be stored 
in a reference variable of type Collection , and can be treated as the generic type Collection . 
Back to Question 7 (p. 1081) 
3.4.2.5.20 Answer 6 
True. 
Back to Question 6 (p. 1080) 
3.4.2.5.21 Answer 5 


False. Listing 1 (p. 1080) instantiates an object of the TreeSet class and stores the object’s reference in 
a reference variable of type Collection named ref . 

Back to Question 5 (p. 1079) 
3.4.2.5.22 Answer 4 


True. 
Back to Question 4 (p. 1079) 
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3.4.2.5.23 Answer 3 


False. Some collections are ordered and others are not. 
Back to Question 3 (p. 1079) 


3.4.2.5.24 Answer 2 


True. 
Back to Question 2 (p. 1079) 


3.4.2.5.25 Answer 1 


False. The framework is designed to encourage you to reuse rather than to reinvent collections and maps. 
Back to Question 1 (p. 1079) 


3.4.2.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4010r Review: Java4010: Getting Started with Java Collections 
e File: Java4010r-htm 

e Published: 11/24/13 

e Revised 12/08/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4.3 Java4020: What is a Collection”? 
3.4.3.1 Table of Contents 


Preface (p. 1088) 
Preview (p. 1088) 
Generics (p. 1088) 
Discussion (p. 1088) 


What is a collection? (p. 1088) 


298 This content is available online at <http://cnx.org/content /m46136/1.3/>. 
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Slightly different terminology (p. 1089) 

Store references rather than objects (p. 1089) 

Stored as type Object (p. 1089) 

Moving data among methods (p. 1089) 

Polymorphic behavior (p. 1089) 

Core collection interfaces (p. 1090) 

Concrete implementations (p. 1090) 

Iterator is not a class (p. 1091) 

What about Attributes and RenderingHints? (p. 1091) 
What is a Collections Framework? (p. 1091) 


e Summary (p. 1091) 
e Miscellaneous (p. 1092) 


3.4.3.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

The purpose of this module is to explain some of the details surrounding the use of a Java collection for 
creating data structures. The module also discusses the interfaces and some of the concrete implementations 
in the Java Collections Framework. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 79° in 
Oracle’s Java Tutorials 30° . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.3.3 Preview 


Collection is not only the name of a Java interface, it is also the term given to an object that groups multiple 
elements into a single unit. 

I will discuss the advantages of passing collections between methods as type Collection 

I will summarize the core interfaces in the Collections Framework and show you how they are related. 

I will very briefly discuss some of the concrete implementations of the interfaces that are provided by the 
framework. 

And finally, I will introduce you to the three kinds of things that are part of a collections framework. 


3.4.3.4 Generics 


The code in this series of modules is written with no thought given to Generics 3° . As a result, if you copy 
and compile the code, you will probably get warnings about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.3.5 Discussion 


3.4.3.5.1 What is a collection? 


Just to see if you are awake today, let’s start with a little quiz. 
What is a collection insofar as Java programming is concerned? 


29°http://docs.oracle.com/javase/ tutorial /collections/index.html 
30h ttp://docs.oracle.com/javase/tutorial/index.html 
30Thttp://docs.oracle.com/javase/tutorial/java/generics/index.html 
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A. Something they gather in plates at church. 

B. An object that groups multiple elements into a single unit. 
C. The name of a Java interface. 

D. None of the above. 


If you answered A, you are probably reading an article on the wrong website by mistake. If you answered 
Both B and C , then you are off to a good start on this module. 

Collection is the name of a Java interface. This interface is an integral part of the Java Collections 
Framework . Collection is one of two top-level interfaces in the framework. The other top-level interface 
in the framework is named Map 

According to The Java Tutorial from Oracle, a collection (sometimes called a container) is also an object 
that groups multiple elements into a single unit. 

Typical collection objects might contain information about employees in the company telephone book, all 
the purchase orders issued during the past year, or the transactions occurring in a person’s checking account. 


3.4.3.5.2 Slightly different terminology 


Note that this terminology may be somewhat different from what you are accustomed to. For example, if you 
speak of your coin collection, you are probably speaking about the actual coins rather than the container 
that holds the coins. 

This is an important distinction. The usage of the term collection in the Collection Framework usually 
refers to the container and not to the contents of the container. In the framework, the contents are usually 
referred to as elements 


3.4.3.5.3 Store references rather than objects 


The collections in the framework always store references to objects, rather than storing the objects them- 
selves. One consequence of this is that primitive values cannot be stored in a collection without first 
encapsulating them in an object. (Standard wrapper classes are provided for encapsulating all primitive 


types.) 


3.4.3.5.4 Stored as type Object 


Furthermore, the references are always stored as type Object . Prior to Java version 1.5, when you 
retrieved an element from a collection, you frequently needed to downcast it before you could gain access to 
the members of the object to which the reference refers. Version 1.5 introduced Generics °°? into the Java 
programming environment, which eliminated that requirement, (provided that you use the more complex 
syntax required by Generics) . 


3.4.3.5.5 Moving data among methods 


In addition to their use for storing, retrieving, and manipulating data, collections are also used to move data 
among methods. 

One of the primary advantages of the Collections Framework is the ability to pass a collection to a method 
as the generic interface type Collection . The receiving method doesn’t need to know the actual type of 
the object referred to by the incoming reference in order to call its methods. 


3.4.3.5.6 Polymorphic behavior 


The receiving method can call (on the reference to the Collection object) any of the methods declared 
in the Collection interface, with confidence that the behavior of the method will be appropriate for the 
actual type of Collection object involved. (That is polymorphic behavior.) 


302http://docs.oracle.com/javase/tutorial/java/generics/index.html 
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3.4.3.5.7 Core collection interfaces 


If you have been working with the framework, you might be inclined to think that all of the interfaces in the 
following list are members of the core collection interfaces. 


Collection 
Set 

List 

Queue 
Deque 
SortedSet 
Map 
SortedMap 
Iterator 


However, that is not the case. 

While the Iterator interface is heavily used in conjunction with collections, according to The Java 
Tutorial from Oracle, it is not one of the core collection interfaces. 

The core collection interfaces identified by the Oracle book are shown below, with indentation showing 
the superinterface-subinterface relationships among the interfaces. 


e Collection 


Set 
x SortedSet 
List 
Queue 
Deque 


e Map 
SortedMap 


As you can see, as mentioned earlier, Collection and Map are the two top-level interfaces. 
You should probably commit the above list of interfaces and their relationships to memory. You might 
find that helpful when navigating the Oracle documentation. 


3.4.3.5.8 Concrete implementations 


In addition to interfaces, the framework provides several concrete implementations of the interfaces defined 
in the framework. (A concrete implementation is a class that implements one or more of the interfaces.) 
Are you still awake? If so, see if you can answer the following question. 
True or False? Each of the following classes provides an implementation of one of the interfaces that 
make up the Java Collections Framework. If False, which items don’t belong in the list. 


Abstract Set 
Abstract List. 
Abstract Map 
HashSet 
TreeSet 
LinkedList 
Vector 
ArrayList 
HashMap 
Hashtable 
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WeakHashMap 
TreeMap 
Iterator 
Attributes 
RenderingHints 


Hopefully your answer was False, but even so, that isn’t the complete answer. 


3.4.3.5.9 Iterator is not a class 


To begin with, Iterator is not a class. I told you that a couple of paragraphs back. It is an interface. 
Therefore, it has no place in the above list of classes. 


3.4.3.5.10 What about Attributes and RenderingHints? 


You may also have wondered if the classes named Attributes and RenderingHints belong on the 
list. Note that I didn’t restrict the above list to only those classes that might be considered part of the 
framework, so this was sort of a trick question. (Of course you could have looked them up in the Oracle 
documentation just like I did.) 

While these two classes are not really a part of the core Java Collections Framework, they do implement 
interfaces that are part of the framework. 

The RenderingHints class implements the Map interface, and is used in conjunction with the 
Graphics2D class. The Attributes class also implements the Map interface, 


3.4.3.5.11 What is a Collections Framework? 


According to The Java Tutorial from Oracle, "A collections framework is a unified architecture for repre- 
senting and manipulating collections. All collections frameworks contain three things." 
Those three things are: 


e Interfaces 
e Implementations 
e Algorithms 


This is probably a good place to close off the discussion for this module. The next module will take up 
at this point, providing a more in-depth discussion of the interfaces, implementations, and algorithms that 
make up the framework. 


3.4.3.6 Summary 


I started out by telling you that a collection is not only the name of a Java interface (Collection) but is 
also an object that groups multiple elements into a single unit. 

Java Collection objects don’t store objects or primitive values directly. Rather, they store references 
to objects. Further, all such references are stored as the type Object . However, the use of the Generics 
syntax can eliminate the need to downcast the reference in order to gain access to the members of the object 
to which it refers. (Generics also provide other useful properties as well.) 

If you need to store primitive values in a collection, you will first need to wrap those values in appropriate 
objects. Standard wrapper classes are provided for all the primitive types. 

Collections are not only useful for storing and retrieving data, they are also useful for moving data among 
methods. 

Because a collection can be passed to a method as type Collection , all of the methods declared in 
the Collection interface can be called on the incoming reference in a polymorphic manner. 

In addition to the interfaces defined in the Collections Framework, the framework also provides various 
concrete implementations of the interfaces for many of the commonly-used data structures. This makes 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1087 


it possible for you to conveniently use the framework without the requirement to define new Collection 
classes. 

There are eight core interfaces in the Collections Framework. Although the Iterator interface is often 
used with collections, it is not one of the core interfaces. 

I ended the module by telling you that there are basically three things in a collections framework: 
interfaces, implementations, and algorithms. 


3.4.3.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4020: What is a Collection 
e File: Java4020.htm 

e Published: 04/18/13 

e Revised: 05/07/13 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.4.4 Java4020r Review” 
3.4.4.1 Table of Contents 


e Preface (p. 1093) 
e Questions (p. 1093) 


1 (p. 1093) , 2 (p. 1093) , 3 (p. 1093) , 4 (p. 1093) , 5 (p. 1094) , 6 (p. 1094) , 7 (p. 1094) , 8 
(p. 1094) , 9 (p. 1094) , 10 (p. 1094) , 11 (p. 1094) , 12 (p. 1095) , 13 (p. 1095) 


e Answers (p. 1097) 
e Miscellaneous (p. 1098) 


3.4.4.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4020: What is a 
Collection 304 . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.4.3 Questions 


3.4.4.3.1 Question 1 


True or False? Collection is the name of a Java interface. It is also the term given to an object that 
groups multiple elements into a single unit. (A collection of rabbits for example.) 
Answer 1 (p. 1098) 


3.4.4.3.2 Question 2 


What is a collection insofar as Java programming is concerned? 


A. Something they gather in plates at church. 

B. An object that groups multiple elements into a single unit. 
C. The name of a Java interface. 

D. None of the above. 


Answer 2 (p. 1098) 


3.4.4.3.3 Question 3 


True or False? Collection is the name of a Java interface. This interface is an integral part of the Java 
Collections Framework . 
Answer 3 (p. 1098) 


3.4.4.3.4 Question 4 


True or False? Collection is one of three top-level interfaces in the framework. The other top-level 
interfaces in the framework are named Map and ArrayList 
Answer 4 (p. 1097) 


303This content is available online at <http://cnx.org/content /m48041/1.3/>. 
304 http://cnx.org/content /m46136/latest /?collection=col1 1441 /latest 
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3.4.4.3.5 Question 5 
True or False? The usage of the term collection in the Collection Framework usually refers to the container 


and not to the contents of the container. In the framework, the contents are usually referred to as elements 


Answer 5 (p. 1097) 


3.4.4.3.6 Question 6 


True or False? The collections in the framework always store objects as opposed to the object’s references. 
Answer 6 (p. 1097) 


3.4.4.3.7 Question 7 


True or False? Values of all types, including primitive values, can be stored in a collection. 
Answer 7 (p. 1097) 


3.4.4.3.8 Question 8 


True or False? Object’s references are always stored in a collection as type Collection . 
Answer 8 (p. 1097) 


3.4.4.3.9 Question 9 


True or False? When a method receives an incoming parameter as type Collection, the method can call 
(on the reference to the Collection object) any of the methods declared in the Collection interface, with 
confidence that the behavior of the method will be appropriate for the actual type of Collection object 
involved. (That is polymorphic behavior.) 

Answer 9 (p. 1097) 


3.4.4.3.10 Question 10 


True or False? The Iterator interface is one of the core collection interfaces. 
Answer 10 (p. 1097) 


3.4.4.3.11 Question 11 


True or False? The core collection interfaces are shown below, with indentation showing the superinterface- 
subinterface relationships among the interfaces. 


e Collection 
Set 
x SortedSet 
List 
Queue 
Deque 


e Map 
SortedMap 


Answer 11 (p. 1097) 
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3.4.4.3.12 Question 12 


True or False? Each of the following classes provides an implementation of one of the interfaces that make 
up the Java Collections Framework. (See the Java documentation.) 


Abstract Set 
Abstract List, 
AbstractMap 
HashSet 
TreeSet 
LinkedList 
Vector 
ArrayList 
HashMap 
Hashtable 
WeakHashMap 
TreeMap 
Iterator 
Attributes 
RenderingHints 


Answer 12 (p. 1097) 


3.4.4.3.13 Question 13 


True or False? 
A collections framework is a unified architecture for representing and manipulating collections. All 
collections frameworks contain three things. Those three things are: 


e Interfaces 
e Implementations 
e Algorithms 


Answer 13 (p. 1097) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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3.4.4.4 Answers 
3.4.4.4.1 Answer 13 
True according to The Java Tutorial from Oracle 
Back to Question 13 (p. 1095) 
3.4.4.4.2 Answer 12 
False. Iterator is not a class. It is an interface. Therefore, it has no place in the given list of classes. 
Back to Question 12 (p. 1095) 
3.4.4.4.3 Answer 11 
True. With respect to an earlier question, Collection and Map are the two top-level interfaces. 
Back to Question 11 (p. 1094) 
3.4.4.4.4 Answer 10 
False. While the Iterator interface is heavily used in conjunction with collections, according to The Java 
Tutorial from Oracle, it is not one of the core collection interfaces. 
Back to Question 10 (p. 1094) 
3.4.4.4.5 Answer 9 
True. 
Back to Question 9 (p. 1094) 
3.4.4.4.6 Answer 8 
False. Object’s references are always stored as type Object 
Back to Question 8 (p. 1094) 
3.4.4.4.7 Answer 7 


False. Primitive values cannot be stored in a collection without first encapsulating them in an object. 
(Standard wrapper classes are provided for encapsulating all primitive types.) 

Back to Question 7 (p. 1094) 
3.4.4.4.8 Answer 6 


False. The collections in the framework always store references to objects, rather than storing the objects 
themselves. 
Back to Question 6 (p. 1094) 
3.4.4.4.9 Answer 5 
True. 
Back to Question 5 (p. 1094) 
3.4.4.4.10 Answer 4 


False. Collection is one of two top-level interfaces in the framework. The other top-level interface in the 
framework is named Map 
Back to Question 4 (p. 1093) 
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True. 
Back to Question 3 (p. 1093) 


3.4.4.4.12 Answer 2 
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If you answered A, you are probably reading an article on the wrong website by mistake. If you answered 


both 


B and C , then you are off to a good start on this module. 


Back to Question 2 (p. 1093) 


3.4.4.4.13 Answer 1 


True. 
Back to Question 1 (p. 1093) 


3.4.4.5 Miscellaneous 


This 


section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java20r Review 
e File: Java20r.htm 
e Published: 11/24/13 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4. 


5 Java4030: Purpose of Framework Interfaces’” 


3.4.5.1 Table of Contents 


Preface (p. 1099) 
Preview (p. 1099) 
Generics (p. 1100) 
Discussion (p. 1100) 


Purpose of framework interfaces (p. 1100) 


3°5This content is available online at <http://cnx.org/content /m46140/1.4/>. 
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What is a data type? (p. 1100) 

Interface is a type (p. 1100) 

Collection interface declares several methods (p. 1100) 
An extra step (p. 1100) 

The add method in Collection (p. 1101) 
The add method in Set (p. 1101) 

How do the contracts differ? (p. 1101) 
What about the List interface? (p. 1101) 
A major difference (p. 1102) 

Designing a framework (p. 1102) 
Concrete implementations (p. 1102) 


e Summary (p. 1102) 
e Miscellaneous (p. 1103) 


3.4.5.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

There are eight core interfaces in the Collections Framework . Each interface declares several methods 
and provides a contract that applies to each declared method. The method declarations and their associated 
contracts specify the general behavior of matching methods in the classes that implement the interfaces. 

The purpose of this module is to provide a brief explanation of those interfaces. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail °°° in 
Oracle’s Java Tutorials 30°” . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.5.3 Preview 
At least three things are included in a collections framework: 


e interfaces 
e implementations 
e algorithms 


This module will discuss the purpose of the interfaces in the Collections Framework. Future modules will 
discuss implementations and algorithms. 


3.4.5.4 Introduction 


In an earlier module, we learned that the Collections Framework contains eight core interfaces with the 
parent-child relationships shown below 


e Collection 


Set 
x SortedSet 
List 
Queue 
Deque 
e Map 
SortedMap 


396 http:/ /docs.oracle.com/javase/tutorial/collections/index-html 
3°7http://docs.oracle.com/javase /tutorial/index.html 
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3.4.5.5 Generics 


The code in this series of modules is written with no thought given to Generics 3 . As a result, if you copy 
and compile the code, you will probably get warnings about unchecked or unsafe operations 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.5.6 Discussion 
3.4.5.6.1 Purpose of framework interfaces 


A collection is an object of some type, and that type is defined in a generic sense by one or more interfaces 
that make up the Collections Framework. 


3.4.5.6.2 What is a data type? 


All data types specify the operations that can be performed on an entity of that type. (Data types also 
specify the kinds of data that can be stored in an entity of that type, but that is not germane to this 
discussion.) 


3.4.5.6.3 Interface is a type 


An object in Java can often be considered to be of several different types. One of those types is determined 
by any interfaces implemented by the class from which the object was instantiated. Framework collection 
objects in Java are instantiated from classes that implement the core interfaces of the Collections Framework. 
Thus, a Java interface in the Collections Framework specifies the type of such an object, and provides a 
generic representation of the operations that apply across different implementations of the interface. 


3.4.5.6.4 Collection interface declares several methods 


The Collection interface declares several methods. This is not unusual. From a technical standpoint, all 
interfaces declare none, one, or more methods. Most interfaces declare multiple methods. (Interfaces can 
also declare constants, but that is not germane to this discussion.) 

In general, there is no technical requirement for a specification of the behavior of the interface methods 
when implemented in a class. In fact, because a method that is declared in an interface is abstract, it 
specifically refrains from defining the behavior of the method. The interface definition simply declares the 
interfaces for all the methods that it declares. 

We have now arrived at one of the differences that distinguish the Collections Framework from "just a 
bunch of interfaces." That difference is contracts 


3.4.5.6.5 An extra step 


The Oracle documentation for the Collection interface goes a step beyond the minimum technical require- 
ments for an interface. The documentation describes the general behavior that must be exhibited by each 
of the methods belonging to an object instantiated from a class that implements the Collection interface. 
This is sometimes referred to as a contract 

Therefore, if you define a class that implements the Collection interface in a manner consistent with 
the Collections Framework , it is important that you make certain that each of your methods behaves as 
described in the Oracle documentation. In other words, you must be careful to comply with the contract 
defined for those methods. If you don’t do that, a user can’t rely on objects instantiated from your class to 
exhibit proper behavior. 


3°8http://docs.oracle.com/javase/tutorial/java/generics/index.html 
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3.4.5.6.6 The add method in Collection 


For example, the Collection interface declares a method named add that receives an incoming reference 
of a generic type (see Generics 9°° ) and returns a boolean .. Here is some text from the Oracle 
documentation describing the required behavior (contract) of the add method for any class that implements 
the Collection interface. 

"Ensures that this collection contains the specified element (optional operation). Returns true if this 
collection changed as a result of the call. (Returns false if this collection does not permit duplicates and 
already contains the specified element.) 

Collections that support this operation may place limitations on what elements may be added to this 
collection. In particular, some collections will refuse to add null elements, and others will impose restrictions 
on the type of elements that may be added. 

Collection classes should clearly specify in their documentation any restrictions on what elements may be 
added. If a collection refuses to add a particular element for any reason other than that it already contains 
the element, it must throw an exception (rather than returning false). This preserves the invariant that a 
collection always contains the specified element after this call returns." 

As you can see, the behavior is defined in a very general way. There is no indication as to how that 
behavior is to be achieved. 


3.4.5.6.7 The add method in Set 


As you can see from the list above (p. 1099) , the Set interface extends the Collection interface. 
In keeping with the general form of object-oriented design, Set is more specialized than Collection 
Therefore, Set makes the contract for the add method more specific for objects of type Set . Here 
is some text from the Oracle documentation describing the contract of the add method for any class that 
implements the Set interface. 

"Adds the specified element to this set if it is not already present (optional operation). More formally, 
adds the specified element e to this set if the set contains no element e2 such that (e==null ? e2==null : 
e.equals(e2)). 

If this set already contains the element, the call leaves the set unchanged and returns false. In combination 
with the restriction on constructors, this ensures that sets never contain duplicate elements. 

The stipulation above does not imply that sets must accept all elements; sets may refuse to add any 
particular element, including null, and throw an exception, as described in the specification for Collection.add. 
Individual set implementations should clearly document any restrictions on the elements that they may 
contain." 


3.4.5.6.8 How do the contracts differ? 


The contract for the add method, as declared in the Collection interface, does not prohibit duplicate 
elements, but does make the provision for interfaces that extend Collection to prohibit duplicate elements. 
The contract for the add method in the Set interface does prohibit duplicate elements. 


3.4.5.6.9 What about the List interface? 


Here is some text from the Oracle documentation describing the contract of the add method for any class 
that implements the List interface. 

"A ppends the specified element to the end of this list (optional operation). 

Lists that support this operation may place limitations on what elements may be added to this list. 
In particular, some lists will refuse to add null elements, and others will impose restrictions on the type of 
elements that may be added. List classes should clearly specify in their documentation any restrictions on 
what elements may be added." 


309http://docs.oracle.com/javase/tutorial/java/generics/index.html 
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As you can see, the contract for the add method declared in the List interface, (which extends 
Collection) , does not prohibit duplicate elements. However, it does have some other requirements that 
don’t apply to Set objects. For example, it must add new elements at the end of the list. 


3.4.5.6.10 A major difference 


This is one of the major differences between lists and sets in the Java Collection Framework. Both List 
objects and Set objects are collections, because both of the interfaces extend the Collection interface. 
However, the Set interface contract prohibits duplicate elements while the List interface contract does 
not prohibit duplicate elements. 


3.4.5.6.11 Designing a framework 


In theory, it should be possible (but perhaps not very practical) to define a framework consisting solely of 
interface definitions and associated contracts for methods and algorithms. Then each user could implement 
the interfaces however they see fit, provided that they comply with the contracts. (This might not be very 
practical, however, because every user of the framework would then be required to implement the interfaces, 
which would entail a lot of work.) 


3.4.5.6.12 Concrete implementations 


Fortunately, Oracle didn’t stop work after defining the interfaces and contracts for the Java Collections 
Framework. Rather, they also provided us with several useful classes that implement the interfaces in 
the framework. Thus, we can instantiate and use objects of those classes immediately without having to 
define them ourselves. Here is a list of some of the concrete implementation classes in the Java Collections 
Framework: 


HashSet 
TreeSet 
LinkedList 
Vector 
ArrayList 
HashMap 
Hashtable 
WeakHashMap 
TreeMap 


In addition, Oracle provided us with several partial implementation classes including AbstractSet , 
AbstractList , and AbstractMap , which are intended to serve a starting point for new implementations 
that we choose to define. According to Oracle, these classes provide a skeletal implementation of the Set, 
List, and Map interfaces to minimize the effort required to implement those interfaces. 


3.4.5.7 Summary 


There are eight core interfaces in the Collections Framework. 

As is always the case, each of the core interfaces defines a data type. Each interface declares several 
methods. In addition, each interface provides a contract that applies to each declared method. The contracts 
become more specific as we traverse down the interface inheritance hierarchy. 

Objects instantiated from classes that implement the interfaces can be considered to be of the interface 
type or any ancestor interface in the interface’s hierarchical family tree. 

The method declarations and their associated contracts in the interfaces specify the general behavior of 
matching methods in the classes that implement the interfaces. 
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The framework provides several concrete implementations of the interfaces that we can use to instantiate 
new objects to use as data structures or data containers. 

The framework also provides several abstract implementations that we can use as a starting point for 
defining our own implementations. 


3.4.5.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4030: Purpose of Framework Interfaces 
e File: Java4030.htm 

e Published: 04/18/13 

e Revised: 03/16/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1099 


3.4.6 Java4030r Review” 
3.4.6.1 Table of Contents 


e Preface (p. 1104) 
e Questions (p. 1104) 


1 (p. 1104) , 2 (p. 1104) , 3 (p. 1104) , 4 (p. 1104) , 5 (p. 1105) , 6 (p. 1105) , 7 (p. 1105) , 8 
(p. 1105) , 9 (p. 1105) , 10 (p. 1105) , 11 (p. 1105) , 12 (p. 1105) , 13 (p. 1105) , 14 (p. 1106) , 
15 (p. 1106) , 16 (p. 1106) , 17 (p. 1106) , 18 (p. 1106) , 19 (p. 1106) , 20 (p. 1106) 


e Answers (p. 1108) 
e Miscellaneous (p. 1110) 


3.4.6.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4030: Purpose of 
Framework Interfaces 311 . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.6.3 Questions 

3.4.6.3.1 Question 1 

True or False? There are eight core interfaces in the Collections Framework . 
Answer 1 (p. 1110) 


3.4.6.3.2 Question 2 


True or False? Each of the core interfaces in the Collections Framework declares several methods and 
provides a contract that applies to each declared method. 
Answer 2 (p. 1110) 


3.4.6.3.3 Question 3 


True or False? The method declarations in the core interfaces in the Collections Framework specify the 
general behavior of matching methods in the classes that implement the interfaces without regard for the 
contracts associated with those methods. 

Answer 3 (p. 1110) 


3.4.6.3.4 Question 4 


True or False? At least four things are included in a collections framework: 


interfaces 
implementations 
algorithms 
variables 


Answer 4 (p. 1110) 


310This content is available online at <http://cnx.org/content /m48043/1.2/>. 
311 http://cnx.org/content /m46140/latest /?collection=coll 1441 /latest 
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3.4.6.3.5 Question 5 


True or False? In Java, a collection is an object of some type, and that type is defined in a generic sense 
by one or more interfaces that make up the Collections Framework. 
Answer 5 (p. 1110) 


3.4.6.3.6 Question 6 


True or False? All data types specify the operations that can be performed on an entity of that type as well 
as the kinds of data that can be stored in an entity of that type. 
Answer 6 (p. 1110) 


3.4.6.3.7 Question 7 


True or False? An object in Java can often be considered to be of several different types. 
Answer 7 (p. 1110) 


3.4.6.3.8 Question 8 


True or False? While a class in Java represents a data type, the same is not true for a Java interface. 
Answer 8 (p. 1109) 


3.4.6.3.9 Question 9 


True or False? Framework collection objects in Java are instantiated from classes that implement the core 
interfaces of the Collections Framework. 
Answer 9 (p. 1109) 


3.4.6.3.10 Question 10 


True or False? A Java interface in the Collections Framework specifies the type of an object instantiated 
from a class that implements the interface. The interface also provides a generic representation of the 
operations that apply across different implementations of the interface. 

Answer 10 (p. 1109) 


3.4.6.3.11 Question 11 


True or False? Methods declared in an interface specify the behavior of the corresponding methods when 
defined in classes that implement the interface. 
Answer 11 (p. 1109) 


3.4.6.3.12 Question 12 


True or False? One of the things that distinguishes the Collections Framework from "just a bunch of 
interfaces" is the existence of contracts associated with the framework. 
Answer 12 (p. 1109) 


3.4.6.3.13 Question 13 


True or False? The Java documentation describes the general behavior that must be exhibited by each of 
the methods belonging to an object instantiated from a class that implements the Collection interface. 
This is sometimes referred to as a contract . 

Answer 13 (p. 1109) 
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3.4.6.3.14 Question 14 


True or False? If you define a class that implements the Collection interface in a manner consistent with 
the Collections Framework , you need not make certain that each of your methods behaves as described in 
the Oracle documentation. 

Answer 14 (p. 1109) 


3.4.6.3.15 Question 15 


True or False? A contract in the Collections Framework defines the behavior of declared methods in a 
very general way. There is no indication as to how that behavior is to be achieved. 
Answer 15 (p. 1109) 


3.4.6.3.16 Question 16 


True or False? According to a contract of the Set interface, objects that implement the Set interface are 
allowed to contain duplicate elements. 
Answer 16 (p. 1109) 


3.4.6.3.17 Question 17 


True or False? According to a contract of the Collection interface, objects that implement the Collection 
are never allowed to contain duplicate elements. 
Answer 17 (p. 1108) 


3.4.6.3.18 Question 18 


True or False? The contract for the add method declared inthe List interface, (which extends Collection) 
, does not prohibit duplicate elements. 
Answer 18 (p. 1108) 


3.4.6.3.19 Question 19 


True or False? The List interface contract prohibits duplicate elements while the Set interface contract 
does not prohibit duplicate elements. 
Answer 19 (p. 1108) 


3.4.6.3.20 Question 20 


True or False? The classes in the following list are concrete implementation classes in the Java Collections 
Framework: 


HashSet 
TreeSet 
LinkedList 
Vector 
ArrayList 
HashMap 
Hashtable 
WeakHashMap 
TreeMap 
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Answer 20 (p. 1108) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None KEX] 


Display your name 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


3.4.6.4 Answers 
3.4.6.4.1 Answer 20 
True. 
Back to Question 20 (p. 1106) 
3.4.6.4.2 Answer 19 


False. The Set interface contract prohibits duplicate elements while the List interface contract does not 
prohibit duplicate elements. 
Back to Question 19 (p. 1106) 


3.4.6.4.3 Answer 18 
True. 
Back to Question 18 (p. 1106) 


3.4.6.4.4 Answer 17 


False. The contract for the add method, as declared in the Collection interface, does not prohibit 
duplicate elements, but does make the provision for interfaces that extend Collection to prohibit duplicate 
elements. The contract for the add method in the Set interface does prohibit duplicate elements. 

Back to Question 17 (p. 1106) 
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3.4.6.4.5 Answer 16 


False. According to a contract of the Set interface, objects that implement the Set interface never 
contain duplicate elements. 
Back to Question 16 (p. 1106) 


3.4.6.4.6 Answer 15 
True. 
Back to Question 15 (p. 1106) 


3.4.6.4.7 Answer 14 


False. If you define a class that implements the Collection interface in a manner consistent with the 
Collections Framework , you must make certain that each of your methods behaves as described in the 
Oracle documentation. In other words, you must be careful to comply with the contract defined for those 
methods. If you don’t do that, a user can’t rely on objects instantiated from your class to exhibit proper 
behavior. 

Back to Question 14 (p. 1106) 


3.4.6.4.8 Answer 13 
True. 

Back to Question 13 (p. 1105) 
3.4.6.4.9 Answer 12 
True. 

Back to Question 12 (p. 1105) 
3.4.6.4.10 Answer 11 


False. there is no technical requirement for a specification of the behavior of the interface methods when 
implemented in a class. In fact, because a method that is declared in an interface is abstract, it specifically 
refrains from defining the behavior of the method. The interface definition simply declares the interfaces for 
all the methods that it declares. 

Back to Question 11 (p. 1105) 


3.4.6.4.11 Answer 10 
True. 

Back to Question 10 (p. 1105) 
3.4.6.4.12 Answer 9 
True. 

Back to Question 9 (p. 1105) 
3.4.6.4.13 Answer 8 


False. An object in Java can often be considered to be of several different types. One of those types is 
determined by any interfaces implemented by the class from which the object was instantiated. 
Back to Question 8 (p. 1105) 
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3.4.6.4.14 Answer 7 
True. 

Back to Question 7 (p. 1105) 
3.4.6.4.15 Answer 6 
True. 

Back to Question 6 (p. 1105) 
3.4.6.4.16 Answer 5 
True. 

Back to Question 5 (p. 1105) 
3.4.6.4.17 Answer 4 
False. 


At least three things are included in a collections framework: 


e interfaces 
e implementations 
e algorithms 


Variables are not necessarily one of those things. 


Back to Question 4 (p. 1104) 


3.4.6.4.18 Answer 3 
False. 

Back to Question 3 (p. 1104) 
3.4.6.4.19 Answer 2 
True. 

Back to Question 2 (p. 1104) 
3.4.6.4.20 Answer 1 
True. 

Back to Question 1 (p. 1104) 


3.4.6.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4030r Review 


e File: Java4030r.htm 
e Published: 11/24/13 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 

In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4.7 Java4040: Purpose of Framework Implementations and Algorithms” ’” 


3.4.7.1 Table of Contents 


e Preface (p. 1112) 
Viewing tip (p. 1112) 
x Listings (p. 1112) 
Preview (p. 1112) 
Generics (p. 1112) 


Introduction (p. 1113) 
Discussion and sample code (p. 1113) 


Purpose of implementations (p. 1113) 

x Available for immediate use (p. 1113) 

* Vector and Hashtable classes (p. 1113) 

x Abstract implementations (p. 1113) 

Purpose of algorithms (p. 1114) 

* The contains method 

x Different classes, different implementations (p. 1114) 
A sample program (p. 1114) 

x Instantiate and populate a TreeSet object (p. 1116) 
Instantiate and populate an ArrayList object (p. 1116) 
Identify a target element (p. 1116) 

Search for the test value in each collection (p. 1117) 
Program output (p. 1118) 

Time required to search the ArrayList collection (p. 1118) 
Time required to search the TreeSet collection (p. 1118) 
Different implementations (p. 1118) 

x Polymorphic behavior applies (p. 1118) 


* * * * * * * 


Sorting algorithms (p. 1118) 

Now for a little quiz (p. 1119) 
x And the answer is ... (p. 1119) 
x Drive home the point (p. 1119) 


312This content is available online at <http://cnx.org/content /m46137/1.6/>. 
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Benefits of using the Collections Framework (p. 1119) 


e Run the program (p. 1120) 
e Summary (p. 1120) 
e Miscellaneous (p. 1121) 


3.4.7.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

This module explains how the core collection interfaces in the Java Collections Framework allow collec- 
tions to be manipulated without regard for how they are implemented. The framework provides nine or more 
concrete implementations of the interfaces. The framework also provides various algorithms for manipulating 
the data in the collections. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 313 in 
Oracle’s Java Tutorials 314 . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.7.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


3.4.7.2.1.1 Listings 


e Listing 1 (p. 1115) . SpeedTest01. 

e Listing 2 (p. 1116) . Beginning of the doIt method. 

e Listing 3 (p. 1116) . Instantiate and populate an ArrayList object. 
e Listing 4 (p. 1117) . Identify a target element. 

e Listing 5 (p. 1117) . Search for the test value in each collection. 


3.4.7.3 Preview 


At least three things are included in the Java Collections Framework: 


e interfaces 
e implementations 
e algorithms 


The previous module discussed the purpose of the interfaces. This module will discuss the purpose of the 
implementations and the algorithms in the Collections Framework. 


3.4.7.4 Generics 


The code in this series of modules is written with no thought given to Generics 315 . As a result, if you copy 
and compile the code, you will probably get warnings about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


313http://docs.oracle.com/javase/tutorial/collections/index.html 
314http://docs.oracle.com/javase /tutorial/index.html 
315http://docs.oracle.com/javase/tutorial/java/generics/index.html 
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3.4.7.5 Introduction 


We learned in an earlier module that the framework provides at least nine concrete implementations of the 
interfaces in the framework. These nine implementation classes are available for immediate instantiation to 
produce objects to satisfy your collection needs. 

We also learned that the framework provides at least three incomplete implementations. These classes are 
available for you to use as a starting point in defining your own implementations. Default implementations 
of many of the interface methods are provided in the incomplete implementations. 


3.4.7.6 Discussion and sample code 
3.4.7.6.1 Purpose of implementations 


The implementations in the Java Collections Framework are the concrete definitions of the classes that 
implement the core collection interfaces . For example, concrete implementations in the Java Collections 
Framework are provided by at least the following nine classes. 


HashSet 
TreeSet 
LinkedList 
ArrayList 
Vector 
HashMap 
WeakHashMap 
TreeMap 
Hashtable 


3.4.7.6.1.1 Available for immediate use 


These classes are available for immediate use to instantiate collection objects. 

As you can see, there are two classes that obviously fall into the Set category, two that obviously fall 
into the List category, and three that obviously fall into the Map category. You can learn more about the 
detailed characteristics of those classes in the standard Java documentation and in The Java Tutorials 1° . 

This leaves two additional classes whose names don’t readily divulge the category to which they belong. 


3.4.7.6.1.2 Vector and Hashtable classes 


The classes Vector and Hashtable were part of Java even before the Java Collections Framework became 
available. The Vector class can be used to instantiate objects that fall in the general List category. 
The Hashtable class can be used to instantiate objects that fall in the Map category. 
These two classes have been upgraded to make them compatible with the Collections Framework. 


3.4.7.6.1.3 Abstract implementations 


In addition to the concrete implementations listed above, the following three classes partially implement 
the interfaces, but are not intended for instantiation. Rather, they are intended to be extended into new 
concrete classes that you define. 


e AbstractSet 
e Abstract List 
e AbstractMap 


316http://docs.oracle.com/javase/tutorial/collections/interfaces/index.html 
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Therefore, by either using one of the three classes listed above as a starting point, or by starting from 
scratch and fully implementing one or more of the interfaces, you can provide new concrete implementations 
to augment the framework to include collections that meet your special needs. If you do that, be sure to 
satisfy the contract requirements of the Collections Framework in addition to the technical requirements 
imposed by implementing interfaces. 


3.4.7.6.2 Purpose of algorithms 


Algorithms are methods (not necessarily exposed) that provide useful capabilities, such as searching and 
sorting. For example, the Collection interface declares an exposed method named contains 


3.4.7.6.2.1 The contains method 


The contract for the contains method requires that the method: 


receives an incoming reference of type Object as a parameter 

searches the collection looking for an element that matches the incoming reference 

returns true if the collection on which the method is called contains the specified element and returns 
false otherwise. 


3.4.7.6.2.2 Different classes, different implementations 


You can safely call the contains method on any object instantiated from a class that properly implements 
the Collection interface, even if you don’t know the actual type of the collection object. 

The manner in which the search will be performed will probably differ from one concrete implementation 
of the interface to the next. For example, a TreeSet object will perform the search very rapidly with a 
time cost of only log(n) where n is the number of elements. On the other hand, for the same number of 
elements, because of a different underlying data structure, a search on an ArrayList object will probably 
require more time than a search on a TreeSet object. As the number of elements increases, the difference 
in time cost between the two will also increase. 


3.4.7.6.3 A sample program 


Consider the sample program shown in Listing 1 (p. 1115) . This program compares the search speed of the 
ArrayList class and the TreeSet class. A detailed discussion of the program follows Listing 1 (p. 1115) 
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Listing 1 . SpeedTest01. 


/*File SpeedTest01 


Copyright 2001 R.G.Baldwin 
FE A I IO EEE EEEE EEEE E EEEE EEEE EEEN 


import java.util.*; 


public class SpeedTest01f{ 
public static void main(String args[]){ 


new Worker() .doItQ; 


}//end main() 
}//end class SpeedTest01 


class Worker{ 
public void doIt(){ 


int size = 2000000; 
//Create a TreeSet object 
Collection aTree = new TreeSet(); 


//Populate the TreeSet object with 

// random values. The add() method 

// for a set rejects duplicates. 

Random rnGen = new Random(); 

for(int ct = 0; ct < size; ct++){ 
aTree.add(new Double(rnGen.nextDouble())); 

}//end for loop 


//Create and populate an ArrayList 

// object with the same random 

// values 

Collection aList = new ArrayList (aTree) ; 


//Extract a value near the center 

// of the ArrayList object to use 

// as a test case. 

Object testVal = ((List)aList) .get(size/2); 


//Search for the test value in each 

// of the collection objects. 

// Measure and display the time 

// required to perform the search 

// in each case. 

long start = new Date().getTime() ; 

boolean found = aList.contains(testVal) ; 

long stop = new Date() .getTime(); 
System.out.println(found + " " + (stop - start)); 


start = new Date().getTime(); 
for(int x = 0; x < 100000; x++){ 
found = aTree.contains(testVal) ; 
}//end for loop. ei R i TAN Say 
stop = new pate prey igs & § onnexions <http://cnx.org/content /col11441/1.181> 
System.out.println(found + " " + (stop - start) /100000.0); 


}//end dolt() 
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Table 3.451 


3.4.7.6.3.1 Instantiate and populate a TreeSet object 


The program begins by instantiating a TreeSet object and populating it with approximately 2,000,000 
elements as shown in Listing 2 (p. 1116) . The values encapsulated in the objects referred to by the elements 
in the collection are produced by a random number generator. 

Recall that the add method of a Set object rejects duplicate elements, so there may be fewer than 
2,000,000 elements in the object after it is populated, depending on how many of the random values are 
duplicates. 


Listing 2 . Beginning of the doIt method. 


public void doIt(){ 
int size = 2000000; 


Collection aTree = new TreeSet(); 


Random rnGen = new Random(); 

for(int ct = 0; ct < size; ct++){ 
aTree.add(new Double(rnGen.nextDouble())); 

}//end for loop 


Table 3.452 


3.4.7.6.3.2 Instantiate and populate an ArrayList object 


One of the capabilities of the Collection Framework is to create anew Collection object and populate it 
with the contents of an existing Collection object of a different (or the same) actual type. 

The code in Listing 3 (p. 1116) instantiates an ArrayList object and populates it with the contents 
of the existing TreeSet object. As a result, we then have two different Collection objects of different 
actual types containing the same elements. 


Listing 3 . Instantiate and populate an ArrayList object. 


Collection aList = new ArrayList (aTree) ; 


Table 3.453 


3.4.7.6.3.3 Identify a target element 


The objective of this program is to compare the times required to search for and to find an element in each 
of the collections. Thus, we need a target element to search for. 
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The code in Listing 4 (p. 1117) extracts a value near the center of the ArrayList object using an 
index to find and extract the value. This is a very fast operation on a List object. This value is saved in 
test Val to be used later for test purposes. 

Note that the reference to the ArrayList object was saved as type Collection (and not as type 
ArrayList ) in Listing 3 (p. 1116) above. 

Note also that it was necessary to cast that reference to type List in Listing 4 (p. 1117) in order to call 
the get method on the reference. This is because the Collection interface does not declare a method 
named get . Rather, the get method is added to the List interface to define a more specialized form 
of collection. 


(Author’s note: This program was originally written before the introduction of Generics. The 
above requirement may not be true if the program were to be rewritten making proper use of 
Generics.) 


Listing 4 . Identify a target element. 


Object testVal = ((List)aList) .get(size/2); 


Table 3.454 


3.4.7.6.3.4 Search for the test value in each collection 


The code in Listing 5 (p. 1117) calls the contains method to search for the test value in each of the 
collections. It uses the system clock to measure the time required to find the element in each case. (I will 
assume that you understand how to use the Date class for this purpose, and won’t provide a detailed 
explanation.) 


Listing 5 . Search for the test value in each collection. 


long start = new Date().getTime(); 
boolean found = aList.contains(testVal) ; 
long stop = new Date() .getTime(); 
System.out.println(found + " " + (stop - start)); 


start = new Date().getTime(); 
for(int x = 0; x < 100000; x++){ 
found = aTree.contains(testVal) ; 
}//end for loop 
stop = new Date().getTime(); 
System.out.println(found + " " + (stop - start) /100000.0); 


}//end dolt() 


Table 3.455 
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3.4.7.6.3.5 Program output 


Running the program several times produced the following range of output values: 


e First output value ranged from "true 93" to "true 109" 
e Second output value ranged from "true 0.00031" to "true 0.00046" 


The first output value applies to the ArrayList object, and the second output value applies to the 
TreeSet object. 

As we would expect, the test value was successfully found in both cases; hence the display of true in both 
cases. 


3.4.7.6.3.6 Time required to search the ArrayList collection 


The output indicates that approximately 100 milliseconds were required to find the test value in the Ar- 
rayList object. 


3.4.7.6.3.7 Time required to search the TreeSet collection 


The time required to find the test value in the TreeSet object was so small that it wasn’t even measurable 
within the granularity of the system clock (other experiments have caused me to believe that the granularity 
of the system clock on this machine is at least sixteen milliseconds) . Hence, the original reported time 
required to find the test value in the TreeSet object was zero. 

In order to get a measurable time value to search the TreeSet object, I had to wrap the invocation 
of the contains method in a for-loop and search for the same value 100,000 times in succession. Thus, 
the time required to find the test value in the TreeSet object was approximately 0.00030 milliseconds as 
compared to 100 milliseconds for the ArrayList object. 


(I'll let you do the arithmetic to see if this makes sense in terms of the expected time cost to 
search the two different types of collections. Don’t forget the extra overhead of the for-loop.) 


3.4.7.6.3.8 Different implementations 


This is a graphic demonstration that even though both objects can be treated as type Collection , and 

the contains method can be called on either object in a polymorphic manner, the actual implementations 

of the two objects and the implementations of the contains methods in those two objects are different. 
Each type of collection has advantages and disadvantages, depending on your needs. 


3.4.7.6.3.9 Polymorphic behavior applies 


The important point is that if you receive a reference to the collection object as type Collection , you can 
call the contains method on that reference without regard to the underlying structure of the collection 
object. This is because polymorphic behavior applies. 

Very briefly, polymorphic behavior means that the actual method that is executed is the appropriate 
method for that type of object regardless of the actual type (class) of the reference to the object. This is 
one of the great advantages of using the Java Collections Framework and passing collection objects among 
methods as interface types. 


3.4.7.6.4 Sorting algorithms 


Some of the implementations of the Java Collection Framework maintain their elements in a random order, 
and other implementations maintain their elements in a sorted order. Thus, the framework also provides 
sorting algorithms. However, the sorting algorithms used to maintain the order of the collections are not 
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exposed in the way that the search algorithm is exposed (via the contains method). Rather, the sorting 
algorithms are implicit in those implementations that need them, and are absent from those implementations 
that don’t need them. 


3.4.7.6.5 Now for a little quiz 


Let’s see if you are still awake. Select the words in one pair of parentheses in the following statement that 
causes the statement to be true. 


The interfaces in the Collections Framework make it possible to manipulate the contents of 
collections in a manner that is (dependent on) (independent of) the underlying implementation 
of each collection. 


3.4.7.6.5.1 And the answer is ... 


The interfaces in the Collections Framework make it possible to manipulate the contents of collections in a 
manner that is independent of the underlying implementation of each collection. That is the beauty of 
basing the framework on interfaces that declare polymorphic methods. 


3.4.7.6.5.2 Drive home the point 


I placed this question here to drive home the point that the methods declared in the Collection interface 
can be called on collection objects in a polymorphic manner. 

That is to say, as a user of an object instantiated from a class that properly implements the Collection 
interface (according to the contracts of the Collections Framework) , you can call the methods declared 
in that interface on a reference to the object and be confident that the actual method that is called will be 
the version that is appropriate for the class from which the object was instantiated. This is polymorphic 
behavior. 

In the event that you need to call a method that is not declared in the Collection interface (such as 
the get() method in Listing 4 (p. 1117) above), you can pass the reference as one of the more specialized 
sub-interfaces of Collection , suchas Set 


(Author’s note: Once again, this document was originally written before the release of Generics. 
The use of the more specialized sub-interfaces described above may not be required if the program 
is written making proper use of Generics.) 


3.4.7.6.6 Benefits of using the Collections Framework 


The Java Tutorial 3!" from Oracle lists and explains the benefits of using the Java Collections Framework, 
including the following. 


It reduces programming effort 

It increases program speed and quality 

It allows interoperability among unrelated APIs 
It reduces the effort to learn and use new APIs 
It reduces effort to design new APIs 

It fosters software reuse 


For a detailed explanation of these benefits, I am simply going to refer you directly to The Java Tutorial 318 


317http://docs.oracle.com/javase /tutorial/collections/interfaces/index-html 
318http://docs.oracle.com/javase /tutorial/collections/interfaces/index.html 
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3.4.7.7 Run the program 


I encourage you to copy the code from Listing 1 (p. 1115) and paste it into a Java source code file. Then 
compile and execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 


3.4.7.8 Summary 


Let’s recap some of what we have learned in this and the previous modules. 
The core collection interfaces in the Collections Framework are shown below. 


e Collection 


Set 
* SortedSet 
List 
Queue 
Deque 


e Map 
SortedMap 


The basic purpose of the core collection interfaces in the Java Collections Framework is to allow collections 
to be manipulated without regard for how the collections are implemented, provided of course that the 
implementations comply with the contracts. 

The framework provides at least the following nine concrete implementations (classes) of the interfaces 
shown above: 


HashSet 
TreeSet 
LinkedList 
ArrayList 
Vector 
HashMap 
WeakHashMap 
TreeMap 
Hashtable 


For example, the classes TreeSet and ArrayList are concrete implementations of the Collection 
interface as shown in the above list. 


(Actually, they are concrete implementations of sub-interfaces of Collection. The Collections 
Framework doesn’t provide any direct implementations of the Collection interface.) 


A collection object instantiated from the class TreeSet and a collection object instantiated from the class 
ArrayList can each be viewed as being of the interface type Collection 

Methods having the same signatures can be used to manipulate either collection with confidence that the 
behavior of the method will be appropriate for the actual type of collection involved. 

The framework also provides the following incomplete implementations of the core interfaces: 


e AbstractSet 
e AbstractList 
e AbstractMap 


The purpose of these implementations is to provide you with a starting point for defining your own concrete 
implementations for more specialized collections. 
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3.4.7.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4040: Purpose of Framework Implementations and Algorithms 
e File: Java0440.htm 

e Published: 04/18/13 

e Revised: 12/08/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1117 


3.4.8 Java4040r Review” 
3.4.8.1 Table of Contents 


Preface (p. 1122) 
Questions (p. 1122) 


1 (p. 1122) , 2 (p. 1122) , 3 (p. 1122) , 4 (p. 1123) , 5 (p. 1123) , 6 (p. 1123) , 7 (p. 1123) , 8 
(p. 1123) , 9 (p. 1123) , 10 (p. 1125) , 11 (p. 1125) , 12 (p. 1125) , 13 (p. 1125) , 14 (p. 1125) , 
15 (p. 1125) , 16 (p. 1125) , 17 (p. 1125) , 18 (p. 1126) , 19 (p. 1126) , 20 (p. 1126) 

Listings (p. 1126) 

Answers (p. 1127) 

Miscellaneous (p. 1130) 


3.4.8.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4040: Purpose of 
Framework Implementations and Algorithms 27° . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.8.3 Questions 


3.4.8.3.1 Question 1 


True or False? At least three things are included in the Java Collections Framework: 


e interfaces 
e implementations 
e algorithms 


Answer 1 (p. 1129) 


3.4.8.3.2 Question 2 


True or False? The Collections Framework provides at least nine concrete implementations of the interfaces 
in the framework. 
Answer 2 (p. 1129) 


3.4.8.3.3 Question 3 


True or False? The implementations in the Java Collections Framework are the concrete definitions of the 
classes that implement the core collection interfaces . 
Answer 3 (p. 1129) 


319This content is available online at <http://cnx.org/content /m48044/1.3/>. 
320http://cnx.org/content /m46137 /latest /?collection=col11441 /latest 
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3.4.8.3.4 Question 4 


True or False? Concrete implementations in the Java Collections Framework are provided by at least the 
following classes. 


HashSet 
TreeSet 
LinkedList 
ArrayList 
Vector 
HashMap 
WeakHashMap 
TreeMap 
Hashtable 
Iterator 


Answer 4 (p. 1129) 


3.4.8.3.5 Question 5 


True or False? Algorithms are methods (not necessarily exposed) that provide useful capabilities, such as 
searching and sorting. 

Answer 5 (p. 1129) 
3.4.8.3.6 Question 6 


True or False? The contract for the contains method requires that the method: 


receives an incoming reference of type Object as a parameter 

searches the collection looking for an element that matches the incoming reference 

returns false if the collection on which the method is called contains the specified element and 
returns true otherwise. 


Answer 6 (p. 1129) 


3.4.8.3.7 Question 7 


True or False? You can safely call the contains method on any object instantiated from a class that 
properly implements the Collection interface, even if you don’t know the actual type of the collection 
object. 

Answer 7 (p. 1129) 
3.4.8.3.8 Question 8 


True or False? When you call the contains method on a Collection object, the manner in which the 
search will be performed will be the same regardless of the class from which the object was instantiated. 
Answer 8 (p. 1129) 


3.4.8.3.9 Question 9 


The program shown in Listing 1 (p. 1124) will be used for several different questions. 
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Listing 1 . Used for several questions. 


/*File SpeedTest01 
Copyright 2001 R.G.Baldwin 
FE A I IO EEE EEEE EEEE E EEEE EEEE EEEN 


import java.util.*; 


public class SpeedTest01f{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class SpeedTest01 


class Worker{ 
public void doIt(){ 
int size = 2000000; 
//Create a TreeSet object 
Collection aTree = new TreeSet(); 


//Populate the TreeSet object with 

// random values. The add() method 

// for a set rejects duplicates. 

Random rnGen = new Random(); 

for(int ct = 0; ct < size; ct++){ 
aTree.add(new Double(rnGen.nextDouble())); 

}//end for loop 


//Create and populate an ArrayList 

// object with the same random 

// values 

Collection aList = new ArrayList (aTree) ; 


//Extract a value near the center 

// of the ArrayList object to use 

// as a test case. 

Object testVal = ((List)aList) .get(size/2); 


//Search for the test value in each 

// of the collection objects. 

// Measure and display the time 

// required to perform the search 

// in each case. 

long start = new Date().getTime() ; 

boolean found = aList.contains(testVal) ; 

long stop = new Date() .getTime(); 
System.out.println(found + " " + (stop - start)); 


start = new Date().getTime(); 
for(int x = 0; x < 100000; x++){ 
found = aTree.contains(testVal) ; 
}//end for loop. ei R i TAN Say 
stop = new pate prey igs & § onnexions <http://cnx.org/content /col11441/1.181> 
System.out.println(found + " " + (stop - start) /100000.0); 


}//end dolt() 
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Table 3.456 


True or False? The program shown in Listing 1 (p. 1124) compares the search speed of the ArrayList 
class and the TreeSet class. 
Answer 9 (p. 1128) 


3.4.8.3.10 Question 10 


True or False? The program shown in Listing 1 (p. 1124) instantiates a TreeSet object and populates it 
with approximately 10,000,000 elements. 
Answer 10 (p. 1128) 


3.4.8.3.11 Question 11 


True or False? Because the add method of a Set object rejects duplicate elements, there may be fewer 
than 2,000,000 elements in the TreeSet object in Listing 1 (p. 1124) after it is populated, depending on 
how many of the random values are duplicates. 

Answer 11 (p. 1128) 


3.4.8.3.12 Question 12 


True or False? One of the capabilities of the Collection Framework is to create a new Collection object 
and populate it with the contents of an existing Collection object of a different (or the same) actual 


type. 
Answer 12 (p. 1128) 
3.4.8.3.13 Question 13 


True or False? The code in Listing 1 (p. 1124) instantiates an ArrayList object and populates it with 
exactly 2,000,000 random values that are different from the random values contained inthe TreeSet object. 
Answer 13 (p. 1128) 


3.4.8.3.14 Question 14 
True or False? The ArrayList object in Listing 1 (p. 1124) may contain duplicate values. 
Answer 14 (p. 1128) 


3.4.8.3.15 Question 15 


True or False? Listing 1 (p. 1124) calls the get method on the ArrayList object. The ArrayList class 
implements the List interface. The get method of the List interface is inherited from the Collection 
interface. 

Answer 15 (p. 1128) 


3.4.8.3.16 Question 16 


True or False? In general, the time required for the contains method to find a value ina TreeSet object 
is less than the time required for the contains method to find a value in an ArrayList object. 
Answer 16 (p. 1128) 


3.4.8.3.17 Question 17 


True or False? The very fast searching speed of a TreeSet object results from the implementation of the 
Set interface. 
Answer 17 (p. 1127) 
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3.4.8.3.18 Question 18 


True or False? Polymorphic behavior means that the actual method that is executed on a Collection object 
is the appropriate method for that type of object regardless of the actual type (class) of the reference to 
the object. 

Answer 18 (p. 1127) 


3.4.8.3.19 Question 19 


True or False? Some of the implementations of the Java Collections Framework maintain their elements in a 
random order, and other implementations maintain their elements in a sorted order. The sorting algorithms 
used to maintain the order of the collections in the Collections Framework are exposed in the same way that 
the search algorithm is exposed (via the contains method). 

Answer 19 (p. 1127) 


3.4.8.3.20 Question 20 


True or False? The interfaces in the Collections Framework make it possible to manipulate the contents of 
collections in a manner that is independent of the underlying implementation of each collection. 

Answer 20 (p. 1127) 
3.4.8.4 Listings 


e Listing 1 (p. 1124) . Used for several questions. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None KEX] 


Display your nami 
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This image was also inserted for the purpose of inserting space between the questions and the answers. 


Prob05a.jpg | zi - |x| 


Put your name here 


3.4.8.5 Answers 
3.4.8.5.1 Answer 20 
True. 
Back to Question 20 (p. 1126) 
3.4.8.5.2 Answer 19 


False. The sorting algorithms used to maintain the order of the collections in the Collections Framework 
are not exposed in the way that the search algorithm is exposed (via the contains method). Rather, 
the sorting algorithms are implicit in those implementations that need them, and are absent from those 
implementations that don’t need them. 

Back to Question 19 (p. 1126) 


3.4.8.5.3 Answer 18 
True. 
Back to Question 18 (p. 1126) 


3.4.8.5.4 Answer 17 


False. While implementation of the Set interface may have some minor impact on the searching speed of 
a TreeSet object, the primary reason for the fast searching speed is the fact that the implementation uses 
a tree structure. 
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Back to Question 17 (p. 1125) 


3.4.8.5.5 Answer 16 


True. A TreeSet object will perform the search very rapidly with a time cost of only log(n) where n is the 
number of elements. On the other hand, for the same number of elements, because of a different underlying 
data structure, a search on an ArrayList object will probably require more time than a search on a 
TreeSet object. As the number of elements increases, the difference in time cost between the two will also 
increase. 

Back to Question 16 (p. 1125) 


3.4.8.5.6 Answer 15 


False. The Collection interface does not declare a method named get . Rather, the get method is 
added to the List interface to define a more specialized form of collection. 

Back to Question 15 (p. 1125) 
3.4.8.5.7 Answer 14 


False. While an ArrayList object may contain duplicate values, the ArrayList object in Listing 1 
(p. 1124) was populated with the values contained in the TreeSet object, which does not allow duplicate 
values. Therefore, in this case, the ArrayList object may not contain duplicate values. 

Back to Question 14 (p. 1125) 
3.4.8.5.8 Answer 13 


False. The code in Listing 1 (p. 1124) instantiates an ArrayList object and populates it with the contents 
of the existing TreeSet object. As a result, we then have two different Collection objects of different 
actual types containing the same elements. 
Back to Question 13 (p. 1125) 
3.4.8.5.9 Answer 12 
True. 
Back to Question 12 (p. 1125) 
3.4.8.5.10 Answer 11 
True. 
Back to Question 11 (p. 1125) 
3.4.8.5.11 Answer 10 


False. The program shown in Listing 1 (p. 1124) instantiates a TreeSet object and populates it with 
approximately 2,000,000 elements. 

Back to Question 10 (p. 1125) 
3.4.8.5.12 Answer 9 


True. 
Back to Question 9 (p. 1123) 
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3.4.8.5.13 Answer 8 


False. The manner in which the search will be performed will probably differ from one concrete implementa- 
tion of the interface to the next. For example, a TreeSet object will perform the search very rapidly with 
a time cost of only log(n) where n is the number of elements. On the other hand, for the same number of 
elements, because of a different underlying data structure, a search on an ArrayList object will probably 
require more time than a search on a TreeSet object. As the number of elements increases, the difference 
in time cost between the two will also increase. 

Back to Question 8 (p. 1123) 
3.4.8.5.14 Answer 7 
True. 

Back to Question 7 (p. 1123) 
3.4.8.5.15 Answer 6 


False. 
The contract for the contains method requires that the method: 


receives an incoming reference of type Object as a parameter 

searches the collection looking for an element that matches the incoming reference 

returns true if the collection on which the method is called contains the specified element and 
returns false otherwise. 


Back to Question 6 (p. 1123) 


3.4.8.5.16 Answer 5 
True. 
Back to Question 5 (p. 1123) 
3.4.8.5.17 Answer 4 
False. Iterator is not one of the concrete implementations. 
Back to Question 4 (p. 1123) 
3.4.8.5.18 Answer 3 
True. 
Back to Question 3 (p. 1122) 
3.4.8.5.19 Answer 2 
True. 
Back to Question 2 (p. 1122) 
3.4.8.5.20 Answer 1 


True. 
Back to Question 1 (p. 1122) 
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This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4040r Review 
e File: Java4040r.htm 

e Published: 11/25/13 

e Revised 12/08/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4.9 Java4050: Core Collection Interfaces” 
3.4.9.1 Table of Contents 


Preface (p. 1131) 
Viewing tip (p. 1131) 
Listings (p. 1131) 
Preview (p. 1131) 
Generics (p. 1132) 
Discussion and sample code (p. 1132) 
Illustration of core collection interfaces (p. 1132) 
x Multiple list implementations (p. 1134) 
x TreeSet and ArrayList (p. 1134) 
x Behavior is different but appropriate (p. 1134) 
The fillIt method (p. 1134) 
Create and populate a TreeSet object (p. 1134) 
x Display the collection’s contents (p. 1135) 
x TreeSet object is type SortedSet (p. 1135) 
Create and populate an ArrayList object (p. 1135) 
x Display the collection’s contents (p. 1136) 
The important point (p. 1136) 
x No duplicate elements in ascending order (p. 1136) 


321This content is available online at <http://cnx.org/content /m46138/1.4/>. 
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x Duplicates allowed with no sorting (p. 1136) 
Structure of the core interfaces (p. 1136) 
A Map is not a true Collection (p. 1137) 
Some operations are optional (p. 1137) 
Support for optional operations (p. 1137) 
Optional Collection operations (p. 1137) 
Optional Map operations (p. 1137) 
Many methods are not optional (p. 1137) 


* * * * 


Run the program (p. 1138) 
Summary (p. 1138) 
What’s next? (p. 1138) 
Miscellaneous (p. 1138) 


3.4.9.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

The Java Collections Framework defines eight core interfaces, in two distinct trees. You will learn about 
the inheritance structure and the purpose of those interfaces. You will also learn how the interfaces declare 
polymorphic methods that apply to implementations of the interfaces, and you will learn about the optional 
methods of the Collection and Map interfaces. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 3?? in 
Oracle’s Java Tutorials 3?3 . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.9.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


3.4.9.2.1.1 Listings 


e Listing 1 (p. 1133) . The program named Ap401. 

e Listing 2 (p. 1134) . The Populator class. 

e Listing 3 (p. 1135) . Create and populate a TreeSet object. 

e Listing 4 (p. 1135) . Create and populate an ArrayList object. 


3.4.9.3 Preview 


In earlier modules, you learned that at least three things are included in a collections framework: 


e interfaces 
e implementations 
e algorithms 


Earlier modules provided a general discussion of the purpose of the interfaces, implementations, and algo- 
rithms in the Collections Framework . This module takes that discussion further and illustrates the use of 
the core collection interfaces. 


322http://docs.oracle.com/javase/tutorial/collections/index-html 
323http://docs.oracle.com/javase/tutorial/index.html 
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The Java Collections Framework defines eight core interfaces, in two distinct trees. You will learn the 
names and the inheritance structure of those interfaces. You will also learn about the purpose of some of 
those interfaces. You will see how the interfaces declare polymorphic methods that apply to implementations 
of the interfaces, and you will learn about the optional methods of the Collection interface. 


3.4.9.4 Generics 


The code in this series of modules is written with no thought given to Generics 374 . As a result, if you copy 
and compile the code, you will probably get warnings about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.9.5 Discussion and sample code 
3.4.9.5.1 Illustration of core collection interfaces 


We will begin this module with a little quiz. Take a look at the program shown in Listing 1 (p. 1133) and 
see if you can answer the following question. 
What output does the program in Listing 1 (p. 1133) produce? 


A. Compiler Error 

. Runtime Error 

. 44321 44321 

. 12344 12344 

. 1234 44321 

. 1234 4321 

. None of the above. 


UAmooOW 


324http://docs.oracle.com/javase/tutorial/java/generics/index.html 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1128 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Listing 1 . The program named Ap401. 


import java.util.TreeSet; 
import java.util.ArrayList; 
import java.util.Collection; 
import java.util.Iterator; 


public class Ap401f{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap401 


class Worker{ 
public void doIt(){ 
Collection ref = new TreeSet(); 
Populator.fillIt (ref); 
Iterator iter = ref.iterator(); 
while (iter. hasNext())f{ 
System.out.print(iter.next()); 
}//end while loop 
System.out.print(" "); 


ref = new ArrayList(); 
Populator.fillIt (ref); 
iter = ref.iterator(); 
while(iter.hasNext())f{ 
System.out.print(iter.next()); 
}//end while loop 
System. out.println() ; 
}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(new Integer (4)); 
ref.add(new Integer (4)); 
ref.add(new Integer (3)); 
ref.add(new Integer (2)); 
ref.add(new Integer(1)); 
}//end fillIt() 
}//end class populator 


Table 3.457 


If you selected the following answer, then you are correct. 

E. 1234 44321 

The program in Listing 1 (p. 1133) illustrates the basic purpose of the core collection interfaces in the 
Java Collections Framework. That purpose is to allow collections to be manipulated without regard for how 
the collections are implemented. 
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3.4.9.5.1.1 Multiple list implementations 


For example, there is more than one way to implement a list. Two common ways involve arrays and 
linked structures. If two lists are implemented in different ways, but both satisfy the requirements of the 
core collection interfaces, they can each be manipulated the same way regardless of the details of their 
implementation. 


3.4.9.5.1.2 TreeSet and ArrayList 


A collection of type TreeSet and a collection of type ArrayList are instantiated in the program in 
Listing 1 (p. 1133) . Each of the collections is viewed as being of the interface type Collection . A method 
named add is used to populate each collection with the same values in the same order. 


3.4.9.5.1.3 Behavior is different but appropriate 


The behavior of the add method is appropriate, and different in each of the two cases, with the final 
contents of each collection being determined by the respective behavior of the add method for that type 
of collection. 


3.4.9.5.2 The filllt method 


The code in the fragment shown in Listing 2 (p. 1134) defines a static method named fillIt of the class 
named Populator . This is a class of my own design intended solely to illustrate the primary point of this 
program. 

The method named fillIt receives an incoming reference to a collection object as type Collection 
The method calls the add method on the incoming reference five times in succession to add five elements 
to the collection. These elements are added without regard for the actual type or underlying implementation 
of the collection. (As written, the fillIt method has no way of knowing the underlying implementation.) 


Listing 2 . The Populator class. 


class Populator{ 

public static void fillIt(Collection ref){ 
ref.add(new Integer (4)); 
ref.add(new Integer (4)); 
ref.add(new Integer (3)); 
ref.add(new Integer (2)); 
ref.add(new Integer(1)); 

}//end fillIt() 

}//end class populator 


Table 3.458 


The fillIt method will be used to populate two collections of different types with the same data values 
in the same order. 


3.4.9.5.3 Create and populate a TreeSet object 


Consider the code fragment shown in Listing 3 (p. 1135) . 
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Listing 3 . Create and populate a TreeSet object. 


Collection ref = new TreeSet(); 
Populator.fillIt (ref); 
Iterator iter = ref.iterator(); 
while(iter.hasNext()){ 
System.out.print(iter.next()); 
}//end while loop 


Table 3.459 


The code in Listing 3 (p. 1135) instantiates an object of type TreeSet , and passes that object’s 
reference to the fillIt method as type Collection . As described above, the fillIt method adds five 
elements to the collection, in random order with two of the elements being duplicates. 


"Note that this program does not use the syntax for Generics. Therefore, if you copy and compile 
this program, you will probably see a warning regarding unchecked or unsafe operations" 


3.4.9.5.3.1 Display the collection’s contents 


Then the code in Listing 3 (p. 1135) gets an Iterator object on the collection and uses the iterator to 
display the contents of the collection. 


3.4.9.5.3.2 TreeSet object is type SortedSet 


The TreeSet class implements one of the core collection interfaces named SortedSet . SortedSet is 
a sub interface of Set . One of the characteristics of a Set object is that it doesn’t allow duplicate 
elements. One of the characteristics of a SortedSet object is that, by default, it maintains its elements 
in ascending natural order. Since the TreeSet class implements both of these interfaces, it is both a Set 
and a SortedSet , and exhibits the characteristics of both interfaces. 

Because the underlying structure of the TreeSet class doesn’t allow duplicates, and the underlying 
structure maintains its elements in ascending order, the code in Listing 3 (p. 1135) produces the following 
text on the screen: 

1234 


3.4.9.5.4 Create and populate an ArrayList object 


Now consider the code fragment shown in Listing 4 (p. 1135) . 


Listing 4 . Create and populate an ArrayList object. 


ref = new ArrayList(); 
Populator.fillIt (ref); 
iter = ref.iterator(); 
while(iter.hasNext()){ 
System.out.print(iter.next()); 
}//end while loop 
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Table 3.460 


The code in Listing 4 (p. 1135) instantiates a new collection of type ArrayList , and passes that 
object’s reference to the same fillIt method, once again as type Collection 

The code in the fillIt method adds five elements having the same values as before to the collection and 
adds them in the same order as before. The added elements are references to Integer objects encapsulating 
the same values as were earlier added to the TreeSet collection. Although they are physically different 
objects, the result is that essentially the same data is added to both collections. 


3.4.9.5.4.1 Display the collection’s contents 


Then, as before, the code in Listing 4 (p. 1135) gets an iterator and uses it to access and display the contents 
of the ArrayList collection. 

The ArrayList class implements the List interface, which does not prohibit duplicate elements, and 
does not maintain its elements in sorted order. Therefore, in this case, the following text was displayed: 

44321 

All five element values are displayed, including the duplicate, in the order in which they were added to 
the list. 


3.4.9.5.5 The important point 


The important point is that although the fillIt method calls the same method name ( add ) on each of 
the collection objects, the behavior of that method is different in each case. In both cases, the behavior is 
appropriate for the underlying data structure. Furthermore, the underlying data structure isn’t even known 
tothe fillIt method. 


3.4.9.5.5.1 No duplicate elements in ascending order 


In the first case, where the underlying data structure was a TreeSet object (type SortedSet ), the 
duplicate element was eliminated, and the elements were stored so as to be accessible in ascending order. 


3.4.9.5.5.2 Duplicates allowed with no sorting 


In the second case, where the underlying data structure was an ArrayList object (type List ), all five 
elements, including the duplicate element were stored in the collection. Furthermore, they were stored and 
later retrieved in the same order in which they were added. 


3.4.9.5.6 Structure of the core interfaces 


The core collection interfaces in the Java Collections Framework do not all extend from a common root 
interface. 

Rather, the inheritance structure of the core interfaces is shown below. Indentation is used to indicate 
the parent-child relationships among the interfaces. 


e Collection 
Set 
* SortedSet 
List 
Queue 
Deque 

e Map 
SortedMap 
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3.4.9.5.7 A Map is not a true Collection 


As you can see, that there is no common root interface. Rather, there are two distinct trees, one rooted by 
Collection and the other rooted by Map . According to The Java Tutorial from Oracle, "a Map is not 
a true Collection." I will have more to say about this in a future module. 


3.4.9.5.8 Some operations are optional 


Every class that implements an interface in the tree rooted in Collection is not required to support all of 
the methods (operations) declared in the Collection interface. 

Rather, some of the methods in the Collection interface are designated as "optional operation" in the 
documentation. (See the list of optional methods for the Collection interface below.) 

According to the contract for the Collections Framework, if a given implementation doesn’t support a spe- 
cific method, it must throw an UnsupportedOperationException . The author of the implementation 
is responsible for providing documentation that identifies the optional operations that the implementation 
does and does not support. 


3.4.9.5.8.1 Support for optional operations 


This should not be an issue unless you are either defining your own implementation, or using an implementa- 
tion defined by someone other than the programmers at Oracle. All of the general-purpose implementations 
from Oracle appear to support all of the optional operations. 


3.4.9.5.8.2 Optional Collection operations 


The following list shows the optional operations in the Collection interface. Each of these methods has 
the ability to modify the contents of the collection. 


add() 
addAll() 
clear() 
remove() 
removeAll() 
retainAll() 


3.4.9.5.8.3 Optional Map operations 


The following list shows the optional operations in the Map interface. Each of these methods also has the 
ability to modify the contents of the map. 


clear() 


put () 
put All() 


remove() 


3.4.9.5.8.4 Many methods are not optional 


In both cases, the interface declares numerous other methods that are not optional. Generally, the non- 
optional methods don’t have the ability to modify the collection. For example, the get method of the 
Map interface is not optional. Although the get method receives an incoming key and returns the 
value to which the key maps, the method doesn’t have the ability to modify the contents of the collection. 
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3.4.9.6 Run the program 


I encourage you to copy the code from Listing 1 (p. 1133) and paste it into your Java editor. Then compile 
and execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 


3.4.9.7 Summary 


A collections framework contains at least the following items: 


interfaces 
implementations 
algorithms 


The Java Collections Framework defines eight core interfaces, in two distinct trees. One tree is rooted in 
Collection and the other is rooted in Map 

The basic purpose of the core interfaces is to make it possible for collections to be manipulated without 
regard for how they are implemented, so long as the implementation satisfies the contracts of the interfaces. 

When the same method name (and signature) is called on references to collections of different types, 
the behavior of the method is likely to be different for each collection. However, in each case, that behavior 
will be appropriate for the type of collection object on which the method is called. This is polymorphic 
behavior. 

Six of the methods declared in the Collection interface are optional insofar as being supported by 
implementing classes is concerned. The optional methods all have the ability to modify the contents of the 
collection. Those implementing classes that don’t support an optional method must throw an Unsupport- 
edOperationException if that method is called on an object of the class. Similarly four of the methods 
declared in the Map interface are optional. 

Many methods declared in the Collection interface are not optional. Generally, the non-optional 
methods don’t have the ability to modify the collection. 


3.4.9.8 What’s next? 


In the next module, I will discuss and illustrate some of the details of the core interfaces and the general- 
purpose implementations in the Java Collections Framework. For example, I will discuss the difference 
between a set anda list . I will also discuss the difference between ordered and sorted . I will discuss 
the fact that additional stipulations are applied as you progress down the framework interface hierarchy. In 
order to help you learn and retain the material, I will provide a couple of short quizzes. 


3.4.9.9 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java4050: Core Collection Interfaces 
e File: Java4050.htm 

e Published: 04/18/13 

e Revised: 12/08/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.4.10 Java4050r: Review” 
3.4.10.1 Table of Contents 
Preface (p. 1140) 
Questions (p. 1140) 


1 (p. 1140) , 2 (p. 1142) , 3 (p. 1142) , 4 (p. 1142) , 5 (p. 1142) , 6 (p. 1142) , 7 (p. 1142) , 8 
(p. 1142) , 9 (p. 1142) , 10 (p. 1143) , 11 (p. 1143) , 12 (p. 1143) , 13 (p. 1143) , 14 (p. 1143) , 
15 (p. 1143) 

Listings (p. 1144) 

Answers (p. 1145) 

Miscellaneous (p. 1147) 


3.4.10.2 Preface 


This module contains review questions and answers keyed to the module titled Java4050: Core Collection 
Interfaces 376 . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 
3.4.10.3 Questions 
3.4.10.3.1 Question 1 


The program in Listing 1 (p. 1141) may be referred to by several different questions. 


325This content is available online at <http://cnx.org/content /m48114/1.3/>. 
326http://cnx.org/content /m46138 /latest /?collection=col11441 /latest 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1136 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Listing 1 . Program named Ap401. 


import java.util.TreeSet; 
import java.util.ArrayList; 
import java.util.Collection; 
import java.util.Iterator; 


public class Ap401f{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap401 


class Worker{ 
public void doIt(){ 
Collection ref = new TreeSet(); 
Populator.fillIt (ref); 
Iterator iter = ref.iterator(); 
while (iter. hasNext())f{ 
System.out.print(iter.next()); 
}//end while loop 
System.out.print(" "); 


ref = new ArrayList(); 
Populator.fillIt (ref); 
iter = ref.iterator(); 
while(iter.hasNext())f{ 
System.out.print(iter.next()); 
}//end while loop 
System. out.println() ; 
}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(new Integer (4)); 
ref.add(new Integer (4)); 
ref.add(new Integer (3)); 
ref.add(new Integer (2)); 
ref.add(new Integer(1)); 
}//end fillIt() 
}//end class populator 


Table 3.461 
Which of the following does Listing 1 (p. 1141) produce as an output? 


e 44321 44321 
e 12344 12344 
e 1234 44321 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1137 


e 1234 4321 


Answer 1 (p. 1147) 


3.4.10.3.2 Question 2 


True or False? The basic purpose of the core collection interfaces in the Java Collections Framework is to 
allow collections to be manipulated without regard for how the collections are implemented. 
Answer 2 (p. 1147) 


3.4.10.3.3 Question 3 

True or False? There is only one way to implement a list. 
Answer 3 (p. 1147) 

3.4.10.3.4 Question 4 


True or False? If two lists are implemented in different ways, but both satisfy the requirements of the 
core collection interfaces, they can each be manipulated the same way regardless of the details of their 
implementation. 

Answer 4 (p. 1147) 


3.4.10.3.5 Question 5 
True or False? A collection of type TreeSet and a collection of type ArrayList are instantiated in the 


program in Listing 1 (p. 1141) . Each of the collections is viewed as being of the interface type Collection 


Answer 5 (p. 1146) 


3.4.10.3.6 Question 6 


True or False? Given the TreeSet and ArrayList classes, only the TreeSet class implements the 
Collection interface. (See the Java documentation.) 
Answer 6 (p. 1146) 


3.4.10.3.7 Question 7 


True or False? Both the TreeSet class and the ArrayList class inherit an abstract method named add 
from the Collection interface. 
Answer 7 (p. 1146) 


3.4.10.3.8 Question 8 


True or False? Given that both the TreeSet class and the ArrayList class inherit an abstract method 
named add from the Collection interface, each class is required to define a concrete version of the add 
method with the same behavior. 

Answer 8 (p. 1146) 


3.4.10.3.9 Question 9 


True or False? In Listing 1 (p. 1141) , a method named add is called to populate the TreeSet collection 
and the ArrayList collection with the same values in the same order. 
Answer 9 (p. 1146) 
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3.4.10.3.10 Question 10 


True or False? Given that in Listing 1 (p. 1141) , a method named add is called to populate the TreeSet 
collection and the ArrayList collection with the same values in the same order, the two collections end 
up containing the same values 

Answer 10 (p. 1146) 


3.4.10.3.11 Question 11 


True or False? Given that in Listing 1 (p. 1141) , the TreeSet object filters out duplicate values, the 
TreeSet object and the ArrayList object end up containing all of the other values in the same order. 
Answer 11 (p. 1146) 


3.4.10.3.12 Question 12 


True or False? In Listing 1 (p. 1141) , the fillIt method receives an incoming parameter that is a reference 
to a collection object. The fillIt method calls the add method on the incoming reference several times 
in succession to add elements to the collection, being careful to satisfy the special requirements of the type 
of collection object. 

Answer 12 (p. 1146) 


3.4.10.3.13 Question 13 


True or False? In Listing 1 (p. 1141) , the fillIt method calls the same method name ( add ) on each 
of the collection objects. (They are physically different methods with the same name.) . The behavior of 
one add method is different from the behavior of the other add method. In both cases, the behavior is 
appropriate for the underlying data structure. The actual type of the underlying data structure isn’t known 
tothe fillIt method. 

Answer 13 (p. 1145) 


3.4.10.3.14 Question 14 


True or False? The inheritance structure of the core collection interfaces in the Java Collections Framework 
is shown below. Indentation is used to indicate the parent-child relationships among the interfaces. 


e Collection 
Set 
* SortedSet 
List 
Queue 
Deque 

e Map 
SortedMap 


Answer 14 (p. 1145) 


3.4.10.3.15 Question 15 


True or False? Every class that implements an interface in the tree rooted in Collection is required to 
support all of the methods (operations) declared in the Collection interface. 
Answer 15 (p. 1145) 
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3.4.10.4 Listings 
e Listing 1 (p. 1141) . Program named Ap401. 
What is the meaning of the following two images? 


These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None 


Display your nam: 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


3.4.10.5 Answers 
3.4.10.5.1 Answer 15 


False. Every class that implements an interface in the tree rooted in Collection is not required to 
support all of the methods (operations) declared in the Collection interface. 

Rather, some of the methods in the Collection interface are designated as "optional operation" in the 
documentation. 

If a given implementation doesn’t support a specific method, it must throw an UnsupportedOper- 
ationException . The author of the implementation is responsible for providing documentation that 
identifies the optional operations that the implementation does and does not support. 

Back to Question 15 (p. 1143) 


3.4.10.5.2 Answer 14 
True. 

Back to Question 14 (p. 1143) 
3.4.10.5.3 Answer 13 


True. 
Back to Question 13 (p. 1143) 
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3.4.10.5.4 Answer 12 


False. In Listing 1 (p. 1141) , the fillIt method receives an incoming parameter that is a reference to a 
collection object. The fillit method calls the add method on the incoming reference several times in 
succession to add elements to the collection, without regard for the actual type or underlying implementation 
of the collection object. (As written, the fillIt method has no way of knowing the actual type or underlying 
implementation of the collection object.) 

Back to Question 12 (p. 1143) 


3.4.10.5.5 Answer 11 


False. By implementing the SortedSet interface, the TreeSet object is required to present its contents to 
an iterator in ascending natural order. The ArrayList object is not subject to such a contract. Therefore, 
the TreeSet object presents its contents to the iterator as 1234 (with no duplicate elements) while the 
ArrayList object presents its contents to the iterator as 44321, which is the same order that the values 
were added to the object. 
Back to Question 11 (p. 1143) 


3.4.10.5.6 Answer 10 


False. The TreeSet class implements the SortedSet interface. SortedSet is a sub interface of Set 
One of the characteristics of a Set object is that it doesn’t allow duplicate elements. The ArrayList 
class is not subject to such a contract. Therefore, the ArrayList object ends up containing duplicate 
copies of the value 4 while the TreeSet object ends up with no duplicates. 
Back to Question 10 (p. 1143) 


3.4.10.5.7 Answer 9 
True. 
Back to Question 9 (p. 1142) 


3.4.10.5.8 Answer 8 


False. Given that both the TreeSet class and the ArrayList class inherit an abstract method named 
add from the Collection interface, each class is required to define a concrete version of the add method 
but those two methods are not required to exhibit the same behavior. The behavior of the add method 
for each class should be appropriate for the type of object instantiated from the class. 

Back to Question 8 (p. 1142) 
3.4.10.5.9 Answer 7 
True. 

Back to Question 7 (p. 1142) 
3.4.10.5.10 Answer 6 
False. Both the TreeSet class and the ArrayList class implement the Collection interface. 

Back to Question 6 (p. 1142) 
3.4.10.5.11 Answer 5 


True. 
Back to Question 5 (p. 1142) 
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3.4.10.5.12 Answer 4 


True. 
Back to Question 4 (p. 1142) 


3.4.10.5.13 Answer 3 


False. There is more than one way to implement a list. Two common ways involve arrays and linked 
structures. 
Back to Question 3 (p. 1142) 


3.4.10.5.14 Answer 2 


True. 
Back to Question 2 (p. 1142) 


3.4.10.5.15 Answer 1 


1234 44321 
Back to Question 1 (p. 1140) 


3.4.10.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4050r: Review 
e File: Java4050r.htm 

e Published: 11/30/13 

e Revised 12/08/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.4.11 Java4060: Duplicate Elements, Ordered Collections, Sorted Collections, 
and Interface Specialization” 


3.4.11.1 Table of Contents 


Preface (p. 1148) 
Preview (p. 1148) 
Generics (p. 1149) 
Discussion (p. 1149) 
We will start with a quiz (p. 1149) 
The root of the Collection hierarchy (p. 1149) 
x What does Oracle say about this? (p. 1150) 
What about duplicate elements? (p. 1150) 
What is a set? (p. 1150) 
What is a list? (p. 1150) 
Ordered is not the same as sorted (p. 1150) 
Is ascending sort order always required? (p. 1150) 


x Does case matter in String objects? (p. 1151) 
Sub-interfaces have more stipulations (p. 1151) 
* Stipulations on set (p. 1151) 
* Stipulations on SortedSet (p. 1151) 
We will end with a quiz (p. 1151) 
x Question 1 (p. 1152) 
x Question 2 (p ) 
x Question 3 (p. 1152) 
x Question 4 (p ) 
e Summary (p. 1153) 
e What’s next? (p. 1153) 
e Miscellaneous (p. 1153) 


3.4.11.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 328 in 
Oracle’s Java Tutorials °?° . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.11.3 Preview 


You learned in earlier modules that the Java Collections Framework defines eight core interfaces, in two 
distinct trees. One of the trees, which consists of six interfaces, is rooted in the interface named Collection 
. The other tree, which consists of two interfaces, is rooted in the interface named Map 

You learned the names and the inheritance structure of those interfaces. You also learned about their 
purpose. You saw how the interfaces declare polymorphic methods that apply to implementations of the 
interfaces, and you learned about the optional methods of the Collection interface and the Map interface. 

In this module you will learn that all of the implementations of the interfaces on the Collection side 
of the Java Collections Framework (the Collection hierarchy) implement one of the sub-interfaces of the 


327This content is available online at <http://cnx.org/content/m46141/1.4/>. 
328http://docs.oracle.com/javase/tutorial/collections/index.html 
32°http://docs.oracle.com/javase/tutorial/index.html 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1144 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Collection interface. (A similar discussion regarding the Map side of the Java Collections framework 
will be deferred until a future module.) 

You will learn that a Set object cannot contain duplicate elements, but a List object can contain 
duplicate elements. 

You will learn about the difference between ordered collections and sorted collections. You will also 
learn about ascending order and the natural ordering of objects. 

In addition, you will learn how more specialized stipulations are placed on interfaces as you progress 
down the interface inheritance hierarchy of the Java Collections Framework. 


3.4.11.4 Generics 


The code in this series of modules is written with no thought given to Generics 33° . As a result, if you copy 
and compile the code, you will probably get warnings about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.11.5 Discussion 
3.4.11.5.1 We will start with a quiz 


Iam going to begin this module with a quiz just to make sure that you are still awake. Is the following 
statement True or False? 


The TreeSet class is a direct implementation of the Collection interface. 


The answer is False. 

The TreeSet class is not a direct implementation of the Collection interface. Rather, the TreeSet 
class is a direct implementation of the SortedSet interface. The SortedSet interface extends the Set 
interface, and the Set interface extends the Collection interface. 

The interface hierarchy for the Java Collections Framework is shown below: 


e Collection 
Set 
* SortedSet 
List 
Queue 
Deque 

e Map 
SortedMap 


As you learned in an earlier module, the Java Collections Framework doesn’t have a single root. As shown 
above, there are two distinct trees in the framework — The Collection hierarchy and the Map hierarchy. 


3.4.11.5.2 The root of the Collection hierarchy 


The Collection interface is the root of the collection hierarchy. The Java Collections Framework doesn’t 
provide any direct implementations of the Collection interface. All of the implementations of the interfaces 
in the Collection hierarchy implement one of the sub-interfaces of the Collection interface. 


330http://docs.oracle.com/javase/tutorial/java/generics/index.html 
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3.4.11.5.2.1 What does Oracle say about this? 


Here is what the Oracle documentation has to say on the topic of the Collection interface: 

"The SDK does not provide any direct implementations of this interface: it provides implementations of 
more specific sub-interfaces like Set and List . This interface is typically used to pass collections around 
and manipulate them where maximum generality is desired." 

The Oracle documentation also states: 

"Bags or multisets (unordered collections that may contain duplicate elements) should implement this 

interface directly." 


3.4.11.5.3 What about duplicate elements? 


Some implementations of Collection allow duplicate elements, and others do not. Implementations of the 
List interface (such as ArrayList ) allow duplicate elements. Implements of Set and SortedSet 
(such as TreeSet ) do not allow duplicate elements. This was illustrated in an earlier module. 

A sample program in that earlier module created two collection objects and applied the polymorphic add 
method to add the same elements to each collection. One of the collection objects was of type ArrayList , 
and the other collection object was of type TreeSet . The elements added to each collection contained one 
pair of duplicate elements. The duplicate element was automatically excluded from the TreeSet object, 
but was retained in the ArrayList object. 


3.4.11.5.4 What is a set? 


According to Oracle, a Set isa "collection that contains no duplicate elements ... this interface models 
the mathematical set abstraction." 

An object of type Set is typically used to model collections such as Social Security numbers, where 
duplicates are not allowed. 


3.4.11.5.5 What is a list? 


Also according to Oracle, a List is "An ordered collection (also known as a sequence). The user of this 
interface has precise control over where in the list each element is inserted. The user can access elements by 
their integer index (position in the list), and search for elements in the list." 


3.4.11.5.6 Ordered is not the same as sorted 


Note that an ordered collection is not the same as a sorted collection. 

The fact that the collection is ordered derives from the fact that each element in the collection has a 
specific position specified by an index. 

In a sorted collection, the position of each element is determined by its value relative to the values of its 
predecessors and successors. 

Oracle goes on to say, "Unlike sets, lists typically allow duplicate elements. More formally, lists typically 
allow pairs of elements e1 and e2 such that el.equals(e2), and they typically allow multiple null elements if 
they allow null elements at all." 


3.4.11.5.7 Is ascending sort order always required? 


Not all implementations of the Collection interface maintain the elements in ascending sort order. Some 
may, and others do not. For example, as discussed above, implementations of the List interface (such 
as ArrayList ) do not maintain their elements in sorted order at all. In other words, the position of an 
element in an ArrayList does not depend on the value of the element. 

On the other hand, implementations of the interface named SortedSet (such as TreeSet ) and 
the interface named SortedMap do maintain their elements in sorted order. However, that order is not 
necessarily ascending. 
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When an object is instantiated from a class that implements the SortedSet interface, the sorting order 
for that object can be established by providing an object instantiated from a class that implements the 
Comparator interface. In that case, the author of the class that implements the Comparator interface 
determines the order imposed on the elements in the collection. 


3.4.11.5.7.1 Does case matter in String objects? 


For example, if your SortedSet object contains references to String objects, the natural ascending sort 
would take the difference between upper case and lower case characters into account. 

However, you might prefer that case be ignored when establishing the sorted order. You can accomplish 
this by providing an object of a class that implements the Comparator interface and which defines 
the compare method and the equals method in such a way as to eliminate case considerations for 
comparisons of String objects. 


3.4.11.5.8 Sub-interfaces have more stipulations 


As you progress down the inheritance hierarchy, you find that additional stipulations apply at each level of 
inheritance. As an example, according to Oracle, "The Set interface places additional stipulations, beyond 
those inherited from the Collection interface, on the contracts of all constructors and on the contracts of the 
add , equals and hashCode methods." 

The important point is that specific sub-interfaces of the Collection interface can define requirements 
that do not apply to all sub-interfaces of the Collection interface. 


3.4.11.5.8.1 Stipulations on set 


For example, the add method of the Set interface stipulates the following: 
"Adds the specified element to this set if it is not already present." 

On the other hand, the add method of the Collection interface simply states: 
"Ensures that this collection contains the specified element." 


Thus, the contract for the add method of an object of a class that implements the Set interface is more 
specialized than the contract for the add method of an object of a class that implements the Collection 
interface. 

An additional stipulation on the constructor for a Set object is that all constructors must create a set 
that contains no duplicate elements. 


3.4.11.5.8.2 Stipulations on SortedSet 


The SortedSet interface extends the Set interface. The SortedSet interface contains the following 
stipulation that makes it more specialized than a Set 

"A set that further guarantees that its iterator will traverse the set in ascending element order, sorted 
according to the natural ordering of its elements (see Comparable ), or by a Comparator provided at 
sorted set creation time." 


3.4.11.5.9 We will end with a quiz 


Tm going to finish this module with several questions in the form of a quiz. To ensure that this is a learning 
experience, I will provide an explanation in addition to the answer for each question. 
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3.4.11.5.9.1 Question 1 


True or False? A collection that implements the List interface maintains its elements in ascending 
alphanumeric order. 

The answer to question 1 is False. Unlike collections that implement the SortedSet interface, the order 
of the elements in a collection that implements the List interface is not based on the values of the objects 
referred to by the elements in the list. 


3.4.11.5.9.2 Question 2 


True or False? A collection that implements the List interface is an unordered collection. 

The answer to question 2 is also False. A collection that implements the List interface is an ordered 
collection (also known as a sequence) . According to Oracle, "The user of the interface has precise control 
over where in the list each element is inserted." Elements can be inserted and retrieved on the basis of their 
integer index (position in the list) using the following methods: 


e add(int index, Object element) 
e get(int index) 


Valid index values are positive integers that begin with zero. When the add method is used to insert 
an element at a specific position in the sequence, the element currently at that position (if any) and any 
subsequent elements are shifted toward higher index values to make room for the new element. 

Another version of the add method takes a reference to an object as an incoming parameter and 
appends the specified element to the end of the collection. 

The get method simply returns the element at the specified position in the collection. 

The List interface also declares various other methods that can be used to manipulate the contents of 
the collection. 


3.4.11.5.9.3 Question 3 


True or False? A collection that implements the List interface is allowed to contain duplicate values. 

The answer to question 3 is True. Unlike a collection that implements the Set interface, a collection that 
implements the List interface is typically allowed to contain duplicate values. More formally, according to 
Oracle, "lists typically allow pairs of elements e1 and e2 such that el.equals(e2), and they typically allow 
multiple null elements if they allow null elements at all." 


3.4.11.5.9.4 Question 4 


True or False? The contracts of the methods in the List interface are the same as the contracts of the 
methods inherited from the Collection interface. 

The answer to question 4 is False. According to Oracle, "The List interface places additional stipu- 
lations, beyond those specified in the Collection interface, on the contracts of the iterator , add , 
remove , equals , and hashCode methods." 

For example, the iterator method (for both the List and Collection interfaces) returns an iterator 
over the elements in the collection. For the Collection interface, there are no guarantees concerning the 
order in which the elements are returned by the methods of the Iterator object. 

On the other hand, the iterator method for the List interface returns an iterator over the elements 
in the collection in proper sequence, where the sequence is determined by the numeric index. In other words, 
when you call the methods of the Iterator object ona List , the elements will be returned in the proper 
sequence as determined by a numeric index. 

Similarly, according to Oracle, the SortedSet interface "guarantees that its iterator will traverse the 
set in ascending element order, sorted according to the natural ordering of its elements (see Comparable 
), or by a Comparator provided at sorted set creation time." 
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3.4.11.6 Summary 


In this module you learned that all of the implementations of the interfaces in the Collection hierarchy 
implement one of the sub-interfaces of the Collection interface. You learned that a Set object cannot 
contain duplicate elements, but a List object can contain duplicate elements. 

You learned about the difference between ordered collections and sorted collections. You also learned 
about ascending order and the natural ordering of objects. In addition, you learned how more specialized 
stipulations are placed on interfaces as you progress down the interface inheritance hierarchy of the Java 
Collections Framework. 


3.4.11.7 What’s next? 


The SortedSet interface "guarantees that its iterator will traverse the set in ascending element order, 
sorted according to the natural ordering of its elements (see Comparable ), or by a Comparator 
provided at sorted set creation time." In the next module, I will show you how to use the Comparator 
interface to control the sorted order of your collections. 


3.4.11.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4060: Duplicate Elements, Ordered Collections, Sorted Collections, and 
Interface Specialization 

e File: Java4060.htm 

e Published: 04/18/13 

e Revised 12/09/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.4.12 Java4060r: Review” 
3.4.12.1 Table of Contents 


e Preface (p. 1154) 
e Questions (p. 1154) 


1 (p. 1154) , 2 (p. 1154) , 3 (p. 1154) , 4 (p. 1154) , 5 (p. 1155) , 6 (p. 1155) , 7 (p. 1155) , 8 
(p. 1155) , 9 (p. 1155) , 10 (p. 1155) , 11 (p. 1155) , 12 (p. 1156) , 13 (p. 1156) , 14 (p. 1156) 
, 15 (p. 1156) , 16 (p. 1156) , 17 (p. 1156) , 18 (p. 1156) , 19 (p. 1156) , 20 (p. 1156) , 21 (p. 
1157) , 22 (p. 1157) , 23 (p. 1157) 


e Answers (p. 1158) 
e Miscellaneous (p. 1161) 


3.4.12.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4060: Duplicate 
Elements, Ordered Collections, Sorted Collections, and Interface Specialization 3°? . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.12.3 Questions 

3.4.12.3.1 Question 1 

True or False? The Java Collections Framework defines eight core interfaces, in two distinct trees. 
Answer 1 (p. 1161) 

3.4.12.3.2 Question 2 

True or False? All eight of the core interfaces are rooted in the interface named Collection . 
Answer 2 (p. 1161) 

3.4.12.3.3 Question 3 


True or False? A Set object can contain duplicate elements, but a List object cannot contain duplicate 
elements. 
Answer 3 (p. 1161) 


3.4.12.3.4 Question 4 


True or False? The TreeSet class is a direct implementation of the Collection interface. (See the Java 
documentation.) 
Answer 4 (p. 1161) 


331This content is available online at <http://cnx.org/content /m48121/1.3/>. 
332http://cnx.org/content /m46141/latest /?collection=col11441 /latest 
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3.4.12.3.5 Question 5 


True or False? The interface hierarchy for the Java Collections Framework is shown below with indentation 
used to show a parent-child relationship: 


e Collection 
Set 
x SortedSet 
List 
Queue 
Deque 


e Map 
SortedMap 


Answer 5 (p. 1161) 


3.4.12.3.6 Question 6 


True or False? The ArrayList class is a direct implementation of the Collection interface. (See the Java 
documentation.) 
Answer 6 (p. 1160) 


3.4.12.3.7 Question 7 


True or False? In Java, a Set is a collection that contains no duplicate elements. The Set interface 
models the mathematical set abstraction. 
Answer 7 (p. 1160) 


3.4.12.3.8 Question 8 


True or False? In Java, a List is an ordered collection (also known as a sequence) . The user of the List 
interface has precise control over where in the list each element is inserted. The user can access elements by 
their integer index (position in the list) , and search for elements in the list. 

Answer 8 (p. 1160) 


3.4.12.3.9 Question 9 
True or False? The term ordered is a synonym for sorted . 
Answer 9 (p. 1160) 


3.4.12.3.10 Question 10 


True or False? An ordered collection is one in which the position of each element is determined by its value 
relative to the values of its predecessors and successors. 
Answer 10 (p. 1160) 


3.4.12.3.11 Question 11 


True or False? A sorted collection is one in which the position of each element is determined by its value 
relative to the values of its predecessors and successors. 
Answer 11 (p. 1160) 
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3.4.12.3.12 Question 12 

True or False? Ascending sort order is always required for a Java collection. 
Answer 12 (p. 1160) 

3.4.12.3.13 Question 13 


True or False? Ascending sort order is always required for a Java collection that implements the SortedSet 
interface. 

Answer 13 (p. 1160) 
3.4.12.3.14 Question 14 


True or False? If a SortedSet object contains references to String objects, the natural ascending sort 
would take the difference between upper case and lower case characters into account. 

Answer 14 (p. 1159) 
3.4.12.3.15 Question 15 


True or False? A SortedSet object containing references to String objects will always take the difference 
between upper case and lower case characters into account when establishing the sort order. 
Answer 15 (p. 1159) 


3.4.12.3.16 Question 16 
True or False? Specific sub-interfaces of the Collection interface can define requirements that do not 
apply to all sub-interfaces of the Collection interface. 
Answer 16 (p. 1159) 
3.4.12.3.17 Question 17 


True or False? A collection that implements the List interface maintains its elements in ascending 
alphanumeric order. 
Answer 17 (p. 1159) 
3.4.12.3.18 Question 18 
True or False? A collection that implements the List interface is an unordered collection. 
Answer 18 (p. 1159) 
3.4.12.3.19 Question 19 
True or False? A collection that implements the List interface is allowed to contain duplicate values. 
Answer 19 (p. 1159) 
3.4.12.3.20 Question 20 


True or False? The contracts of the methods in the List interface are the same as the contracts of the 
methods inherited from the Collection interface. 
Answer 20 (p. 1158) 
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3.4.12.3.21 Question 21 


True or False? The iterator method for the Collection interface returns an iterator over the elements 
in the collection in proper sequence, where the sequence is determined by the numeric index. 
Answer 21 (p. 1158) 


3.4.12.3.22 Question 22 


True or False? The iterator method for the List interface returns an iterator over the elements in the 
collection in proper sequence, where the sequence is determined by the numeric index. 
Answer 22 (p. 1158) 


3.4.12.3.23 Question 23 


True or False? The SortedSet interface "guarantees that its iterator will traverse the set in ascending 
element order, sorted according to the natural ordering of its elements (see Comparable ), or by a 
Comparator provided at sorted set creation time." 

Answer 23 (p. 1158) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None 


Display your namei 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Put your name here 


ho 


A | 
Cra ai i 


3.4.12.4 Answers 
3.4.12.4.1 Answer 23 
True. 

Back to Question 23 (p. 1157) 
3.4.12.4.2 Answer 22 
True. 

Back to Question 22 (p. 1157) 
3.4.12.4.3 Answer 21 


False. The iterator method for the Collection interface returns an iterator over the elements in the 
collection where there are no guarantees concerning the order in which the elements are returned by the 
methods of the Iterator object. 

Back to Question 21 (p. 1157) 


3.4.12.4.4 Answer 20 


False. According to Oracle, "The List interface places additional stipulations, beyond those specified 
in the Collection interface, on the contracts of the iterator , add , remove , equals , and 
hashCode methods." 

Back to Question 20 (p. 1156) 
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3.4.12.4.5 Answer 19 


True. Unlike a collection that implements the Set interface, a collection that implements the List interface 
is typically allowed to contain duplicate values. 
Back to Question 19 (p. 1156) 


3.4.12.4.6 Answer 18 


False. A collection that implements the List interface is an ordered collection (also known as a sequence) 
. According to Oracle, "The user of the interface has precise control over where in the list each element is 
inserted." Elements can be inserted and retrieved on the basis of their integer index (position in the list) 
using the following methods: 


e add(int index, Object element) 
e get(int index) 


Valid index values are positive integers that begin with zero. 

Another version of the add method takes a reference to an object as an incoming parameter and 
appends the specified element to the end of the collection. 

Back to Question 18 (p. 1156) 
3.4.12.4.7 Answer 17 


False. Unlike collections that implement the SortedSet interface, the order of the elements in a collection 
that implements the List interface is not based on the values of the objects referred to by the elements in 
the list. 

Back to Question 17 (p. 1156) 
3.4.12.4.8 Answer 16 


True. For example, the add method of the Set interface stipulates the following: 
"Adds the specified element to this set if it is not already present." 

On the other hand, the add method of the Collection interface simply states: 
"Ensures that this collection contains the specified element." 


Thus, the contract for the add method of an object of a class that implements the Set interface is more 
specialized than the contract for the add method of an object of a class that implements the Collection 
interface. 

Back to Question 16 (p. 1156) 


3.4.12.4.9 Answer 15 


False. You can cause the sort order to ignore case by providing an object of a class that implements the 
Comparator interface, and which defines the compare method and the equals method in such a 
way as to eliminate case considerations for comparisons of String objects. 

Back to Question 15 (p. 1156) 


3.4.12.4.10 Answer 14 


True. 
Back to Question 14 (p. 1156) 
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3.4.12.4.11 Answer 13 


False. Implementations of the interface named SortedSet do maintain their elements in sorted order. 
However, that order is not necessarily ascending. When an object is instantiated from a class that implements 
the SortedSet interface, the sorting order for that object can be established by providing an object 
instantiated from a class that implements the Comparator interface. In that case, the author of the 
class that implements the Comparator interface determines the order imposed on the elements in the 
collection. 
Back to Question 13 (p. 1156) 
3.4.12.4.12 Answer 12 


False. Not all implementations of the Collection interface maintain the elements in ascending sort order. 
Some may, and others do not. For example, implementations of the List interface (such as ArrayList 
) do not maintain their elements in sorted order at all. In other words, the position of an element in an 
ArrayList does not depend on the value of the element. 

Back to Question 12 (p. 1156) 
3.4.12.4.13 Answer 11 
True. 

Back to Question 11 (p. 1155) 
3.4.12.4.14 Answer 10 


False. An ordered collection is one in which each element in the collection has a specific position specified 
by an index. 
Back to Question 10 (p. 1155) 


3.4.12.4.15 Answer 9 


False. An ordered collection is not the same as a sorted collection. 
Back to Question 9 (p. 1155) 


3.4.12.4.16 Answer 8 


True, according to Oracle. 
Back to Question 8 (p. 1155) 


3.4.12.4.17 Answer 7 


True, according to Oracle. 
Back to Question 7 (p. 1155) 


3.4.12.4.18 Answer 6 
False. 


ArrayList class: 


public class ArrayList<E> extends AbstractList<E> 
implements List<E>, RandomAccess, Cloneable, Serializable 
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The Java Collections Framework doesn’t provide any direct implementations of the Collection interface. 
All of the implementations of the interfaces in the Collection hierarchy implement one of the sub-interfaces 
of the Collection interface. In the case of the ArrayList class, that sub-interface is the List interface, 
which extends the Collection interface. 

Back to Question 6 (p. 1155) 


3.4.12.4.19 Answer 5 


True. 
Back to Question 5 (p. 1155) 


3.4.12.4.20 Answer 4 


False. The TreeSet class is not a direct implementation of the Collection interface. Rather, the 
TreeSet class is a direct implementation of the SortedSet interface. The SortedSet interface extends 
the Set interface, and the Set interface extends the Collection interface. 

Back to Question 4 (p. 1154) 


3.4.12.4.21 Answer 3 


False. A Set object cannot contain duplicate elements, but a List object can contain duplicate elements. 
Back to Question 3 (p. 1154) 


3.4.12.4.22 Answer 2 


False. One of the trees, which consists of six interfaces, is rooted in the interface named Collection . The 
other tree, which consists of two interfaces, is rooted in the interface named Map 
Back to Question 2 (p. 1154) 


3.4.12.4.23 Answer 1 


True. 
Back to Question 1 (p. 1154) 


3.4.12.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4060r: Review 
e File: Java4060r.htm 

e Published: 11/30/13 

e Revised 12/09/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
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was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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x Controlling the locations of the elements (p. 1169) 
x Add method actually does an insert (p. 1170) 
The Vector class (p. 1170) 
More on the List contract (p. 1170) 
x Duplicates are allowed in a List (p. 1170) 
One more sample program (p. 1171) 
x No need to cast to type List (p. 1173) 
What happened to the Comparable interface? (p. 1173) 
x Comparable interface is not required for a List (p. 1173) 
x No requirement to compare (p. 1174) 
x Comparison is required for a SortedSet (p. 1174) 


Run the program (p. 1174) 
Summary (p. 1174) 
What’s next? (p. 1174) 
Miscellaneous (p. 1174) 


333This content is available online at <http://cnx.org/content/m46142/1.4/>. 
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3.4.13.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections Framework in particular. 

This is also the first module in a sub-collection on the Comparable interface. The purpose of the 
modules in this sub-collection is to teach you about the interactions between the Comparable interface 
and the Collections Framework, particularly with respect to the Set , SortedSet , and SortedMap 
interfaces of the Collections Framework. 

This module explains the (lack of) interaction between the Comparable interface and the Java 
Collections Framework with respect to collections of type List 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 334 in 
Oracle’s Java Tutorials 335 . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.13.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


3.4.13.2.1.1 Listings 


e Listing 1 (p. 1165) . The program named Comparable(01. 
e Listing 2 (p. 1166) . The code with the problem. 

e Listing 3 (p. 1168) . The program named Comparable(2. 
e Listing 4 (p. 1169) . The corrected code. 

e Listing 5 (p. 1170) . Display using an iterator. 

e Listing 6 (p. 1172) . The program named Comparable(3. 
e Listing 7 (p. 1173) . No need to cast to type List. 


3.4.13.3 Preview 


In this module, I will begin discussing the interaction between the Comparable interface and the Collec- 
tions Framework. 


3.4.13.3.1 Generics 


The code in this module is written with no thought given to Generics 336 . As a result, if you copy and 


compile this code, you will probably get a warning about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.13.3.2 Specialization 


I will provide a concrete example of the specialization that occurs while moving down the interface hierarchy 
from Collection to List . I will show an example of using two different overloaded versions of the 
add method to add new elements to an ArrayList object. One version is declared in the Collection 
interface and both versions are declared in the List interface. 


334http://docs.oracle.com/javase /tutorial/collections/index.html 
335http://docs.oracle.com/javase/tutorial/index.html 
336http://docs.oracle.com/javase/tutorial/java/generics/index.html 
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3.4.13.3.3 To cast, or not to cast 


I will illustrate the use of a cast to change the type of a reference from Collection to List , in order 
to call a version of the add method that is declared only in the List interface. 

This version of the program, (in which the add method actually does an insert) makes it possible for 
the user to control the location of each individual element added toa List . The fact that the location of 
each element can be controlled in a List is what causes a List to be an ordered collection. 

I will illustrate that a cast is not required on a reference being treated as type Collection in order to 
call the version of the add method that is declared in the Collection interface. This version of the add 
method supports the addition of new elements only at the end of the List 


3.4.13.3.4 Comparable interface not required for a List 


Finally, I will show that it is not necessary for objects to implement the Comparable interface to make 
them eligible for inclusion in a List . I will tell you that it is necessary for objects to implement the 
Comparable interface to make them eligible for inclusion ina SortedSet , although I won’t demonstrate 
that in this module. 


3.4.13.4 Discussion and sample code 
3.4.13.4.1 We will begin with a quiz 


Let’s begin with a quiz to test your prior knowledge of the Collections Framework. 
What output is produced by the program shown in Listing 1 (p. 1165) ? 


. Compiler Error 

. Runtime Error 

. 44321 

. 4321 

1234 

. 12344 

. None of the above. 


eoeeeeeeee@ 
QHA 
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Listing 1 . The program named Comparable01. 


//File Comparable01.java 
import java.util.*; 


public class Comparable01if{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparable01 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new ArrayList(); 
Populator.fillIt (ref); 
iter = ref.iterator(); 
while(iter.hasNext())f{ 
System.out.print(iter.next()); 
}//end while loop 
System. out.println() ; 
}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(0,new MyClass(4)); 
ref.add(1,new MyClass(4)); 
ref .add(2,new MyClass(3)); 
ref .add(3,new MyClass(2)); 
ref.add(4,new MyClass(1)); 
}//end fillIt() 
}//end class Populator 


class MyClass{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String toString(){ 
return "" + data; 
}//end overridden toString () 
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Table 3.462 
If your answer was A. Compiler Error , you were correct. 


3.4.13.4.1.1 What caused the compiler error? 


The compiler error was caused by the code shown in Listing 2 (p. 1166) . 


Listing 2 . The code with the problem. 


public static void fillIt(Collection ref){ 
ref.add(0,new MyClass(4)); 


Table 3.463 


The problem here is that the method named fillIt receives a reference to an object of the ArrayList 
class as the interface type Collection , and attempts to call the following overloaded method on that 
reference: 

add(int index, Object element) 
However, the Collection interface knows nothing about a method having that signature. 


3.4.13.4.1.2 Implements Collection and List 


The ArrayList class implements both the Collection interface and the List interface. As you may 
recall from earlier modules in this series, List is a sub-interface of Collection . The List interface 
declares the following overloaded versions of the add method: 


e add(Object o) 
e add(int index, Object element) 


The second of these two methods, which is called in Listing 2 (p. 1166) , is unknown to the Collection 
interface. The Collection interface declares only the first version of the add method shown above. 


3.4.13.4.1.3 Specialization 


This is the result of specialization. A List object is a more-specialized collection than a Collection 
object. 

Therefore, the version of the add method that requires two parameter cannot be called on a reference 
toan ArrayList object when that object is treated as the generic type Collection . 


3.4.13.4.2 Modified program 


Now, take a look at the modified version of the program as shown in Listing 3 (p. 1168) . 
What output is produced by the program shown in Listing 3 (p. 1168) ? 


. Compiler Error 
. Runtime Error 
. 44321 

. 4321 

. 1234 

. 12344 


Joa e 
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e G. 443521 
e H. None of the above. 
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Listing 3 . The program named Comparable02. 


//File Comparable02.java 
import java.util.*; 


public class Comparable02{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparable02 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new ArrayList(); 
Populator.fillIt (ref); 
iter = ref.iterator(); 
while(iter.hasNext())f{ 
System.out.print(iter.next()); 
}//end while loop 
System. out.println() ; 
}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
((List) ref) .add(O0,new MyClass(4)); 
((List) ref) .add(1,new MyClass(4)); 
((List) ref) .add(2,new MyClass(3)); 
((List) ref) .add(3,new MyClass(2)); 
((List) ref) .add(4,new MyClass(1)); 
((List) ref) .add(3,new MyClass(5)); 
}//end fillIt() 
}//end class populator 


class MyClass{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String toString(){ 
return "" + data; 
}//end overridden toString () 
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Table 3.464 


If your answer was G. 443521 , you are correct. 


3.4.13.4.2.1 The corrected code 


This version of the program illustrates a mechanism for correcting the problem in the earlier program shown 
in Listing 1 (p. 1165) . The updated code that corrected the problem is shown in Listing 4 (p. 1169) . 


Listing 4 . The corrected code. 


class Populator{ 

public static void fillIt(Collection ref){ 
((List) ref) .add(O0,new MyClass(4)); 
((List) ref) .add(1,new MyClass(4)); 
((List) ref) .add(2,new MyClass(3)); 
((List) ref) .add(3,new MyClass(2)); 
((List) ref) .add(4,new MyClass(1)); 
((List) ref) .add(3,new MyClass(5)); 

}//end fillIt() 

}//end class populator 


Table 3.465 


The incoming parameter to the fillIt method in Listing 4 (p. 1169) is a reference to an object instantiated 
from the ArrayList class. That reference is passed to the fillIt method as type Collection , which is 
legal because the ArrayList class implements both the Collection interface and the List interface. 


3.4.13.4.2.2 Casting to type List 


The code in Listing 4 (p. 1169) uses a cast to convert the incoming reference from type Collection to type 

List . Because the version of the add method that is used in Listing 4 (p. 1169) is declared in the List 
interface, and because the ArrayList class correctly implements the List interface, that version of the 
add method can be called on the reference to the ArrayList object when it is treated as the interface 
type List . Hopefully this is review material for you at this point. If not, you may need to go back and 
study some of my earlier modules. 


3.4.13.4.3 The List contract for the add method 


Listing 4 (p. 1169) also illustrates part of the contract for this version of the add method in the List 
interface. This version of the add method makes it possible to specify the position of each element added 
tothe ArrayList object. 


(A List is an ordered collection because the user has control over the location of each element 
in the collection relative to the other elements in the collection.) 


3.4.13.4.3.1 Controlling the locations of the elements 


In Listing 4 (p. 1169) , the elements are added to the ArrayList object in increasing element order during 
the first five invocations of the add method. However, the sixth invocation of the add method adds a 
new element at index position 3. 
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3.4.13.4.3.2 Add method actually does an insert 


A portion of the contract for this version of the add method in the List interface is as follows: 


"Inserts the specified element at the specified position in this list (optional operation). Shifts 
the element currently at that position (if any) and any subsequent elements to the right (adds 
one to their indices)." 


Thus, the new element is inserted at that position, and the other elements are pushed up, as required, toward 
higher index values to make room for the new element. 


3.4.13.4.4 The Vector class 


Here is an interesting side note. The Java Vector class has been around longer than the Collections 
Framework. Somewhere along the way, the Vector class was upgraded to cause it to become a concrete 
implementation of the Collection interface and the List interface. 

As a result of the upgrade, the Vector class now provides an implementation of the add method 
described above. Except for the order of the parameters, that add method appears to have the same 
behavior as the older method named: 

insertElementAt(Object elem, int index) 

You can insert elements into a Vector object by calling the add method on that object while treating 
it as type List . However, since the older insertElementAt method is not declared in the List 
interface, you cannot insert an element into the Vector object by calling the insertElementAt method 
while treating it asa List . In order to call that method, you must treat it as type Vector 


3.4.13.4.5 More on the List contract 
Another portion of the contract for a List object is that the iterator method 
"Returns an iterator over the elements in this list in proper sequence." 


As a result, the code shown in Listing 5 (p. 1170) , along with the overridden toString method of the 
MyClass class causes the program to display the elements in the following order: 
443521 


Listing 5 . Display using an iterator. 


iter = ref.iterator(); 
while (iter.hasNext())f{ 
System.out.print(iter.next()); 
}//end while loop 


Table 3.466 


3.4.13.4.6 Duplicates are allowed in a List 


One final thing that is worthy of note in this program is that a List objects allows duplicates. Hence, the 
populated collection contains references to two separate objects that are equal to one another in the sense 
that they both contain the same values in their instance variables. 
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3.4.13.4.7 One more sample program 


Let’s take a look at one more sample program. What output is produced by the program shown in Listing 
6 (p. 1172) ? 


. Compiler Error 

. Runtime Error 

. 44321 

. 4321 

. 1234 

. 12344 

. None of the above. 


e o o o o o o 
QyUAvaAaSe 
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Listing 6 . The program named Comparable03. 


//File Comparable03.java 
import java.util.*; 


public class Comparable03{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparable03 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new ArrayList(); 
Populator.fillIt (ref); 
iter = ref.iterator(); 
while(iter.hasNext())f{ 
System.out.print(iter.next()); 
}//end while loop 
System. out.println() ; 
}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(new MyClass(4)); 
ref.add(new MyClass(4)); 
ref.add(new MyClass(3)); 
ref.add(new MyClass(2)); 
ref.add(new MyClass(1)); 
}//end fillIt() 
}//end class populator 


class MyClass{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String toString(){ 
return "" + data; 


}//end overridden toString () 


}//end MyClass 
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Table 3.467 


If you selected C. 44321 , you are correct. 


3.4.13.4.7.1 No need to cast to type List 


As shown in Listing 7 (p. 1173) , this program takes a different approach to solving the problem originally 
exposed in the program shown in Listing 1 (p. 1165) . 


Listing 7 . No need to cast to type List. 


class Populator{ 
public static void fillIt( 

Collection ref){ 
ref.add(new MyClass(4)); 
ref.add(new MyClass(4)); 
ref.add(new MyClass(3)); 
ref.add(new MyClass(2)); 
ref.add(new MyClass(1)); 

}//end fillIt() 
}//end class populator 


Table 3.468 


This program does not change the type of the incoming reference to the ArrayList object in the fillit 
method. Rather, it continues to treat the incoming reference as type Collection , and calls the version of 
the add method that is declared in the Collection interface. This avoids the requirement to cast the 
incoming reference to type List 

The contract for this version of the add method in the List interface is 


"Appends the specified element to the end of this list (optional operation)." 


As a result, the new elements are added to the collection in increasing index order. Since an iterator on a 
List returns the elements in increasing index order, this program displays the elements in the same order 
that they are added. 


3.4.13.4.8 What happened to the Comparable interface? 


By now, you are probably wondering what all of this has to do with the Comparable interface, because 
I haven’t mentioned that interface since the introductory comments at the beginning of the module. 


3.4.13.4.8.1 Comparable interface is not required for a List 


Actually, the purpose of this module is to illustrate the lack of any requirement to make use of the Compa- 
rable interface with List objects. In particular, the purpose is to illustrate that this is one of the features 
that differentiates between a List object anda Set or SortedSet object. 

A List can be used as a container for other objects regardless of whether or not those objects implement 
the Comparable interface. However, in the next module, we will see that objects must implement the 
Comparable interface in order to be eligible for inclusion in collections that implement the SortedSet 
interface. 

This and the next several modules are intended to provide you with an understanding of the interaction 
between the Comparable interface, the Comparator interface, and the Collections Framework. 
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3.4.13.4.8.2 No requirement to compare 


Because a List makes no attempt to eliminate duplicate elements, or to sort the elements on the basis of 
their values, there is no requirement to compare objects when placing them ina List . Therefore, objects 
whose references are stored in a List are not required to implement the Comparable interface (but 
they may implement the Comparable interface without causing any harm) . 


3.4.13.4.8.3 Comparison is required for a SortedSet 


Because a SortedSet does eliminate duplicates and does sort the elements on the basis of their values, 
there is a requirement to compare each new element with the existing elements ina SortedSet whenever 
a new element is added to the collection. Therefore, objects whose references are stored in a SortedSet 
are required to implement the Comparable interface. 


3.4.13.5 Run the program 


I encourage you to copy the code from Listing 1 (p. 1165) , Listing 3 (p. 1168) , and Listing 6 (p. 1172) . 
Paste the code into your Java editor. Then compile and execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 


3.4.13.6 Summary 


In this module, I began discussing the interaction between the Comparable interface and the Collections 
Framework. 

I provided a concrete example of the specialization that occurs when moving down the interface hierarchy 
from Collection to List . I showed an example of using two different overloaded versions of the add 
method to add new elements to an ArrayList object. One version is declared in the Collection interface 
and both versions are declared in the List interface. 

I illustrated the use of a cast to change the type of a reference from Collection to List , in order 
to call a version of the add method that is declared only in the List interface. This version makes it 
possible for the user to control the location of each individual element added to a List 

I illustrated that a cast is not required on a reference being treated as type Collection in order to call 
the version of the add method that is declared in the Collection interface. This version of the add 
method supports the addition of new elements only at the end of the List 

Finally, I explained that it is not necessary for objects to implement the Comparable interface to 
make them eligible for inclusion in a List 

Although I didn’t demonstrate it, I told you that it is necessary for objects to implement the Compa- 
rable interface to make them eligible for inclusion in a SortedSet 


3.4.13.7 What’s next? 


The next module will begin exploring the interaction between the Comparable interface and the Sort- 
edSet interface of the Collections Framework. 


3.4.13.8 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4070: The Comparable Interface, Part 1 
e File: Java4070.htm 
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e Published: 04/19/13 
e Revised 12/08/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.4.14 Java4070r: Review” 

3.4.14.1 Table of Contents 

Preface (p. 1176) 

Questions (p. 1176) 
1 (p. 1176) , 2 (p. 1176) , 3 (p. 1176) , 4 (p. 1176) , 5 (p. 1177) , 6 (p. 1177) , 7 (p. 1177) , 8 
(p. 1177) , 9 (p. 1177) , 10 (p. 1177) , 11 (p. 1178) , 12 (p. 1178) 

Listings (p. 1178) 

Answers (p. 1179) 


Complete program listings (p. 1180) 
Miscellaneous (p. 1186) 


3.4.14.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4070: The Comparable 
Interface, Part 1 338 . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.14.3 Questions 
3.4.14.3.1 Question 1 


True or False? The fact that the location of each element can be controlled ina List is what causes a 
List to be an unordered collection. 
Answer 1 (p. 1180) 


3.4.14.3.2 Question 2 


True or False? It is not necessary for objects to implement the Comparable interface to make them 
eligible for inclusion in a List 
Answer 2 (p. 1180) 


3.4.14.3.3 Question 3 


True or False? It is not necessary for objects to implement the Comparable interface to make them 
eligible for inclusion in a SortedSet 
Answer 3 (p. 1180) 


3.4.14.3.4 Question 4 


What output is produced by the program shown in Listing 1 (p. 1180) ? 


e Compiler Error 
e 44321 

e 4321 

e 1234 


337This content is available online at <http://cnx.org/content /m48122/1.4/>. 
338http://cnx.org/content /m46142/latest /?collection=coll 1441 /latest 
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e 12344 
Answer 4 (p. 1180) 


3.4.14.3.5 Question 5 


True or False? The Collection interface declares the following overloaded versions of the add method. 
(See the Java documentation.) 


e add(Object o) 
e add(int index, Object element) 


Answer 5 (p. 1180) 


3.4.14.3.6 Question 6 


True or False? A List object is a more-specialized collection than a Collection object. 
Answer 6 (p. 1180) 


3.4.14.3.7 Question 7 


True or False? The version of the add method that requires two parameters cannot be called on a reference 
toan ArrayList object when that object is treated as the generic type Collection . (See the Java 
documentation.) 

Answer 7 (p. 1180) 


3.4.14.3.8 Question 8 
What output is produced by the program shown in Listing 2 (p. 1183) ? 


e Compiler Error 
44321 

4321 

1234 

12344 

443521 


Answer 8 (p. 1179) 


3.4.14.3.9 Question 9 


True or False? A List is an ordered collection because the user has control over the location of each element 
in the collection relative to the other elements in the collection. 
Answer 9 (p. 1179) 


3.4.14.3.10 Question 10 
What output is produced by the program shown in Listing 3 (p. 1185) ? 


Compiler Error 
Runtime Error 
44321 

4321 

1234 

12344 


Answer 10 (p. 1179) 
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3.4.14.3.11 Question 11 


True or False? Because a List makes no attempt to eliminate duplicate elements, or to sort the elements 
on the basis of their values, there is no requirement to compare objects when placing them in a List 
Therefore, objects whose references are stored ina List are not required to implement the Comparable 
interface (but they may implement the Comparable interface without causing any harm) . 

Answer 11 (p. 1179) 


3.4.14.3.12 Question 12 


True or False? Because a SortedSet does eliminate duplicates and does sort the elements on the basis 
of their values, there is a requirement to compare each new element with the existing elements in a 
SortedSet whenever a new element is added to the collection. Therefore, objects whose references are 
stored in a SortedSet are required to implement the Comparable interface. 

Answer 12 (p. 1179) 


3.4.14.4 Listings 


e Listing 1 (p. 1180) . Comparable01 java. 
e Listing 2 (p. 1183) . Comparable02.java. 
e Listing 3 (p. 1185) . Comparable03.java. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None E ex) 


Display your nami 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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3.4.14.5 Answers 
3.4.14.5.1 Answer 12 
True. 

Back to Question 12 (p. 1178) 
3.4.14.5.2 Answer 11 
True. 

Back to Question 11 (p. 1178) 
3.4.14.5.3 Answer 10 
44321 

Back to Question 10 (p. 1177) 
3.4.14.5.4 Answer 9 
True. 

Back to Question 9 (p. 1177) 
3.4.14.5.5 Answer 8 


443521 
Back to Question 8 (p. 1177) 
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3.4.14.5.6 Answer 7 
True. 

Back to Question 7 (p. 1177) 
3.4.14.5.7 Answer 6 
True 

Back to Question 6 (p. 1177) 
3.4.14.5.8 Answer 5 


False. The List interface declares the following overloaded versions of the add method but the Collection 
interface declares only the first one of the two. 


e add(Object o) 
e add(int index, Object element) 


Back to Question 5 (p. 1177) 


3.4.14.5.9 Answer 4 


Compiler Error. The method named fillIt receives a reference to an object of the ArrayList class as 
the interface type Collection , and attempts to call the following overloaded method on that reference: 
add(int index, Object element) 
However, the Collection interface knows nothing about a method having that signature. 
Back to Question 4 (p. 1176) 


3.4.14.5.10 Answer 3 
False. It is necessary for objects to implement the Comparable interface to make them eligible for 
inclusion in a SortedSet 
Back to Question 3 (p. 1176) 
3.4.14.5.11 Answer 2 
True. 
Back to Question 2 (p. 1176) 
3.4.14.5.12 Answer 1 


False. The fact that the location of each element can be controlled ina List is what causes a List to be 
an ordered collection. 
Back to Question 1 (p. 1176) 


3.4.14.6 Complete program listings 


Listing 1 . Comparable01.java. 


continued on next page 
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//File Comparable01.java 
import java.util.*; 


public class Comparable01if{ 
public static void main(String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Comparable01 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new ArrayList(); 
Populator.fillIt (ref); 
iter = ref.iterator(); 
while (iter.hasNext())f{ 
System.out.print(iter.next()); 
}//end while loop 
System. out.println(); 
}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(0,new MyClass(4)); 
ref.add(1,new MyClass(4)); 
ref .add(2,new MyClass(3)); 
ref .add(3,new MyClass(2)); 
ref.add(4,new MyClass(1)); 
}//end fillIt() 
}//end class Populator 


class MyClass{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String toString(){ 
return "" + data; 


}//end overridden toString () 


}//end MyClass 
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Table 3.469 
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Listing 2 . Comparable02.java. 


//File Comparable02.java 
import java.util.*; 


public class Comparable02{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparable02 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new ArrayList(); 
Populator.fillIt (ref); 
iter = ref.iterator(); 
while(iter.hasNext())f{ 
System.out.print(iter.next()); 
}//end while loop 
System. out.println() ; 
}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
((List) ref) .add(O0,new MyClass(4)); 
((List) ref) .add(1,new MyClass(4)); 
((List) ref) .add(2,new MyClass(3)); 
((List) ref) .add(3,new MyClass(2)); 
((List) ref) .add(4,new MyClass(1)); 
((List) ref) .add(3,new MyClass(5)); 
}//end fillIt() 
}//end class populator 


class MyClass{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String toString(){ 
return "" + data; 
}//end overridden toString () ; 
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Table 3.470 
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Listing 3. Comparable03.java. 


//File Comparable03.java 
import java.util.*; 


public class Comparable03{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparable03 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new ArrayList(); 
Populator.fillIt (ref); 
iter = ref.iterator(); 
while(iter.hasNext())f{ 
System.out.print(iter.next()); 
}//end while loop 
System. out.println() ; 
}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(new MyClass(4)); 
ref.add(new MyClass(4)); 
ref.add(new MyClass(3)); 
ref.add(new MyClass(2)); 
ref.add(new MyClass(1)); 
}//end fillIt() 
}//end class populator 


class MyClass{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String toString(){ 
return "" + data; 
}//end overridden toString () 
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Table 3.471 


3.4.14.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4070r: Review 
e File: Java4070r.htm 

e Published: 11/30/13 

e Revised 12/08/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 

In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4.15 Java4080: The Comparable Interface, Part 2°” 
3.4.15.1 Table of Contents 


e Preface (p. 1187) 
Viewing tip (p. 1187) 
x Listings (p. 1187) 
e Preview (p. 1187) 
e Discussion and sample code (p. 1188) 
Generics (p. 1188) 
Begin with a quiz (p. 1188) 
x What caused the runtime error? (p. 1190) 
Why did this code produce a runtime error? (p. 1190) 
What does this mean? (p. 1190) 
The compareTo method (p. 1190) 
A possible exception (p. 1191) 
The SortedSet interface (p. 1191) 
Natural ordering of the elements (p. 1191) 
Conclusion regarding traversal (p. 1191) 


* * * * * * ¥* 


33°This content is available online at <http://cnx.org/content /m46143/1.2/>. 
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x The bottom line (p. 1191) 
The solution (p. 1192) 
x The corrected code (p. 1194) 
The compareTo method (p. 1194) 
Consistent with equals (p. 1195) 
Meeting the consistent with equals requirement (p. 1195) 
The program output (p. 1196) 


* * * * 


Run the program (p. 1196) 
Summary (p. 1196) 
What’s next? (p. 1196) 
Miscellaneous (p. 1196) 


3.4.15.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

This module explains why the elements stored in a TreeSet collection must be references to objects 
instantiated from a class that implements the Comparable interface. The module also briefly discusses 
an alternative approach using the Comparator interface. 

The module shows you how to implement the Comparable interface for a new class definition, explains 
the "natural ordering of the elements" for a class, and discusses the "consistent with equals" requirement. 
Finally, the module shows you how to define a new class whose objects are eligible for inclusion in a TreeSet 
collection. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 34° in 
Oracle’s Java Tutorials 34! . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.15.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


3.4.15.2.1.1 Listings 


e Listing 1 (p. 1189) . The program named Comparable04. 

e Listing 2 (p. 1190) . The code with the problem. 

e Listing 3 (p. 1193) . The program named Comparable05. 

e Listing 4 (p. 1194) . Beginning of the class named MyClass. 
e Listing 5 (p. 1195) . The compareTo method. 

e Listing 6 (p. 1195) . The overridden equals method. 


3.4.15.3 Preview 


In this module, I will teach you why the elements stored in a TreeSet collection must be references to 
objects instantiated from a class that implements the Comparable interface. ( In a subsequent module, 
I will teach you about an alternative approach that makes use of the Comparator interface.) 

I will provide an example of implementing the Comparable interface for a new class definition, and 
will teach you about the natural ordering of the elements for a class. 


340h¢ttp://docs.oracle.com/javase/tutorial/collections/index-html 
341 http://docs.oracle.com/javase /tutorial/index.html 
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I will teach you the meaning of the consistent with equals requirement and show you how to satisfy 
that requirement for a new class definition. 

Finally, I will show you how to define a new class whose objects are eligible for inclusion in a TreeSet 
collection. 


3.4.15.4 Discussion and sample code 


3.4.15.4.1 Generics 


The code in this module is written with no thought given to Generics 34 . As a result, if you copy and 


compile this code, you will probably get a warning about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.15.4.2 Begin with a quiz 


Let’s begin with a quiz to test your prior knowledge of the Collections Framework. 
What output is produced by the program shown in Listing 1 (p. 1189) ? 


. Compiler Error 

. Runtime Error 

. 44321 

. 4321 

1234 

. 12344 

. None of the above. 


eoeeeeee@ 
QHD 


342http://docs.oracle.com/javase/tutorial/java/generics/index.html 
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Listing 1 . The program named Comparable04. 


//File Comparable04. java 
import java.util.*; 


public class Comparable04{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparable04 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new TreeSet(); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

while(iter.hasNext())f{ 
System.out.print(iter.next()); 

}//end while loop 

System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(new MyClass(4)); 
ref.add(new MyClass(4)); 
ref.add(new MyClass(3)); 
ref .add(new MyClass(2)); 
ref.add(new MyClass(1)); 
}//end fillIt() 
}//end class Populator 


class MyClass{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String toString(){ 
return "" + data; 
}//end overridden toString () ; 
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Table 3.472 
If your answer was B. Runtime Error , you were correct. 


3.4.15.4.2.1 What caused the runtime error? 


The runtime error was caused by the code shown in Listing 2 (p. 1190) . 


Listing 2 . The code with the problem. 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(new MyClass(4)); 


Table 3.473 


3.4.15.4.2.2 Why did this code produce a runtime error? 


This code produced a runtime error for the following reasons. 

The incoming parameter of the fillIt method is a reference to an object of type TreeSet but it is 
received as type Collection . The TreeSet class implements the Collection , Set , and SortedSet 
interfaces. (In this module, we will be primarily interested in the Set and SortedSet interfaces.) 

The contract for the add method of the Set interface reads partially as follows: 


"Adds the specified element to this set if it is not already present ... If this set already contains 
the specified element, the call leaves this set unchanged and returns false. ... this ensures that 
sets never contain duplicate elements." 


3.4.15.4.2.3 What does this mean? 


This means that whenever the add method is called ona Set object, the add method must have a way 
of determining if the element being added is a duplicate of an element that already exists in the collection. 
This means that it must be possible for the add method to compare the new element with all of the 
existing elements to determine if the new element is a duplicate of any of the existing elements. 


3.4.15.4.2.4 The compareTo method 


The documentation for the TreeSet class states the following: 


".. the Set interface is defined in terms of the equals operation, but a TreeSet instance 
performs all key comparisons using its compareTo (or compare ) method ..." 


What this means is that insofar as the handling of duplicate elements is concerned, (with the possible 
exception given below involving a Comparator ), in order for a reference to an object to be included in 
a TreeSet collection, the class from which that object is instantiated must implement the Comparable 
interface. 
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3.4.15.4.2.5 A possible exception 


Note that one of the constructors for the TreeSet class makes it possible to instantiate a new object by 
passing a parameter that is a reference to an object that implements the Comparator interface. 

The Comparator interface declares a method named compare , which compares its two arguments for 
order. The text in the above excerpt from the Oracle documentation suggests that when this parameterized 
constructor is used, it may not be necessary for the objects included in the TreeSet collection to implement 
the Comparable interface. 

I won’t discuss that possibility in this module, but I will discuss it in a future module that discusses the 
use of the Comparator interface. For purposes of this module, I will concentrate on the use of a TreeSet 
collection that does not receive a reference to a Comparator object when it is instantiated. 


3.4.15.4.2.6 The SortedSet interface 


The TreeSet class also implements the SortedSet interface. The documentation for the SortedSet 
interface states the following: 


"A set that further guarantees that its iterator will traverse the set in ascending element or- 
der, sorted according to the natural ordering of its elements (see Comparable ), or by a 
Comparator provided at sorted set creation time." 


3.4.15.4.2.7 Natural ordering of the elements 


The key term to note in the above quotation is the term natural ordering of its elements . This takes us 
back to the Comparable interface, for which the documentation states: 


"This interface imposes a total ordering on the objects of each class that implements it. This 
ordering is referred to as the class’s natural ordering, and the class’s compareTo method is 
referred to as its natural comparison method." 


3.4.15.4.2.8 Conclusion regarding traversal 


The conclusion is, in order for the iterator to be able to traverse the set according to the natural ordering 
of its elements, the elements stored in an object that implements the SortedSet interface must be 
instantiated from a class that implements the Comparable interface (unless a Comparator is provided 
when the SortedSet object is instantiated.) 


3.4.15.4.2.9 The bottom line 


The bottom line is, because the class named MyClass in Listing 1 (p. 1189) does not implement the 
Comparable interface, objects of that class are not eligible for use with a TreeSet collection (unless a 
Comparator is provided when the TreeSet object is instantiated). 

A Comparator was not provided when the TreeSet object was instantiated in Listing 1 (p. 1189) 
. Therefore, the attempt in Listing 2 (p. 1190) , to add a MyClass object to the TreeSet collection 
resulted ina ClassCastException being thrown at runtime. The runtime error reads partially as follows: 


"Exception ... java.lang.ClassCastException: MyClass cannot be cast to java.lang.Comparable" 
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3.4.15.4.3 The solution 


To solve this problem, we must modify the definition of the class named MyClass to make it implement 
the Comparable interface (assuming that we don’t provide a Comparator when the TreeSet object 


is instantiated). 
This is accomplished in the modified version of the program shown in Listing 3 (p. 1193) . 
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Listing 3 . The program named Comparable05. 


//File Comparable05. java 
import java.util.*; 


public class Comparable05{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparable05 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new TreeSet(); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

while (iter.hasNext()){ 
System.out.print(iter.next()); 

}//end while loop 

System. out.println(); 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(new MyClass(4)); 
ref.add(new MyClass(4)); 
ref.add(new MyClass(3)); 
ref.add(new MyClass(2)); 
ref.add(new MyClass(1)); 
}//end fillIt() 
}//end class Populator 


class MyClass implements Comparablef{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String toString(){ 
return "" + data; 
}//end overridden toString () 
public int compa ae Bs Eee at Cpnnexions <http://cnx.org/content /col11441/1.181> 
if(!(o instanceof MyClass) ) 
throw new ClassCastException() ; 
if(((MyClass)o).data < data) 
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Table 3.474 


3.4.15.4.3.1 The corrected code 


The important code to note in this modified version of the program is the new definition of the class named 
MyClass . The other code in the program is essentially the same as in the previous version of the program. 
The beginning portion of the new definition for MyClass is shown in Listing 4 (p. 1194) . 


Listing 4 . Beginning of the class named MyClass. 


class MyClass implements Comparablef{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String toString(){ 
return "" + data; 
}//end overridden toString () 


Table 3.475 


The code shown in Listing 4 (p. 1194) is identical to the code in the previous version with one major 
exception. This version of the class definition implements the Comparable interface. That means that 
this class must provide a concrete definition for the following method, which is the only method declared in 
the Comparable interface: 

public int compareTo(Object o) 


3.4.15.4.3.2 The compareTo method 


The description of the compareTo method in the Oracle documentation begins as follows: 


"Compares this object with the specified object for order. Returns a negative integer, zero, or 
a positive integer as this object is less than, equal to, or greater than the specified object." 


Beyond this, there are a number of additional stipulations that I won’t repeat here. You can view them in 
the Oracle documentation if you are interested in that level of detail. 

Listing 5 (p. 1195) shows my implementation of the compareTo method. Although this implementation 
satisfies the general description given above, I haven’t taken the time to test it fully to confirm that it meets 
all of the additional stipulations provided by Oracle. 
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Listing 5 . The compareTo method. 


public int compareTo(Object o){ 
if(!(o instanceof MyClass) ) 
throw new ClassCastException() ; 
if(((MyClass)o).data < data) 
return 1; 
if(((MyClass)o).data > data) 
return -1; 
else return 0; 
}//end compareTo() 


Table 3.476 


3.4.15.4.3.3 Consistent with equals 


The Oracle documentation strongly emphasizes the need to make certain that a class’ natural ordering is 
consistent with equals, and provides the rules for meeting that requirement. 
Further, the documentation for the TreeSet class reads partially as follows: 


"Note that the ordering maintained by a set (whether or not an explicit comparator is provided) 
must be consistent with equals if it is to correctly implement the Set interface. ..." 


3.4.15.4.3.4 Meeting the consistent with equals requirement 


In order to satisfy the rules and to cause the natural ordering of the MyClass class to be consistent 
with equals , it was necessary to override the equals method inherited from the Object class. My 
overridden version of the equals method is shown in Listing 6 (p. 1195) . 


Listing 6 . The overridden equals method. 


public boolean equals(Object o){ 

if(!(o instanceof MyClass) ) 

return false; 

if (((MyClass)o).data == data) 
return true; 

else return false; 

}//end overridden equals() 
}//end MyClass 


Table 3.477 
As was the case in defining the compareTo method, there are also a large number of stipulations 


involved in properly overriding the equals method. I will simply refer you to the Oracle documentation if 
you are interested in reading about those stipulations. 
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3.4.15.4.3.5 The program output 


Given all of the above, this program compiles and executes correctly, producing the following output. 
1234 
Note that duplicate elements were eliminated, and the iterator traversed the set in ascending element 
order, sorted according to the natural ordering of the elements, as required for a SortedSet collection. 


3.4.15.5 Run the program 


I encourage you to copy the code from Listing 1 (p. 1189) and Listing 3 (p. 1193) . Paste the code into your 
Java editor. Then compile and execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 


3.4.15.6 Summary 


I explained why the elements stored in a TreeSet collection must be references to objects instantiated 
from a class that implements the Comparable interface. ( In a future module, I will teach you about an 
alternative approach that makes use of the Comparator interface.) 

I provided an example of implementing the Comparable interface for a new class definition, and I 
taught you about the natural ordering of the elements for a class. 

I taught you the meaning of the consistent with equals requirement and showed you how to satisfy that 
requirement for a new class definition. 

I showed you how to define a new class whose objects are eligible for inclusion in a TreeSet collection. 


3.4.15.7 What’s next? 


In the next module, I will discuss the use of the Comparator interface in order to achieve a sorting order 
that is different from the natural ordering of the elements in a sorted collection. 


3.4.15.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4080: The Comparable Interface, Part 2 
e File: Java4080.htm 

e Published: 04/19/13 

e Revised 12/09/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 
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Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.4.16 Java4080r: Review” 
3.4.16.1 Table of Contents 
Preface (p. 1198) 
Questions (p. 1198) 
1 (p. 1198) , 2 (p. 1198) , 3 (p. 1198) , 4 (p. 1199) , 5 (p. 1199) 


Listings (p. 1199) 

Answers (p. 1200) 

Complete program listings (p. 1202) 
Miscellaneous (p. 1205) 


3.4.16.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4080: The Comparable 
Interface, Part 2 244 . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.16.3 Questions 
3.4.16.3.1 Question 1 


True or False? The elements stored ina TreeSet collection must be references to objects instantiated from 
a class that implements the Comparable interface or makes use of an alternative approach involving the 
Comparator interface. 

Answer 1 (p. 1201) 


3.4.16.3.2 Question 2 


What output is produced by the program shown in Listing 1 (p. 1202) ? 


Compiler Error 
Runtime Error 
44321 

4321 

1234 

12344 

None of the above. 


Answer 2 (p. 1200) 


3.4.16.3.3 Question 3 


True or False? The program in Listing 1 (p. 1202) throws a runtime error because the class named MyClass 
fails to implement the CompareTo interface. 
Answer 3 (p. 1200) 


343This content is available online at <http://cnx.org/content /m48130/1.2/>. 
344 ttp://cnx.org/content /m46143/latest /?collection=col1 1441 /latest 
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3.4.16.3.4 Question 4 


What output is produced by the program shown in Listing 2 (p. 1204) ? 


Compiler Error 
Runtime Error 
44321 

4321 

1234 

12344 

None of the above. 


Answer 4 (p. 1200) 


3.4.16.3.5 Question 5 


True or False? A class that implements the Comparable interface must provide a concrete definition of 
the compareTo method. 
Answer 5 (p. 1200) 


3.4.16.4 Listings 


e Listing 1 (p. 1202) . Comparable04 java. 
e Listing 2 (p. 1204) . Comparable05.java. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None 


Display your name 
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This image was also inserted for the purpose of inserting space between the questions and the answers. 


Prob05a.jpq zj 3 |x] 


Put your name here 


3.4.16.5 Answers 
3.4.16.5.1 Answer 5 
True. 
Back to Question 5 (p. 1199) 
3.4.16.5.2 Answer 4 
1234 
Back to Question 4 (p. 1199) 
3.4.16.5.3 Answer 3 
False. The program in Listing 1 (p. 1202) throws a runtime error because the class named MyClass fails 
to implement the Comparable interface. 
Back to Question 3 (p. 1198) 
3.4.16.5.4 Answer 2 


Runtime Error 
Back to Question 2 (p. 1198) 
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3.4.16.5.5 Answer 1 


True. 
Back to Question 1 (p. 1198) 
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3.4.16.6 Complete program listings 


Listing 1 . Comparable04.java. 


//File Comparable04. java 
import java.util.*; 


public class Comparable04{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparable04 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new TreeSet(); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

while (iter.hasNext()){ 
System.out.print(iter.next()); 

}//end while loop 

System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(new MyClass(4)); 
ref.add(new MyClass(4)); 
ref.add(new MyClass(3)); 
ref.add(new MyClass(2)); 
ref.add(new MyClass(1)); 
}//end fillIt() 
}//end class Populator 


class MyClass{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String tatdtimbngib) free at Connexions <http://cnx.org/content /coll1441/1.181> 
return "" + data; 
}//end overridden toString () 


+//end MyClass 
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Table 3.478 
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Listing 2 . Comparable05.java. 


//File Comparable05. java 
import java.util.*; 


public class Comparable05{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparable05 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new TreeSet(); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

while (iter.hasNext()){ 
System.out.print(iter.next()); 

}//end while loop 

System. out.println(); 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(new MyClass(4)); 
ref.add(new MyClass(4)); 
ref.add(new MyClass(3)); 
ref.add(new MyClass(2)); 
ref.add(new MyClass(1)); 
}//end fillIt() 
}//end class Populator 


class MyClass implements Comparablef{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String toString(){ 
return "" + data; 
}//end overridden toString () 
public int compa ae Bs Eee at Cpnnexions <http://cnx.org/content /col11441/1.181> 
if(!(o instanceof MyClass) ) 
throw new ClassCastException() ; 
if(((MyClass)o).data < data) 
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Table 3.479 


3.4.16.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4080r: Review 
e File: Java4080r.htm 

e Published: 12/01/13 

e Revised 12/09/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4.17 Java4090: The Comparator Interface, Part 1°” 
3.4.17.1 Table of Contents 


e Preface (p. 1206) 
Viewing tip (p. 1206) 
x Listings (p. 1206) 


e Preview (p. 1207) 
e Discussion and sample code (p. 1207) 


Generics (p. 1207) 
The Comparable interface (p. 1207) 
The Comparator interface (p. 1207) 
Beginning with a quiz (p. 1207) 
Eligibility for inclusion in a TreeSet (p. 1210) 
x Using a Comparator object (p. 1210) 
Passing Comparator to TreeSet constructor (p. 1210) 
Passing the TreeSet to a Populator method (p. 1210) 
Similar to previous program (p. 1211) 


* 
* 
* 
x MyClass does not implement Comparable (p. 1211) 


345This content is available online at <http://cnx.org/content /m46189/1.2/>. 
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x Comparator eliminates requirement for Comparable (p. 1211) 
The class named TheComparator (p. 1212) 
x Implementing the Comparator interface (p. 1212) 
x Implementing the Serializable interface (p. 1212) 
x Methods of the Comparator interface (p. 1213) 
x The compare method (p. 1213) 
Specialization is required (p. 1213) 
Must gain access to instance variables (p. 1213) 
Specialized for type MyClass (p. 1213) 
General behavior of compare method (p. 1214) 
Implementation of required behavior (p. 1214) 
Other stipulations (p. 1214) 
The equals method (p. 1214) 
x Overridden equals method (p. 1215) 
The program output (p. 1215) 


* * * * 


* 


Run the program (p. 1216) 
Summary (p. 1216) 
What’s next? (p. 1216) 
Miscellaneous (p. 1216) 


3.4.17.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

This module discusses and illustrates the use of the Comparator interface. The sorting order estab- 
lished by a Comparator may be different or may be the same as the natural order. A Comparator 
can be used to establish a sorting order for objects that don’t have a natural ordering. The use of a 
Comparator is an alternative to the implementation of the Comparable interface. 

This module is also the first module in a series of modules on the Comparator interface. The purpose 
of the modules in this series is to teach you about the interactions between the Comparator interface 
and the Collections Framework , particularly with respect to the Set , SortedSet , and SortedMap 
interfaces of the Collections Framework. This module discusses Set and SortedSet . A discussion of 
SortedMap will be deferred to a future module. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 346 in 
Oracle’s Java Tutorials 34” . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.17.2.1 Viewing tip 
I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


3.4.17.2.1.1 Listings 


e Listing 1 (p. 1209) . The program named Comparator02. 

e Listing 2 (p ) . Passing Comparator to TreeSet constructor. 
e Listing 3 (p. 1211) . The fillIt method. 

e Listing 4 (p ) . The class named MyClass. 


346http:/ /docs.oracle.com/javase/tutorial/collections/index.html 
347http://docs.oracle.com/javase /tutorial/index.html 
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Listing 5 (p ) . Beginning of the class named TheComparator. 
Listing 6 (p. 1213) . Beginning of the compare method. 

Listing 7 (p. 1214) . Implementation of required behavior. 

Listing 8 (p. 1215) . The overridden equals method. 

Listing 9 (p. 1215) . Display the contents of the TreeSet object. 


3.4.17.3 Preview 


Previous modules have discussed the use of the Comparable interface. This module discusses and 
illustrates the use of the Comparator interface. 

The Comparable interface establishes natural ordering. The sorting order established by a 
Comparator may be different or may be the same as the natural order. 

A Comparator can be used to establish a sorting order for objects that don’t have a natural ordering 


The use of a Comparator is an alternative to the implementation of the Comparable interface. A 
TreeSet object instantiated with the benefit of a Comparator object doesn’t require the objects in its 
collection to implement Comparable 


3.4.17.4 Discussion and sample code 


3.4.17.4.1 Generics 


The code in this module is written with no thought given to Generics 348 . As a result, if you copy and 


compile this code, you will probably get a warning about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.17.4.2 The Comparable interface 


Previous modules have discussed the use of the Comparable interface to establish the natural ordering 
of elements in a sorted set. Although the name of the Comparable interface is similar to the name of the 
Comparator interface, they are different interfaces. Don’t be confused by the similarity of the names. 


3.4.17.4.3 The Comparator interface 


This module will begin the discussion of an alternative approach to sorting, using the Comparator interface 
to establish sorting order. The discussion will be continued in future modules. 

The sorting order established by a Comparator may be different from the natural ordering . The 
Comparator interface can also be used to establish sorting order for objects that do not implement the 
Comparable interface and therefore do not have a natural ordering . 


3.4.17.4.4 Beginning with a quiz 


Let’s begin with a little quiz to test your prior knowledge of the Collections Framework. 
What output is produced by the program shown in Listing 1 (p. 1209) ? 


e A. Compiler Error 
e B. Runtime Error 
e C. 44321 

e D. 4321 


348 http://docs.oracle.com/javase /tutorial/java/generics/index.html 
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e E. 1234 
e F. 12344 
e G. None of the above. 
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Listing 1 . The program named Comparator02. 


//File Comparator02.java 
//Copyright 2001, R.G.Baldwin 
import java.util.*; 
import java.io.Serializable; 


public class Comparator02{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparator02 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new TreeSet (new TheComparator()); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next()); 

}//end while loop 

System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(new MyClass(4)); 
ref.add(new MyClass(4)); 
ref.add(new MyClass(3)); 
ref.add(new MyClass(2)); 
ref.add(new MyClass(1)); 
}//end fillIt() 
}//end class Populator 


class MyClass{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String toString(){ 
return "" + data 
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Table 3.480 


If your answer was E. 1234 , then you are correct. 


3.4.17.4.5 Eligibility for inclusion in a TreeSet 


The TreeSet class implements the SortedSet interface. 

In an earlier module, I told you that in order to be eligible for inclusion in a TreeSet collection, an 
object must be instantiated from a class that implements the Comparable interface. 

At that time, I also told you that it is possible to instantiate anew TreeSet object using a constructor 
that receives an incoming reference to a Comparator object, in which case it is not necessary for the 
objects in the collection to implement the Comparable interface. 


3.4.17.4.5.1 Using a Comparator object 


The program in Listing 1 (p. 1209) takes this latter approach. The main purpose of this program is to 
illustrate the use of a Comparator object as an alternative to implementation of the Comparable 
interface. 


3.4.17.4.5.2 Passing Comparator to TreeSet constructor 


The code fragment in Listing 2 (p. 1210) shows the instantiation of a new TreeSet object, passing an 
anonymous object of type ,TheComparator as a parameter to the constructor for TreeSet . Shortly, 
we will see that the class named TheComparator implements the Comparator interface. Therefore, 
an object instantiated from that class is a Comparator object. 


Listing 2 . Passing Comparator to TreeSet constructor. 


Collection ref; 
ref = new TreeSet (new TheComparator()); 
Populator.fillIt (ref); 


Table 3.481 


3.4.17.4.5.3 Passing the TreeSet to a Populator method 


The code fragment in Listing 2 (p. 1210) also shows the reference to the TreeSet object being stored in 
a reference variable of the interface type Collection . The reference to the TreeSet object is passed as 
type Collection toa method named fillIt 

The purpose of the fillIt method is to instantiate some objects of type MyClass , and to store those 
object references in the TreeSet collection. 


3.4.17.4.5.4 The fillIt method 


The code fragment in Listing 3 (p. 1211) shows the entire method named fillIt . This method instantiates 
five objects from the class named MyClass and adds those object’s references to the TreeSet collection. 
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Listing 3 . The fillIt method. 


class Populator{ 

public static void fillIt(Collection ref){ 
ref.add(new MyClass(4)); 
ref.add(new MyClass(4)); 
ref.add(new MyClass(3)); 
ref.add(new MyClass(2)); 
ref.add(new MyClass(1)); 

}//end fillIt() 

}//end class Populator 


Table 3.482 


3.4.17.4.5.5 Similar to previous program 


This is essentially the same code that we saw in a sample program in a previous module. In that module, 
we saw that it was necessary for the class named MyClass to implement the Comparable interface. 
Otherwise, the add method would throw a runtime exception. 


3.4.17.4.5.6 MyClass does not implement Comparable 


In that program, however, the TreeSet object was instantiated without benefit of a Comparator object. 
As you can see in the code fragment in Listing 4 (p. 1212) , the class named MyClass in this program 
does not implement the Comparable interface. 


3.4.17.4.5.7 Comparator eliminates requirement for Comparable 


Furthermore, the add method in Listing 3 (p. 1211) does not throw a runtime exception. That is because 
the TreeSet object was instantiated with the benefit of a Comparator object. 

The use of a Comparator object in the instantiation of the TreeSet object eliminates the requirement 
for objects stored in the TreeSet collection to implement the Comparable interface. 
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Listing 4 . The class named MyClass. 


class MyClass{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass(int data){ 
this.data = data; 
}//end parameterized constructor 


public String toString(){ 
return "" + data; 
}//end overridden toString () 
}//end MyClass 


Table 3.483 


3.4.17.4.6 The class named TheComparator 


That brings us to the class named TheComparator from which the Comparator object was instantiated 
and passed to the constructor for the TreeSet object in Listing 2 (p. 1210) . The declaration for the class 
named TheComparator is shown in Listing 5 (p. 1212) . 


Listing 5 . Beginning of the class named TheComparator. 


class TheComparator 
implements Comparator, Serializablef{ 


Table 3.484 

As you can see, the class named —TheComparator implements both the Comparator interface and 
the Serializable interface. 
3.4.17.4.6.1 Implementing the Comparator interface 
By implementing the Comparator interface, an object instantiated from the class is eligible to be passed 
to the constructor for a TreeSet object, which requires an incoming parameter of type Comparator 
3.4.17.4.6.2 Implementing the Serializable interface 
Here is what Oracle has to say about implementing the Serializable interface: 


"Note: It is generally a good idea for comparators to implement java.io. Serializable, as they may 
be used as ordering methods in serializable data structures (like TreeSet, TreeMap). In order 
for the data structure to serialize successfully, the comparator (if provided) must implement 
Serializable." 
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Since the Serializable interface doesn’t declare any methods, implementing the interface simply requires 
a declaration that the interface is being implemented. 


3.4.17.4.6.3 Methods of the Comparator interface 
The Comparator interface declares the two methods listed below: 


e public int compare (Object 01, Object 02) 
e public boolean equals (Object obj) 


As is always the case when implementing interfaces, a class that implements the Comparator interface 
must provide concrete definitions for both of these methods. 


3.4.17.4.6.4 The compare method 


The beginning of the compare method is shown in Listing 6 (p. 1213) . 


Listing 6 . Beginning of the compare method. 


public int compare(Object 01,0bject o2){ 
if(!(o1 instanceof MyClass)) 
throw new ClassCastException() ; 
if(!(o2 instanceof MyClass)) 
throw new ClassCastException() ; 


Table 3.485 
The purpose of a Comparator is to compare the values stored in the instance variables of two objects 
and to return a value indicating which object is greater . 
3.4.17.4.7 Specialization is required 


Generally speaking, therefore, a Comparator object must be specialized to deal with a particular type of 
object. That type could be 


e A specific class from which the object is instantiated, 
e A specific interface implemented by the class from which the object is instantiated, or perhaps 
e A specific superclass of the class from which the object is instantiated. 


The code in Listing 6 (p. 1213) confirms that both of the objects to be compared are of the correct type, 
which in this case is type MyClass 
3.4.17.4.7.1 Must gain access to instance variables 


Regardless of how the type is established, the code in the compare method of the Comparator object 
must gain access to the instance variables of the two objects passed to the compare method as type 
Object . This normally requires that a downcast be performed on the incoming object references. 


3.4.17.4.7.2 Specialized for type MyClass 


This Comparator is specialized to compare two objects of the class named MyClass . The first two 
statements in Listing 6 (p. 1213) above confirm that both of the incoming objects are of type MyClass 
If either object is not of that type, an exception is thrown. 
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3.4.17.4.7.3 General behavior of compare method 


The general description of the behavior of the compare method as provided by Oracle is shown below: 


"Compares its two arguments for order. Returns a negative integer, zero, or a positive integer 
as the first argument is less than, equal to, or greater than the second." 


3.4.17.4.7.4 Implementation of required behavior 


This behavior is accomplished by the code shown in Listing 7 (p. 1214) . In this case, the comparison is 
based solely on the values of the instance variable named data in each of the two objects. 

Depending on which object contains the larger value in its instance variable, a value of 1 or -1 is returned. 
If the two values are equal, a value of 0 is returned. 


(Note that it is up to the author of the compare method to decide what constitutes larger. This 
gives the author of the method a great deal of control over the results of a sorting operation.) 


Listing 7 . Implementation of required behavior. 


if (((MyClass)o1).data < ((MyClass) 02) .data) 
return -1; 
if(((MyClass)o1).data > ((MyClass)02) .data) 
return 1; 
else return 0; 
}//end compare () 


Table 3.486 


3.4.17.4.7.5 Other stipulations 


The documentation for the compare method contains several other stipulations regarding the behavior of 
the method. While I believe that this version of the compare method meets all of those stipulations, I 
haven’t taken the time to test it fully. Therefore, it is possible that it may not meet all of the stipulations 
in terms of its behavior. 


3.4.17.4.8 The equals method 


Every new class inherits a default version of the equals method from the class named Object. Therefore, 
a new class that implements the Comparator interface already has such a method. The new class is free 
to override the inherited version, or to simply make use of the inherited version. Here is what Oracle has to 
say on the subject: 


"Note that it is always safe not to override Object.equals(Object). However, overriding this 
method may, in some cases, improve performance by allowing programs to determine that two 
distinct Comparators impose the same order." 
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3.4.17.4.8.1 Overridden equals method 


I decided, for purposes of illustration, to go ahead and override the equals method. However, my overridden 
version, as shown in Listing 8 (p. 1215) isn’t very significant. It simply confirms that an object being 
compared for equality to a Comparator object is instantiated from the same class. 

Since the Comparator object doesn’t contain any instance variables, there isn’t much more to be 
tested for equality. 


Listing 8 . The overridden equals method. 


public boolean equals(Object o){ 
if(!(o instanceof TheComparator)) 
return false; 
else return true; 
}//end overridden equals() 
}//end class TheComparator 


Table 3.487 


3.4.17.4.9 The program output 


Finally, the code shown in Listing 9 (p. 1215) uses an Iterator to display the contents of the populated 
TreeSet object. 


Listing 9 . Display the contents of the TreeSet object. 


iter = ref.iterator(); 
while(iter.hasNext())f{ 
System.out.print(iter.next()); 
}//end while loop 


Table 3.488 


The output produced by this code fragment is shown below. 
1234 
As you can see, the duplicate elements having the value 4 were eliminated as would be expected for a 
Set object. In addition, the Comparator was used to accomplish the following contract of a SortedSet 
object: 


"A set that further guarantees that its iterator will traverse the set in ascending element or- 
der, sorted according to the natural ordering of its elements (see Comparable ), or by a 
Comparator provided at sorted set creation time." 


In this case, the sorted order was controlled by the Comparator object, and not by the natural ordering 
of the elements. The natural ordering is controlled by implementation of the Comparable interface, 
and the elements in this collection did not implement the Comparable interface. Therefore, objects of 
the class named MyClass do not have a natural order in this program. 
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However, the code in this version of the Comparator produced an output order that matches the 
ascending natural order that one might expect for objects of type MyClass . Future modules will show 
you how to design the Comparator object to produce different output orders, such as descending order 
for example. 


3.4.17.5 Run the program 


I encourage you to copy the code Listing 2 (p. 1210) and paste it into your Java editor. Then compile and 
execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 


3.4.17.6 Summary 


This module has discussed and illustrated the use of the Comparator interface. 

The sorting order established by a Comparator may be different or may be the same as the natural 
ordering for a collection of objects 

A Comparator can be used to establish a sorting order for objects that don’t have a natural ordering 


The use of a Comparator is an alternative to the implementation of the Comparable interface. 
A TreeSet object instantiated with the benefit of a Comparator object doesn’t require the objects 
in its collection to implement Comparable 


3.4.17.7 What’s next? 


In the next module, I will illustrate the use of a Comparator to eliminate the effect of case when sorting 
String objects. 


3.4.17.8 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java4090: The Comparator Interface, Part 1 
e File: Java4090.htm 

e Published: 05/07/13 

e Revised 12/11/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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-end- 
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3.4.18 Java4090r: Review” 

3.4.18.1 Table of Contents 

Preface (p. 1218) 

Questions (p. 1218) 
1 (p. 1218) , 2 (p. 1218) , 3 (p. 1218) , 4 (p. 1218) , 5 (p. 1219) , 6 (p. 1219) , 7 (p. 1219) , 8 
(p. 1219) , 9 (p. 1219) , 10 (p. 1219) , 11 (p. 1220) 

Listings (p. 1220) 

Answers (p. 1221) 


Complete program listing (p. 1223) 
Miscellaneous (p. 1224) 


3.4.18.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4090: The Comparator 
Interface, Part 1 °° . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.18.3 Questions 

3.4.18.3.1 Question 1 

True or False? The sorting order established by a Comparator must be the same as the natural order. 
Answer 1 (p. 1222) 


3.4.18.3.2 Question 2 


True or False? A Comparator can be used to establish a sorting order for objects that don’t have a 
natural ordering. 
Answer 2 (p. 1222) 


3.4.18.3.3 Question 3 


True or False? The use of a Comparator is an alternative to the implementation of the Comparable 
interface. 
Answer 3 (p. 1222) 


3.4.18.3.4 Question 4 


True or False? Comparable and Comparator are two different names for the same interface. 
Answer 4 (p. 1222) 


349This content is available online at <http://cnx.org/content /m48132/1.2/>. 
35°http://cnx.org/content /m46189/latest /?collection=col11441 /latest 
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3.4.18.3.5 Question 5 


What output is produced by the program shown in Listing 1 (p. 1223) ? 


Compiler Error 
Runtime Error 
44321 

4321 

1234 

12344 


Answer 5 (p. 1222) 


3.4.18.3.6 Question 6 


True or False? It is possible to instantiate a new TreeSet object using a constructor that receives an 
incoming reference to a Comparable object, in which case it is not necessary for the objects in the 
collection to implement the Comparator interface. 

Answer 6 (p. 1222) 


3.4.18.3.7 Question 7 


True or False? In Listing 1 (p. 1223) , the constructor that is called to instantiate a new TreeSet object 
receives an incoming parameter of type Comparable . 
Answer 7 (p. 1222) 


3.4.18.3.8 Question 8 


True or False? When the fillIt method shown in Listing 1 (p. 1223) returns, the collection object referred 
to by ref will contain references to five objects of type MyClass with those objects encapsulating the 
values 4, 4, 3, 2, and 1. 

Answer 8 (p. 1221) 


3.4.18.3.9 Question 9 


True or False? When the fillIt method shown in Listing 1 (p. 1223) returns, the collection object referred 
to by ref will contain references to four objects of type MyClass with those objects encapsulating the 
values 1, 2, 3, and 4 sorted into the order shown. 

Answer 9 (p. 1221) 


3.4.18.3.10 Question 10 


True or False? Given: the Comparator interface declares the two methods listed below: 


e public int compare(Object 01, Object 02) 
e public boolean equals(Object obj) 


(Note that the Java documentation would replace the type Object with the generic type T. However, generics 
are beyond the scope of this course.) 

A class that implements the Comparator interface must provide a concrete definition for the compare 
method but providing a concrete definition for the equals method is optional. 

Answer 10 (p. 1221) 
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3.4.18.3.11 Question 11 


True or False? The general behavior of the compare method of a Comparator object c ompares its 
two arguments for order and returns a negative integer, zero, or a positive integer as the first argument is 
less than, equal to, or greater than the second. 

Answer 11 (p. 1221) 


3.4.18.4 Listings 


e Listing 1 (p. 1223) . Comparator02.java. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None 


Display your name 


ars 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


3.4.18.5 Answers 
3.4.18.5.1 Answer 11 
True. 
Back to Question 11 (p. 1220) 
3.4.18.5.2 Answer 10 


True. Every new class inherits a default version of the equals method from the class named Object. 
Therefore, a new class that implements the Comparator interface already has such a method. The new 
class is free to override the inherited version, or to simply make use of the inherited version. 

Back to Question 10 (p. 1219) 


3.4.18.5.3 Answer 9 
True. 
Back to Question 9 (p. 1219) 


3.4.18.5.4 Answer 8 


False. When the fillIt method shown in Listing 1 (p. 1223) returns, the collection object referred to by 
ref will contain references to four objects of type MyClass with those objects encapsulating the values 
4, 3, 2, and 1 with no duplicates. 

Back to Question 8 (p. 1219) 
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3.4.18.5.5 Answer 7 


False. In Listing 1 (p. 1223) , the constructor that is called to instantiate a new TreeSet object receives an 
incoming parameter of type Comparator . Once again, don’t confuse the two interfaces simply because 
they have similar names. 

Back to Question 7 (p. 1219) 


3.4.18.5.6 Answer 6 
False. It is possible to instantiate a new TreeSet object using a constructor that receives an incoming 
reference to a Comparator object, in which case it is not necessary for the objects in the collection to 
implement the Comparable interface. Don’t confuse the two interfaces. 
Back to Question 6 (p. 1219) 
3.4.18.5.7 Answer 5 
1234 
Back to Question 5 (p. 1219) 
3.4.18.5.8 Answer 4 


False. Although the name of the Comparable interface is similar to the name of the Comparator 
interface, they are different interfaces. Don’t be confused by the similarity of the names. 
Back to Question 4 (p. 1218) 
3.4.18.5.9 Answer 3 
True. 
Back to Question 3 (p. 1218) 
3.4.18.5.10 Answer 2 
True. 
Back to Question 2 (p. 1218) 
3.4.18.5.11 Answer 1 


False. The sorting order established by a Comparator may be different or may be the same as the natural 
order. 
Back to Question 1 (p. 1218) 
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3.4.18.6 Complete program listing 


Listing 1 . Comparator02.java. 


//File Comparator02.java 
//Copyright 2001, R.G.Baldwin 
import java.util.*; 
import java.io.Serializable; 


public class Comparator02{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparator02 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new TreeSet (new TheComparator()); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next()); 

}//end while loop 

System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref.add(new MyClass(4)); 
ref.add(new MyClass(4)); 
ref .add(new MyClass(3)); 
ref.add(new MyClass(2)); 
ref.add(new MyClass(1)); 
}//end fillIt() 
}//end class Populator 


class MyClass{ 
int data; 


MyClass (){ 
data = 0; 
}//end noarg constructor 


MyClass (int data){ 
this.data = data; 
}//end parameterized constructor 
Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
public String toString(){ 
return "" + data; 
}//end overridden toString () 


Table 3.489 


3.4.18.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4090r: Review 
e File: Java4090r.htm 

e Published: 12/01/13 

e Revised 12/11/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4.19 Java4100: The Comparator Interface, Part 2°” 


3.4.19.1 Table of Contents 


e Preface (p. 1225) 
Viewing tip (p. 1225) 
x Listings (p. 1225) 
e Preview (p. 1225) 
e Discussion and sample code (p. 1226) 
Generics (p. 1226) 
Beginning with a quiz (p. 1226) 
x The program output (p. 1228) 


x From the previous module (p. 1228) 
x Doing more with a Comparator (p. 1228) 
Two steps in the program (p. 1228) 
The first step (p. 1228) 
The second step (p. 1229) 
Duplicate names eliminated from the set (p. 1229) 
Does Joe equal JOE? (p. 1229) 


* * * * 


351This content is available online at <http://cnx.org/content/m46190/1.2/>. 
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Let’s see some code (p. 1229) 
x The Populator code (p. 1230) 
Populating the collection with String objects (p. 1231) 
Populating the TreeSet collection (p. 1232) 
Beginning of the Comparator class (p. 1232) 
The interesting code (p. 1233) 
Convert to upper-case (p. 1233) 
Making the comparison (p. 1233) 
Just what I was looking for (p. 1233) 
The results (p. 1234) 


Run the program (p. 1234) 
Summary (p. 1234) 
What’s next? (p. 1234) 
Miscellaneous (p. 1234) 


* * * * * * * ¥ 


3.4.19.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

This module shows you how to use a Comparator object to achieve natural (ascending) order on a 
set of names added as String objects toa TreeSet collection while ignoring the case used to write the 
names. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail *5? in 
Oracle’s Java Tutorials 353 . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.19.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


3.4.19.2.1.1 Listings 


Listing 1 (p. 1227) . The program named Comparator03 
Listing 2 1229) . Create, populate, and display a TreeSet collection. 
Listing 3 1231) . The class named Populator. 


Listing 5 . Populating the TreeSet collection. 
Listing 6 . Beginning of the Comparator class. 
Listing 7 . The interesting code in the compare method. 


) 
(p ) 
(p ) 
Listing 4 (p. 1231) . A TreeSet with a Comparator. 
(p ) 
(p ) 
(p ) 


3.4.19.3 Preview 


In this module, I will show you how to use a Comparator object to achieve a natural ordering of a set 
of names ( String objects) added toa TreeSet collection while ignoring the case used to write the 
names. (The natural ordering for String objects is ascending.) 


352http://docs.oracle.com/javase/tutorial/collections/index-html 
353http://docs.oracle.com/javase/tutorial/index.html 
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3.4.19.4 Discussion and sample code 
3.4.19.4.1 Generics 


The code in this module is written with no thought given to Generics 354 . As a result, if you copy and 
compile this code, you will probably get a warning about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.19.4.2 Beginning with a quiz 


Let’s begin with a quiz to test your prior knowledge of the Java Collections Framework. 
What output is produced by the program shown in Listing 1 (p. 1227) ? 


A. Compiler Error 

B. Runtime Error 

C. Joe Bill Tom JOE BILL TOM 
D. Tom TOM Joe JOE Bill BILL 
E. Joe Bill Tom 

F. None of the above. 


354h¢ttp://docs.oracle.com/javase/tutorial/java/generics/index.html 
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Listing 1 . The program named Comparator03. 


//File Comparator03.java 
//Copyright 2001 R.G.Baldwin 
import java.util.*; 
import java.io.Serializable; 


public class Comparator03{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparator03 


class Worker{ 

public void doIt(){ 
Iterator iter; 
Collection ref; 
System.out.println("Natural ordering"); 
ref = new TreeSet(); 
Populator.fillIt (ref); 
iter = ref.iterator(); 
while (iter.hasNext()){ 

System.out.print(iter.next() +" "); 

}//end while loop 
System. out.println() ; 


System.out.println("Comparator in use"); 

ref = new TreeSet (new TheComparator()); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 
}//end fillIt() 
}//end class Populator 


class TheComparator 
implements Comparator, Serializablef{ 
public int compa eee ft Gere ee ee /enxotg/content/coll 441/1181 
if(!(o1 instanceof String) ) 
throw new ClassCastException() ; 
if(!(o2 instanceof String) ) 
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Table 3.490 


If your answer was None of the above , you are correct. 


3.4.19.4.2.1 The program output 


The output produced by the program shown in Listing 1 (p. 1227) is four lines long as shown below. (Note 
that the bullets shown below do not appear in the actual program output.) 


Natural ordering 

BILL Bill JOE Joe TOM Tom 
Comparator in use 

Bill Joe Tom 


3.4.19.4.2.2 From the previous module 


In the previous module, I introduced you to the essentials of defining and using a Comparator for 
controlling the sort order of the elements contained in a TreeSet collection. 

In that module, I explained the difference between natural ordering and the sort ordering produced 
through the use of a Comparator object. 

However, what I showed you generally replicated the natural ordering , and therefore, wasn’t too 
exciting. 


3.4.19.4.2.3 Doing more with a Comparator 


In this and several subsequent modules, I am going to show you some of the things that you can do with a 
Comparator object. By using a Comparator object, you can achieve comparisons and sort orders that 
are different from the natural ordering for a given element type. 


3.4.19.4.3 Two steps in the program 


The program shown in Listing 1 (p. 1227) goes through two major steps. 


3.4.19.4.3.1 The first step 


First it populates a TreeSet collection with the names of six people without using a Comparator . Then 
it displays the contents of that collection using an iterator. That produces the following output (without 
the bullets) : 


e Natural ordering 


BILL Bill JOE Joe TOM Tom 


As you will see later, the names were added to the collection in a different order than the output order shown 
above. 

In this step, each of the six names that were added to the collection were displayed after they were 
arranged into their natural ordering . 

In case you are unfamiliar with this aspect of character encoding, upper-case characters appear before 
lower-case characters in the natural ordering of characters in the Unicode character set. Therefore, the 
names consisting of all upper-case characters appear in the output ahead of the same names consisting of a 
mixture of upper-case and lower-case characters. 
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3.4.19.4.3.2 The second step 


Then the program shown in Listing 1 (p. 1227) instantiates a new TreeSet object, providing a Com- 
parator for use in comparing and managing the sort order of the elements. 

The program populates the new TreeSet collection with the same set of six names in the same order as 
before. After the collection is populated, its contents are displayed producing the following output (without 
the bullets) : 


e Comparator in use 
e Bill Joe Tom 


3.4.19.4.3.3 Duplicate names eliminated from the set 


Three of the names appear in the output in the same order as the natural ordering shown earlier. However, 
the duplicate names are eliminated and only three names appear. 

This is because a Comparator was used by the TreeSet object to compare the elements as they were 
added. The Comparator was designed to eliminate the distinction between upper-case and lower-case 
characters. 


3.4.19.4.3.4 Does Joe equal JOE? 


For the earlier case that didn’t use a Comparator , the names Joe and JOE were considered to be 
different elements. Therefore, after population, both names appeared in the collection. 

When the Comparator was used to eliminate the distinction between upper-case and lower-case 
characters, the names Joe and JOE were considered to be duplicates. As a result, only the first of the 
two was allowed into the collection and the second of the two was rejected. 


3.4.19.4.4 Let’s see some code 
The code shown in Listing 2 (p. 1229) is the code that was used 
e To instantiate a TreeSet object without a Comparator , 


e To populate the collection, and 
e To display the contents of the collection after it was populated. 


Listing 2 . Create, populate, and display a TreeSet collection. 


ref = new TreeSet(); 
Populator.fillIt (ref); 


iter = ref.iterator(); 
while(iter.hasNext())f{ 

System.out.print(iter.next() +" "); 
}//end while loop 


Table 3.491 
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3.4.19.4.4.1 The Populator code 


The code in Listing 3 (p. 1231) was used to populate the collection in both cases, both with, and without a 
Comparator (to be discussed later). 
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Listing 3 . The class named Populator. 


class Populator{ 

public static void fillIt(Collection ref){ 
ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 

}//end fillIt() 

}//end class Populator 


Table 3.492 


3.4.19.4.4.2 Populating the collection with String objects 


Note that in Listing 3 (p. 1231) , unlike earlier modules, I did not use a class of my own design from which to 
instantiate the objects used to populate the collection. Rather, I used the String class from the standard 
library. 

The String class implements the Comparable interface. Therefore, objects instantiated from the 
String class have a natural ordering when placed in a collection. 

Because the compareTo method of the String class, (which implements the Comparable interface) 
considers upper-case and lower-case characters to be different, there were no duplicate elements added to 
the collection when only the compareTo method was used to compare elements. The six String objects 
were simply arranged so that the iterator would return references to those objects in sorted order. This 
produced the output shown below: 

BILL Bill JOE Joe TOM Tom 


3.4.19.4.4.3 A TreeSet with a Comparator 


The code shown in Listing 4 (p. 1231) was used to instantiate anew TreeSet object. A Comparator 
object’s reference was passed to the TreeSet constructor. The Comparator object (instead of the 
compareTo method) was subsequently used for comparing and controlling the sorting order of the elements 
in the TreeSet collection. 


Listing 4 . A TreeSet with a Comparator. 


ref = new TreeSet (new TheComparator()); 
Populator.fillIt (ref); 


iter = ref.iterator(); 

while (iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 
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Table 3.493 


The code in Listing 4 (p. 1231) was also used to populate the collection, and to display the contents of 
the collection after it was populated. 


3.4.19.4.4.4 Populating the TreeSet collection 


As before, the fillIt method shown in Listing 5 (p. 1232) was used to populate the collection. The same six 
names as before were added to the TreeSet collection. However, the result of adding those six names was 
determined by the behavior of the compare method in the Comparator object used by the TreeSet 
object for managing the collection. (Three of the names were rejected as duplicates.) 


Listing 5 . Populating the TreeSet collection. 


public static void fillIt(Collection ref){ 
ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 
}//end fillIt() 


Table 3.494 


3.4.19.4.4.5 Beginning of the Comparator class 


The code in Listing 6 (p. 1232) shows the beginning of the class from which the Comparator object was 
instantiated. Note that this class implements the Comparator interface, and therefore defines a concrete 
version of the method named compare 


Listing 6 . Beginning of the Comparator class. 


class TheComparator 
implements Comparator ,Serializablef{ 


public int compare(Object 01,0bject o2){ 
if(!(o1 instanceof String) ) 
throw new ClassCastException() ; 
if(!(o2 instanceof String) ) 
throw new ClassCastException() ; 


Table 3.495 


Listing 6 (p. 1232) doesn’t contain the interesting part of this class. The code in Listing 6 (p. 1232) 
simply throws an exception if the compare method receives any incoming parameters of types other than 
String 
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3.4.19.4.4.6 The interesting code 


The interesting code in the method named compare is shown in Listing 7 (p. 1233) . 


Listing 7 . The interesting code in the compare method. 


int result = 
((String)o1) .toUpperCase(). 
compareTo(((String) 02). 
toUpperCase()); 
return result; 
}//end compare () 


Table 3.496 


The code in Listing 7 (p. 1233) makes use of two methods of the String class to compare the two 
incoming objects. 


3.4.19.4.4.7 Convert to upper-case 


The method named toUpperCase is used to produce a version of each of the incoming strings that consists 
of upper-case characters only. In other words, lower-case characters in each of the two strings are replaced 
by the corresponding upper-case characters. This conversion occurs before the strings are compared. 

For example, the string Joe is converted to JOE inside the compare method, before the actual 
comparison is made. This results in the two strings containing Joe and JOE being considered to be 
duplicates. If one of them is already in the collection when an attempt is made to add the other, the second 
will be rejected as a duplicate. 


3.4.19.4.4.8 Making the comparison 


Then the compareTo method of the String class is used to make the actual comparison. (Note that 
this is the same method that is used to make the comparison in the absence of a Comparator object. 
However, in the case of the Comparator object, the case of the strings is modified before they are passed 
to the compareTo method.) 

This code calls the compareTo method on the upper-case version of the string represented by ol , 
passing the upper-case version of the string represented by o2 as a parameter. Here is part of what Oracle 
has to say about the behavior of the compareTo method. 


"Returns: the value 0 if the argument is a string lexicographically equal to this string; a value 
less than 0 if the argument is a string lexicographically greater than this string; and a value 
greater than 0 if the argument is a string lexicographically less than this string." 


3.4.19.4.4.9 Just what I was looking for 


That is exactly the behavior that I was looking for, so all that I needed to do after calling the compareTo 
method on the upper-case versions of the two strings was to return the value that was returned by the 
compareTo method. 

(Note, while writing this module and explaining the behavior of this program, I discovered that I could 
have used a method of the String class named compareToIgnoreCase to accomplish the same thing 
with a little less work.) 
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3.4.19.4.4.10 The results 


When the TreeSet object used the Comparator object to compare and arrange the elements in the 
collection, the three duplicate names were eliminated and the iterator delivered references to the remaining 
three names in the following order: 

Bill Joe Tom 


3.4.19.5 Run the program 


I encourage you to copy the code from Listing 1 (p. 1227) and paste it into your Java editor. Then compile 
and execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 


3.4.19.6 Summary 


In this module, I showed you how to use a Comparator object to achieve a natural ordering of a set 
of names ( String objects) added to a TreeSet collection while ignoring the case used to write the 
names. (Natural ordering for String objects is ascending.) 


3.4.19.7 What’s next? 


In the next module, I will show you how to usea Comparator to causea TreeSet collection containing 
references to String objects to be sorted in descending order while preserving differences in case. 


3.4.19.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4100: The Comparator Interface, Part 2 
e File: Java4100.htm 

e Published: 05/07/13 

e Revised 12/11/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.4.20 Java4100r: Review” 
3.4.20.1 Table of Contents 
e Preface (p. 1235) 
e Questions (p. 1235) 
1 (p. 1235) , 2 (p. 1235) , 3 (p. 1235) , 4 (p. 1236) , 5 (p. 1236) 


Listings (p. 1236) 

Answers (p. 1237) 

Complete program listing (p. 1239) 
Miscellaneous (p. 1240) 


3.4.20.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4100: The Comparator 
Interface, Part 2 3°° . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.20.3 Questions 
3.4.20.3.1 Question 1 


What output is produced by the program shown in Listing 1 (p. 1239) ? 


Compiler Error 

Runtime Error 

Joe Bill Tom JOE BILL TOM 
Tom TOM Joe JOE Bill BILL 
Joe Bill Tom 

None of the above. 


Answer 1 (p. 1238) 


3.4.20.3.2 Question 2 


True or False? By using a Comparator object, you can achieve comparisons and sort orders that are 
different from the natural ordering for a given element type. 
Answer 2 (p. 1238) 


3.4.20.3.3 Question 3 


True or False? The first time the fillIt method is called in Listing 1 (p. 1239) , the TreeSet collection 
referred to by the incoming parameter named ref is populated with the following names in the following 
order: 

Joe Bill Tom JOE BILL TOM 

Answer 3 (p. 1237) 


355This content is available online at <http://cnx.org/content /m48124/1.2/>. 
356http://cnx.org/content /m46190/latest /?collection=coll 1441 /latest 
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3.4.20.3.4 Question 4 


True or False? The second time the fillIt method is called in Listing 1 (p. 1239) , the TreeSet collection 
referred to by the incoming parameter named ref is populated with the following names in the following 
order: 

Bill Bill Joe Joe Tom Tom 

Answer 4 (p. 1237) 


3.4.20.3.5 Question 5 


Explain why the second time the fillIt method is called in Listing 1 (p. 1239) , the TreeSet collection 
referred to by the incoming parameter named ref is populated with the following names in the following 
order: 

Bill Joe Tom 

Answer 5 (p. 1237) 


3.4.20.4 Listings 
e Listing 1 (p. 1239) . Comparator03.java. 
What is the meaning of the following two images? 


These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Put your name here 


3.4.20.5 Answers 
3.4.20.5.1 Answer 5 


A Comparator object’s reference is passed to the TreeSet constructor when the second TreeSet 
object is instantiated. The Comparator is designed to eliminate the distinction between upper-case and 
lower-case characters when each new element is compared with the existing elements. This causes the last 
three names to be treated as duplicates of the first three names so they are not added to the collection. As 
a result, the collection ends up containing only the first three names that are added. 

Back to Question 5 (p. 1236) 


3.4.20.5.2 Answer 4 


False. The second time the fillIt method is called in Listing 1 (p. 1239) , the TreeSet collection referred 
to by the incoming parameter named ref is populated with the following names in the following order with 
duplicate elements eliminated: 

Bill Joe Tom 

Back to Question 4 (p. 1236) 


3.4.20.5.3 Answer 3 


False. The first time the fillIt method is called in Listing 1 (p. 1239) , the TreeSet collection referred 
to by the incoming parameter named ref is populated with the following names in the following natural 
order for String objects. The String class implements the Comparable interface, and that is what 
determines the sorted order in this case. 
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BILL Bill JOE Joe TOM Tom 
Back to Question 3 (p. 1235) 


3.4.20.5.4 Answer 2 


True. 
Back to Question 2 (p. 1235) 


3.4.20.5.5 Answer 1 


None of the above. 
The output produced by the program shown in Listing 1 (p. 1239) is four lines long as shown below. 
(Note that the bullets shown below do not appear in the actual program output.) 


Natural ordering 

BILL Bill JOE Joe TOM Tom 
Comparator in use 

Bill Joe Tom 


Back to Question 1 (p. 1235) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1234 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


3.4.20.6 Complete program listing 


Listing 1 . Comparator03.java. 


//File Comparator03.java 
//Copyright 2001 R.G.Baldwin 
import java.util.*; 
import java.io.Serializable; 


public class Comparator03{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparator03 


class Worker{ 

public void doIt(){ 
Iterator iter; 
Collection ref; 
System.out.println("Natural ordering"); 
ref = new TreeSet(); 
Populator.fillIt (ref); 
iter = ref.iterator(); 
while (iter.hasNext()){ 

System.out.print(iter.next() +" "); 

}//end while loop 
System. out.println() ; 


System.out.println("Comparator in use"); 

ref = new TreeSet (new TheComparator()); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println(); 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 
}//end fillIt() 
}//end class Populator 


class TheComparatafailable for free at Connexions <http://cnx.org/content /col11441/1.181> 
implements Comparator, Serializablef 


public int compare(Object 01,0bject o2){ 
if(!(o1 instanceof String) ) 


Table 3.497 


3.4.20.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4100r: Review 
e File: Java4100r.htm 

e Published: 12/01/13 

e Revised 12/11/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4.21 Java4110: The Comparator Interface, Part 3°” 


3.4.21.1 Table of Contents 


e Preface (p. 1241) 
Viewing tip (p. 1241) 
x Listings (p. 1241) 
e Preview (p. 1241) 
e Generics (p. 1241) 
e Discussion and sample code (p. 1242) 
Beginning with a quiz (p. 1242) 
* Similar to previous programs (p. 1244) 
x A new TreeSet object with a Comparator (p. 1244) 


x Populating the TreeSet collection (p. 1244) 
x Display the contents of the TreeSet collection (p. 1244) 


Analyzing the contents of the TreeSet collection (p. 1244) 


x Method used to populate the collection (p. 1245) 
x Implementing the Comparator interface (p. 1245) 
x The interesting code (p. 1246) 


357This content is available online at <http://cnx.org/content /m46191/1.2/>. 
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x Converting to reverse natural order (p. 1246) 


Run the program (p. 1246) 
Summary (p. 1246) 
What’s next? (p. 1246) 
Miscellaneous (p. 1247) 


3.4.21.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

The module shows you how to use a Comparator to cause a TreeSet collection to be sorted in 
descending order while preserving the impact of differences in case. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 358 in 
Oracle’s Java Tutorials 359 . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.21.2.1 Viewing tip 
I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


3.4.21.2.1.1 Listings 


Listing 1 (p. 1243) . The program named Comparator04. 


e 

e Listing 2 (p. 1244) . A new TreeSet object with a Comparator. 

e Listing 3 . The filllt method. 

e Listing 4 (p. 1245) . Beginning of the class named TheComparator. 
e 


—_—>~ > 
se) 
= 
N 
A 
Or 
NNN 


Listing 5 (p. 1246) . The most interesting code. 


3.4.21.3 Preview 


In this module, I will teach you how to use a Comparator to cause a TreeSet collection to be sorted 
in descending order while preserving the impact of differences in case. We might refer to this as reverse 
natural order. In other words, the sorting order is the same as the natural order except that the order is 
descending instead of ascending. 


3.4.21.4 Generics 


The code in this series of modules is written with no thought given to Generics 36° . As a result, if you copy 
and compile the code, you will probably get warnings about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


358http://docs.oracle.com/javase/tutorial/collections/index.html 
359http://docs.oracle.com/javase/tutorial/index.html 
360http://docs.oracle.com/javase/tutorial/java/generics/index.html 
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3.4.21.5 Discussion and sample code 
3.4.21.5.1 Beginning with a quiz 


Let’s begin with a quiz to test your prior knowledge of the Collections Framework. 
What output is produced by the program shown in Listing 1 (p. 1243) ? 


A. Compiler Error 

B. Runtime Error 

C. BILL Bill JOE Joe TOM Tom 
D. Tom TOM Joe JOE Bill BILL 
E. Joe Bill Tom 

F. None of the above. 
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Listing 1 . The program named Comparator04. 


//File Comparator04.java 
//Copyright 2001, R.G.Baldwin 


import java.util.*; 
import java.io.Serializable; 


public class Comparator04{ 
public static void main(String args[]){ 
new Worker().doItQ; 
}//end main() 
}//end class Comparator04 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new TreeSet (new TheComparator()); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 
}//end fillIt() 
}//end class Populator 


class TheComparator implements Comparator,Serializablef{ 


public int compare(Object 01,0bject o2){ 
if(!(o1 instanceof String) ) 
throw new ClassCastException() ; 
if(!(o2 instanceof String) ) 
throw new ClassCastException() ; 


int result = ((String)o1) .compareTo(((String) 02)) ; 
return result*(-1); 
}//end compare() . ; 
Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
public boolean equals(Object o){ 
if(!(o instanceof TheComparator)) 
return false; 
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Table 3.498 


If you selected the following, you are correct: 
D. Tom TOM Joe JOE Bill BILL 


3.4.21.5.1.1 Similar to previous programs 


The overall structure of this program is very similar to programs that I have discussed in previous modules. 
Therefore, I will concentrate on those aspects of this program that differentiate it from the programs in 
previous modules. 


3.4.21.5.1.2 A new TreeSet object with a Comparator 


The code in Listing 2 (p. 1244) instantiates a new TreeSet object, by providing a reference to an 
anonymous object that implements the Comparator interface. That object is instantiated from the class 
named TheComparator . It is the Comparator object that will be of most interest to us in this 
module. 


Listing 2 . A new TreeSet object with a Comparator. 


Collection ref; 


ref = new TreeSet (new TheComparator()); 
Populator.fillIt (ref); 


iter = ref.iterator(); 
while(iter.hasNext())f{ 

System.out.print(iter.next() +" "); 
}//end while loop 


Table 3.499 


3.4.21.5.1.3 Populating the TreeSet collection 


After the TreeSet object is instantiated, it is passed to a method named fillIt where the TreeSet 
collection is populated with the names of several people. 


3.4.21.5.1.4 Display the contents of the TreeSet collection 


As shown by the code in Listing 2 (p. 1244) , after the TreeSet collection is populated, an Iterator is 
obtained for that collection and used to display the contents of the collection. The output produced by the 
program is shown below 


Tom TOM Joe JOE Bill BILL 


3.4.21.5.2 Analyzing the contents of the TreeSet collection 


We will need to compare this output with the names used to populate the collection to appreciate the true 
significance of the use of the Comparator object. 

At this point, it is worth pointing out that the six names contained in the collection are returned by the 
iterator in descending order , taking the significance of upper and lower case into account. In other words, 
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names beginning with letters that are high in the alphabet occur before names beginning with letters that 
are lower in the alphabet. In addition, names containing lower case characters appear before the same names 
containing only upper case characters. 


3.4.21.5.2.1 Method used to populate the collection 


Listing 3 (p. 1245) shows the method named fillIt that was used to populate the collection with references 
to six String objects. As you can see, the names weren’t added in any particular order. 

As you can also see by comparing Listing 3 (p. 1245) with the output shown above (p. 1244) , all six 
names that were added to the collection were displayed in the output, but in a different order from the order 
in which they were added. (Names with the same spelling but different case were not considered to be 
duplicates insofar as the contract for the set was concerned.) 


Listing 3 . The fillIt method. 


public static void fillIt(Collection ref){ 
ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 
}//end fillIt() 


Table 3.500 


3.4.21.5.2.2 Implementing the Comparator interface 


That brings us to the class from which the Comparator object was instantiated. The beginning portion 
of that class is shown in Listing 4 (p. 1245) . 


Listing 4 . Beginning of the class named TheComparator. 


class TheComparator implements Comparator ,Serializablef{ 


public int compare(Object o1,0bject o2){ 
if(!(o1 instanceof String) ) 
throw new ClassCastException() ; 
if(!(o2 instanceof String) ) 
throw new ClassCastException() ; 


Table 3.501 


The code in Listing 4 (p. 1245) isn’t particularly interesting. That code simply throws an exception if 
either of the references passed to the compare method refer to an object of some type other than String 
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3.4.21.5.2.3 The interesting code 


The most interesting code is shown in Listing 5 (p. 1246) . The first statement in Listing 5 (p. 1246) uses 
the compareTo method of the String class to compare the two objects in an ascending natural 
ordering sense. The behavior of this method is more formally described as follows: 


"Returns: the value 0 if the argument is a string lexicographically equal to this string; a value 
less than 0 if the argument is a string lexicographically greater than this string; and a value 
greater than 0 if the argument is a string lexicographically less than this string." 


Listing 5 . The most interesting code. 


int result = ((String)o1).compareTo(((String) 02)) ; 


return result*(-1); 


Table 3.502 


3.4.21.5.2.4 Converting to reverse natural order 


The most interesting line of code in this entire program is the return statement shown in Listing 5 (p. 
1246) . This line of code changes the sign on the value returned by the compareTo method before 
returning it as the return value for the compare method. 

The effect of changing the sign is to return a value that causes the TreeSet collection to arrange the 
elements in reverse natural order instead of the normal ascending natural order. 

As a result, the use of an iterator to access and display the contents of the collection produces the 
following output: 

Tom TOM Joe JOE Bill BILL 

For comparison, if the names were arranged in ascending natural order, the output would be as 
shown below: 

BILL Bill JOE Joe TOM Tom 


3.4.21.6 Run the program 


I encourage you to copy the code from Listing 1 (p. 1243) and paste it into your Java text editor. Then 
compile and execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 


3.4.21.7 Summary 


In this module, I taught you how to use a Comparator to cause a TreeSet collection to be sorted in 
reverse natural order. In other words, the sorting order is the same as the natural order except that the 
order is descending instead of ascending. 


3.4.21.8 What’s next? 


In the next module, I will show you how to use a Comparator object to sort the contents of an array. 
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3.4.21.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name:Java4110: The Comparator Interface, Part 3 
e File: Java4110.htm 

e Published: 05/07/13 

e Revised 12/11/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.4.22 Java4110r: Review” 
3.4.22.1 Table of Contents 
e Preface (p. 1248) 
e Questions (p. 1248) 
1 (p. 1248) , 2 (p. 1248) , 3 (p. 1248) , 4 (p. 1249) , 5 (p. 1249) , 6 (p. 1249) 


Listings (p. 1249) 

Answers (p. 1250) 

Complete program listing (p. 1252) 
Miscellaneous (p. 1253) 


3.4.22.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4110: The Comparator 
Interface, Part 3 36? . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.22.3 Questions 
3.4.22.3.1 Question 1 


What output is produced by the program shown in Listing 1 (p. 1252) ? 


Compiler Error 

Runtime Error 

BILL Bill JOE Joe TOM Tom 
Tom TOM Joe JOE Bill BILL 
Joe Bill Tom 

None of the above. 


Answer 1 (p. 1251) 


3.4.22.3.2 Question 2 


True or False? The fillIt method in Listing 1 (p. 1252) populates the TreeSet object referred by the 
incoming parameter with the following names in the following order: 

Joe Bill Tom JOE BILL TOM 

Answer 2 (p. 1251) 


3.4.22.3.3 Question 3 


True or False? When the fillIt method in Listing 1 (p. 1252) returns, the TreeSet object is populated 
with six names in descending order taking case into account. 
Answer 3 (p. 1251) 


361 This content is available online at <http://cnx.org/content /m48138/1.2/>. 
362 http://cnx.org/content /m46191/latest /?collection=col11441/latest 
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3.4.22.3.4 Question 4 


True or False? In the output from Listing 1 (p. 1252) , descending order means that names beginning with 
letters that are low in the alphabet occur before names beginning with letters that are higher in the alphabet. 
In addition, names containing lower case characters appear before the same names containing only upper 
case characters. 

Answer 4 (p. 1250) 


3.4.22.3.5 Question 5 


True or False? In Listing 1 (p. 1252) , names with the same spelling but different case were considered to 
be duplicates and therefore were excluded from the collection 
Answer 5 (p. 1250) 


3.4.22.3.6 Question 6 


True or False? Given: Listing 1 (p. 1252) contains the following statement: 
return result*(-1); 
If you were to change the value in parentheses from -1 to -2, the program output would be: 
BILL Bill JOE Joe TOM Tom 
Answer 6 (p. 1250) 


3.4.22.4 Listings 


e Listing 1 (p. 1252) . Comparator04.java. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 
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This image was also inserted for the purpose of inserting space between the questions and the answers. 


Én Probū5a.jpg l (BI x! 


Put your name here 


3.4.22.5 Answers 
3.4.22.5.1 Answer 6 


False. If you were to change the value in parentheses from -1 to -2, the program output would still be: 
Tom TOM Joe JOE Bill BILL 
It is the sign of the result and not the value of the result that determines the sorting order of the output 
in Listing 1 (p. 1252) . You would need to multiply by a positive value to cause the output to be 
BILL Bill JOE Joe TOM Tom 
Back to Question 6 (p. 1249) 


3.4.22.5.2 Answer 5 


False. In Listing 1 (p. 1252) , names with the same spelling but different case were not considered to be 
duplicates insofar as the contract for the set was concerned. 
Back to Question 5 (p. 1249) 


3.4.22.5.3 Answer 4 


False. In the output from Listing 1 (p. 1252) , descending order means that names beginning with letters 
that are high in the alphabet occur before names beginning with letters that are lower in the alphabet. In 
addition, names containing lower case characters appear before the same names containing only upper case 
characters. 

Back to Question 4 (p. 1249) 
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3.4.22.5.4 Answer 3 
True. 

Back to Question 3 (p. 1248) 
3.4.22.5.5 Answer 2 


False. Even without the use of a Comparator object, the order would be incorrect. A TreeSet object 

requires its elements to be in either ascending natural order or in an order specified by a Comparator 

object. This program uses a Comparator object but it doesn’t result in the order shown in the question. 
Back to Question 2 (p. 1248) 


3.4.22.5.6 Answer 1 


Tom TOM Joe JOE Bill BILL 
Back to Question 1 (p. 1248) 
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Listing 1 . Comparator04.java. 


//File Comparator04.java 
//Copyright 2001, R.G.Baldwin 


import java.util.*; 
import java.io.Serializable; 


public class Comparator04{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparator04 


class Worker{ 
public void doItQ{ 
Iterator iter; 
Collection ref; 


ref = new TreeSet (new TheComparator()); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 
}//end fillIt() 
}//end class Populator 


class TheComparator implements Comparator,Serializablef{ 


public int compare(Object 01,0bject o2){ 
if(!(o1 instanceof String) ) 
throw new ClassCastException() ; 
if(!(o2 instanceof String) ) 
throw new ClassCastException() ; 


int result = A¢Sning) abd acauparedbads ChSipritegy.o29ontent /coll1441/1.181> 
return result*(-1); 
}//end compare () 


public boolean equals(Obiect o){ 
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Table 3.503 


3.4.22.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4110r: Review 
e File: Java4110r.htm 

e Published: 12/02/13 

e Revised 12/11/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 

I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 

In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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An opportune time (p. 1255) 
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x The output (p. 1260) 
The toArray method (p. 1260) 
x The contract (p. 1260) 
* Elements are returned in ascending index order (p. 1261) 
x A "safe" array (p. 1261) 
x Display the contents of the array (p. 1261) 
Sorting the array into natural order (p. 1261) 
x The Comparable interface and polymorphic behavior (p. 1262) 
x Display the sorted array data (p. 1262) 
x The natural order for String objects (p. 1263) 
Sort the array with a Comparator (p. 1263) 
x What does Oracle have to say about this? (p. 1263) 
The class named TheComparator (p. 1263) 
Display the array contents again (p. 1264) 
x Could have sorted differently (p. 1264) 
Display the collection data again (p. 1264) 
The bottom line (p. 1265) 


* * 


Run the program (p. 1265) 
Summary (p. 1265) 
What’s next? (p. 1265) 
Miscellaneous (p. 1265) 


3.4.23.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

This module shows you how to extract the contents of a collection into an array, and how to use a 
Comparator object to sort the contents of the array into reverse natural order. The module also shows 
you how to sort the contents of the array into natural order without the use of a Comparator object. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 364 in 
Oracle’s Java Tutorials 365 . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.23.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


3.4.23.2.1.1 Listings 


e Listing 1 (p. 1257) . The program named Comparator 05. 
e Listing 2 (p. 1258) . A new Vector object. 

e Listing 3 (p. 1259) . Call the filllt method. 

e Listing 4 (p. 1259) . The fillIt method. 

e Listing 5 (p. 1260) . Iteration on a Vector. 

e Listing 6 (p. 1260) . Call the toArray method. 

e Listing 7 (p. 1261) . Display the contents of the array. 

e Listing 8 (p. 1262) . Sorting the array into natural order. 


364h¢ttp://docs.oracle.com/javase/tutorial/collections/index-html 
365h¢ttp://docs.oracle.com/javase/tutorial/index.html 
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Listing 9 (p. 1262) . Display the sorted array data. 
Listing 10 (p. 1263) . Sort the array with a Comparator. 
Listing 11 (p. 1263) . The class named TheComparator. 
Listing 12 (p. 1264) . Display the contents again. 
Listing 13 (p. 1264) . Display the collection data again. 


Ja 
). 
le 
). 


3.4.23.3 Preview 


The primary purpose of recent modules in this series was to teach you about the interactions between the 
Comparator interface and the Collections Framework. 

This module departs somewhat from that primary purpose and teaches you how to use a Comparator 
object to sort the contents of an array containing references to objects. Technically speaking, an array is not 
part of the core Collections Framework. However, it is definitely a first cousin to the Framework. 


3.4.23.3.1 An array is a container 


As you should already know, an array is a container that can be used to store a collection of primitive values 
or a collection of references to objects. 

The Collection interface declares a method named toArray , which can be called on a Collection 
object to "return an array containing all of the elements in this collection whose runtime type is that of the 
specified array" . 


3.4.23.3.2 An opportune time 


Since you are studying this sub-series of modules to learn about the uses of the Comparator interface, 
this seems like an opportune time to teach you how to get an array from a collection, and how to use the 
Comparator interface to sort the contents of the array. (While I’m at it, I will also teach you how to sort 
the elements in an array of object references into natural order without the use of a Comparator object.) 


3.4.23.4 Generics 


The code in this series of modules is written with no thought given to Generics 366 . As a result, if you copy 
and compile the code, you will probably get warnings about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.23.5 Discussion and sample code 
3.4.23.5.1 Beginning with a quiz 


See if you can write down the output produced by the program shown in Listing 1 (p. 1257) . 


366http://docs.oracle.com/javase/tutorial/java/generics/index.html 
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Listing 1 . The program named Comparator 05. 


//File Comparator05.java 
//Copyright 2001, R.G.Baldwin 
import java.util.*; 
import java.io.Serializable; 


public class Comparator05{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparator05 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 
Object[] array; 


ref = new Vector(); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

System.out.println("Collection data"); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println(); 


array = ref.toArray(); 
System. out .println("Raw array data"); 
display (array); 


//Sort the array into natural order 

// and display it. 

Arrays.sort (array); 

System.out.println("Natural order sorted " + 
“array data"); 

display (array); 


//Sort the array into custom order 

// and display it. 

Arrays.sort(array, new TheComparator()); 

System.out.println("Custom order sorted " + 
“array data"); 

display (array); 


iter = ref.iterator(); 
System.out.println("Collection data"); 
while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 
}//end while loop 
System. out.println() ; , 
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Table 3.504 


If you wrote down the following for the program output, you already understand most of the material 
covered in this module and you can probably skip this module and move on to the next module. 


Collection data 

Joe Bill Tom JOE BILL TOM 

Raw array data 

Joe Bill Tom JOE BILL TOM 
Natural order sorted array data 
BILL Bill JOE Joe TOM Tom 
Custom order sorted array data 
Tom TOM Joe JOE Bill BILL 
Collection data 

Joe Bill Tom JOE BILL TOM 


If you didn’t write down the correct output for the program in Listing 1 (p. 1257) , you should probably 
continue with your study of this module. 
3.4.23.5.1.1 Similar to previous programs 


Although this program is somewhat more complex, the overall structure of this program is similar to programs 
that I have discussed in previous modules. Therefore, I will concentrate on those aspects of this program 
that differentiate it from the programs in previous modules. 


3.4.23.5.1.2 A new Vector object 


The code in Listing 2 (p. 1258) instantiates a new object of the Vector class and stores a reference to 
that object in the variable named ref 


Listing 2 . A new Vector object. 


ref = new Vector(); 


Table 3.505 


The Vector class was part of Java long before the Collections Framework was released. However, with 
the release of the Collections Framework, the Vector class was upgraded to implement the Collection 
interface and the List interface. 


3.4.23.5.1.3 A Vector is a List 


Therefore, a Vector isa List , and adheres to the various contracts of the List interface. For example, 
since it is not a Set , it doesn’t prohibit duplicate elements. Because it is a List , it is an ordered 
collection. The position of each element in the collection is determined by a numeric index associated with 
the element and is independent of the value of the element. 
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3.4.23.5.1.4 The fillIt method 


As has been the case in several of the programs in previous modules, the code in Listing 3 (p. 1259) passes 
the Vector object’s reference to a method named fillIt where the Vector is populated with the names 
of several people. 


Listing 3 . Call the fillIt method. 


Populator.fillIt (ref); 


Table 3.506 


The code for the fillIt method is shown in Listing 4 (p. 1259) . As you can see, the names were added 
to the collection in no particular order relative to their values. (The add method for the Vector class simply 
adds each new element to the end of the list.) 


Listing 4 . The fillIt method. 


class Populator{ 

public static void fillIt( 

Collection ref){ 

ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 

}//end fillIt() 

}//end class Populator 


Table 3.507 


3.4.23.5.1.5 Iteration on a Vector 


When an iterator is used to traverse the elements ina Vector collection, the elements are delivered by the 
iterator in ascending index order, beginning with the element stored at index 0. 

The code in Listing 5 (p. 1260) gets and uses an iterator to display the contents of the populated 
collection. 


| Listing 5 . Iteration on a Vector. | 


| continued on next page | 
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iter = ref.iterator(); 
System.out.println("Collection data"); 
while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 
}//end while loop 


Table 3.508 


3.4.23.5.1.6 The output 


The code in Listing 5 (p. 1260) produces the following output: 


Collection data 
Joe Bill Tom JOE BILL TOM 


As you can see, this is the same order in which the names were added to the collection by the fillIt method 
in Listing 4 (p. 1259) . 
3.4.23.5.2 The toArray method 


The code in Listing 6 (p. 1260) is new to this module. This code calls the toArray method onthe Vector 
object to extract the contents of the collection and store the elements in an array object of type Object 


Listing 6 . Call the toArray method. 


array = ref.toArray(); 


Table 3.509 


(Recall that the variable named array was declared as a reference to an array object of type 
Object in Listing 1 (p. 1257) .) 


3.4.23.5.2.1 The contract 
According to the documentation for the Vector class, this version of the toArray method: 
"Returns an array containing all of the elements in this Vector in the correct order." 


The documentation for the toArray method of the Collection interface is a little more verbose, reading 
partially as follows: 


"Returns an array containing all of the elements in this collection. If the collection makes any 
guarantees as to what order its elements are returned by its iterator, this method must return 
the elements in the same order. 
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3.4.23.5.2.2 Elements are returned in ascending index order 


By default, the iterator for a Vector returns its elements in ascending index order. Therefore, the toArray 
method for a Vector object must return the elements in the same order. 


3.4.23.5.2.3 A "safe" array 


Also, according to Oracle: 


"The returned array will be "safe" in that no references to it are maintained by this collection. 
... The caller is thus free to modify the returned array." 


In the code in Listing 6 (p. 1260) above, the returned reference to an array object is assigned to a reference 
variable that previously contained null. Following the execution of the toArray method, that reference 
variable refers to an array object of type Object containing the same elements as the Vector collection, 
in ascending index order. 


(Regarding the concept of a "safe" array, it is easy to demonstrate that the elements in the array 
refer to the same objects referred to by the elements in the Vector. Thus, using the references 
stored in the array to modify the objects to which they refer also modifies the objects referred 
to by the elements stored in the Vector. In other words, the elements in the array are copies of 
the elements in the Vector. The elements in the array refer to the original objects, and do no 
refer to copies of those objects. As usual when dealing with multiple references to objects, care 
should be taken to avoid inadvertently corrupting those objects. ) 


3.4.23.5.2.4 Display the contents of the array 


The code in Listing 7 (p. 1261) passes the array object’s reference to a method named display that 
displays the contents of the array in ascending index order. 


Listing 7 . Display the contents of the array. 


System.out.println("Raw array data"); 
display (array); 


Table 3.510 


The output produced by the code in Listing 7 (p. 1261) is as shown below: 


Raw array data 
Joe Bill Tom JOE BILL TOM 


As you can see, this is the same data, in the same order, as the contents of the collection displayed earlier. 


(The method named display is a simple utility method that I won’t discuss here because of 
its simplicity. You can view the display method in its entirety in Listing 1 (p. 1257) .) 


3.4.23.5.3 Sorting the array into natural order 


The code in Listing 8 (p. 1262) is also new to this module. This code uses one of the overloaded sort 
methods of the Arrays class to sort the contents of the array into natural order . 
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Listing 8 . Sorting the array into natural order. 


Arrays.sort (array) ; 


Table 3.511 
Here is part of what Oracle has to say about the Arrays class: 
"This class contains various methods for manipulating arrays (such as sorting and searching)." 


The class contains many overloaded versions of the sort method. Here is part of what Oracle has to say 
about the version of the sort method used in Listing 8 (p. 1262) above: 


"Sorts the specified array of objects into ascending order, according to the natural ordering of 
its elements. All elements in the array must implement the Comparable interface." 


3.4.23.5.3.1 The Comparable interface and polymorphic behavior 


Although the declared type of the array is Object , the array actually contains references to String 
objects. 

The String class implements the Comparable interface. It is not necessary to cast the array to type 
String before passing it tothe Sort method. (The Sort method declares the incoming parameter as 
type Object .) 

The sort method treats the array elements as type Comparable and uses the compareTo method 
declared in that interface to perform any necessary comparisons required to carry out the sorting operation. 

This is another example of the usefulness of polymorphism as implemented through the use of the Java 
interface. (The Comparable interface and the compareTo method declared in that interface were 
discussed in detail in an earlier module.) 


3.4.23.5.3.2 Display the sorted array data 


The code in Listing 9 (p. 1262) displays the contents of the array after those contents are sorted into natural 
order by the sort method in Listing 8 (p. 1262) above. 


Listing 9 . Display the sorted array data. 


System.out.println("Natural order sorted " + 
“array data"); 
display (array); 


Table 3.512 


The output produced by Listing 9 (p. 1262) above is: 


Natural order sorted array data 
BILL Bill JOE Joe TOM Tom 
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3.4.23.5.3.3 The natural order for String objects 


I discussed the concept of natural ordering in a previous module with particular emphasis of the natural 
order for strings. You will recognize that the strings shown in the above output have been sorted into 
natural order according to the definition of the compareTo method of the String class. 


3.4.23.5.4 Sort the array with a Comparator 


The code in Listing 10 (p. 1263) is also new to this module. This code uses a different version of the 
overloaded sort method of the Arrays class to sort the array using the rules defined in the compare 
method of a Comparator object (passed as a parameter to the sort method). 


Listing 10 . Sort the array with a Comparator. 


Arrays.sort(array, new TheComparator()); 


Table 3.513 


3.4.23.5.4.1 What does Oracle have to say about this? 


Here is part of what Oracle has to say about this version of the sort method of the Arrays class: 


"Sorts the specified array of objects according to the order induced by the specified comparator. 
All elements in the array must be mutually comparable by the specified comparator (that is, 
c.compare(el, e2) must not throw a ClassCastException for any elements e1 and e2 in the array)." 


3.4.23.5.4.2 The class named TheComparator 


Listing 11 (p. 1263) shows the class from which the Comparator object was instantiated. 
This is essentially the same class that was used to instantiate a Comparator object in an earlier 
module. I discussed the compare method in detail in that module and won’t repeat that discussion here. 


Listing 11 . The class named TheComparator. 


class TheComparator implements Comparator ,Serializablef{ 


public int compare(Object 01,0bject o2){ 
if(!(o1 instanceof String) ) 
throw new ClassCastException() ; 
if(!(o2 instanceof String) ) 
throw new ClassCastException() ; 


int result = ((String)o1).compareTo(((String) 02)) ; 
return result*(-1); 
}//end compare () 
}//end class TheComparator 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1259 


Table 3.514 


Suffice it to say at this point that this Comparator object causes the elements in the array to be 
sorted into reverse natural order . That term was also explained in the previous module, so I won’t discuss 
it further here. 


3.4.23.5.4.3 Display the array contents again 
The code in Listing 12 (p. 1264) was used to display the newly-sorted contents of the array. 


Listing 12 . Display the contents again. 


System.out.println("Custom order sorted " + 
“array data"); 


display (array) ; 


Table 3.515 


The output produced by this code is: 


Custom order sorted array data 
Tom TOM Joe JOE Bill BILL 


You will recognize this as reverse natural order for the elements contained in the array. 


3.4.23.5.4.4 Could have sorted differently 


It is important to note that I could have caused the sorting order to be different from reverse natural order 
simply by defining the rules used for comparison in the compare method shown in Listing 11 (p. 1263) 
above. This makes it possible for you to sort array data into any order that you choose as long as you can 
write the sorting rules into the compare method of a class that implements the Comparator interface. 


3.4.23.5.5 Display the collection data again 


Finally, in order to show that none of this has disturbed the contents of the original collection, the code in 
Listing 13 (p. 1264) gets and uses an iterator to display the contents of the Vector collection. 


Listing 13 . Display the collection data again. 


iter = ref.iterator(); 
System.out.println("Collection data"); 
while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 
}//end while loop 
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Table 3.516 


The output produced by the code in Listing 13 (p. 1264) is: 


Collection data 
Joe Bill Tom JOE BILL TOM 


If you compare this with the output produced by the code at the beginning of the program, you will see 
that the iterator still returns the elements in the Vector in the same order that they were added. Thus, 
modifications to the array did not disturb the contents of the Vector collection. 


3.4.23.5.6 The bottom line 


The toArray method of the Collection interface makes it possible to extract a copy of the elements in a 
collection into an array and to manipulate those elements in whatever way you wish. As mentioned earlier, 
however, care should be exercised to make certain that the copies of the references to the original objects 
are not used to corrupt the objects. 

The various versions of the sort method inthe Arrays class make it possible to sort the contents of 
arrays in a variety of different ways. 


3.4.23.6 Run the program 


I encourage you to copy the code from Listing 1 (p. 1257) . Paste the code into your Java editor. Then 
compile and execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 


3.4.23.7 Summary 


In this module, I taught you how to extract the contents of a collection into an array and how to use a 
Comparator to sort the contents of the array into reverse natural order . 

Although I elected to use reverse natural order for purposes of illustration, I could have sorted the 
array into some other order simply by defining the comparison rules in the compare method of the 
Comparator class differently. 

In order to further expand your knowledge of array sorting, I also sorted the array into natural order 
without the use of a Comparator 

Sorting the contents of the array did not disturb the contents of the Vector collection from which the 
contents of the array were derived. 


3.4.23.8 What’s next? 


In the next module, I will show you how to use the sort method of the Collections class along with a 
Comparator object to sort the contents of a List 


3.4.23.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4120: The Comparator Interface, Part 4 
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e File: Java4120.htm 
e Published: 05/07/13 
e Revised 12/11/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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1 (p. 1267) , 2 (p. 1267) , 3 (p. 1267) , 4 (p. 1267) , 5 (p. 1268) , 6 (p. 1268) , 7 (p. 1268) , 8 
(p. 1268) , 9 (p. 1268) , 10 (p. 1268) , 11 (p. 1268) , 12 (p. 1268) , 13 (p. 1268) , 14 (p. 1269) , 
15 (p. 1269) , 16 (p. 1269) 

Listings (p. 1269) 

Answers (p. 1271) 

Complete program listing (p. 1272) 

Miscellaneous (p. 1274) 


3.4.24.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4120: The Comparator 
Interface, Part 4 3° . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.24.3 Questions 
3.4.24.3.1 Question 1 


True or False? The Collection interface declares a method named convertToArray , which can be 
called on a Collection object to "return an array containing all of the elements in this collection whose 
runtime type is that of the specified array" . 

Answer 1 (p. 1272) 


3.4.24.3.2 Question 2 


True or False? A Comparator object can be used to sort the contents of an array containing references 
to objects. 
Answer 2 (p. 1272) 


3.4.24.3.3 Question 3 


True or False? An array is a container that can be used to store a collection of primitive values or a collection 
of references to objects. 
Answer 3 (p. 1272) 


3.4.24.3.4 Question 4 


Write down the output produced by the program shown in Listing 1 (p. 1273) . Hint: There are ten lines of 
output. 
Answer 4 (p. 1272) 


367This content is available online at <http://cnx.org/content /m48137/1.2/>. 
36Shttp://cnx.org/content /m46192/latest /?collection=col1 1441 /latest 
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3.4.24.3.5 Question 5 

True or False? A Vector object isa Set object. 
Answer 5 (p. 1272) 

3.4.24.3.6 Question 6 

True or False? Because a Vector object isa List object, it is not allowed to contain duplicate elements. 
Answer 6 (p. 1272) 

3.4.24.3.7 Question 7 

True or False? Because a Vector isa List , it is an ordered collection. 
Answer 7 (p. 1272) 

3.4.24.3.8 Question 8 


True or False? The position of each element in an ordered collection is determined by i (p. 1271) ts value 
relative to the values of its neighbors. 
Answer 8 (p. 1271) 


3.4.24.3.9 Question 9 


True or False? The add method for the Vector class simply adds each new element to the end of the 
list. 
Answer 9 (p. 1271) 


3.4.24.3.10 Question 10 


True or False? When an iterator is used to traverse the elements in a Vector collection, the elements are 
delivered by the iterator in ascending index order, beginning with the element stored at index 0. 
Answer 10 (p. 1271) 


3.4.24.3.11 Question 11 


True or False? The first time the iterator is applied to the Vector object in Listing 1 (p. 1273) , the 
output is in ascending natural order as shown below: 

BILL Bill JOE Joe TOM Tom 

Answer 11 (p. 1271) 


3.4.24.3.12 Question 12 


True or False? The toArray method can be called on a Vector object to return a reference to an array 
object containing all of the elements in the Vector in ascending index order. 
Answer 12 (p. 1271) 


3.4.24.3.13 Question 13 


True or False? The documentation for the toArray method of the Collection interface reads partially 
as follows: 


"Returns an array containing all of the elements in this collection. If the collection makes any 
guarantees as to what order its elements are returned by its iterator, this method must return 
the elements in the same order. 


Answer 13 (p. 1271) 
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3.4.24.3.14 Question 14 


True or False? There is a class named Arrays that contains various methods for manipulating arrays 
(such as sorting and searching) . The Arrays class contains many overloaded versions of the sort 
method. As usual, each overloaded version of the sort method requires a different argument list. 
Answer 14 (p. 1271) 


3.4.24.3.15 Question 15 


Given: Listing 1 (p. 1273) makes two calls to overloaded sort methods of the Arrays class using the 
following overloaded methods. (Note that I omitted generics syntax from the signatures because generics 
is beyond the scope of this course .) 


e sort(Object|| a) 
e sort(Object[] a, Comparator c) 


True or False? In Listing 1 (p. 1273) , the call to the first sort method in the above list (p. 1269) produces 
the following output: 

Tom TOM Joe JOE Bill BILL 

Answer 15 (p. 1271) 


3.4.24.3.16 Question 16 


True or False? In Listing 1 (p. 1273) , the call to the second sort method in the above list (p. 1269) produces 
the following output: 

Tom TOM Joe JOE Bill BILL 

Answer 16 (p. 1271) 


3.4.24.4 Listings 
e Listing 1 (p. 1273) . Comparator05.java. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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3.4.24.5 Answers 
3.4.24.5.1 Answer 16 
True. 
Back to Question 16 (p. 1269) 
3.4.24.5.2 Answer 15 


False. Here is what the documentation has to say about this overloaded version of the Arrays.sort method: 
Sorts the specified array of objects into ascending order, according to the natural ordering of its elements. 
All elements in the array must implement the Comparable interface. 
According to that specification, the output would be: 
BILL Bill JOE Joe TOM Tom 
Back to Question 15 (p. 1269) 


3.4.24.5.3 Answer 14 
True. 
Back to Question 14 (p. 1269) 
3.4.24.5.4 Answer 13 
True. 
Back to Question 13 (p. 1268) 
3.4.24.5.5 Answer 12 
True. 
Back to Question 12 (p. 1268) 
3.4.24.5.6 Answer 11 
False. By default, a Vector object does not sort the elements. Therefore, the output order is the same as 
the input order shown in the fillIt method. 
Joe Bill Tom JOE BILL TOM 
Back to Question 11 (p. 1268) 
3.4.24.5.7 Answer 10 
True. 
Back to Question 10 (p. 1268) 
3.4.24.5.8 Answer 9 
True. 
Back to Question 9 (p. 1268) 
3.4.24.5.9 Answer 8 


False. The position of each element in an ordered collection is determined by a numeric index associated 
with the element and is independent of the value of the element. 
Back to Question 8 (p. 1268) 
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3.4.24.5.10 Answer 7 


True. 
Back to Question 7 (p. 1268) 


3.4.24.5.11 Answer 6 


False. Because a Vector object isa List object, (and not a Set object) it is allowed to contain 


duplicate elements. 
Back to Question 6 (p. 1268) 


3.4.24.5.12 Answer 5 


False. A Vector object isa List object. The Vector class implements the Collection interface and 
the List interface but not the Set interface. 
Back to Question 5 (p. 1268) 


3.4.24.5.13 Answer 4 


Collection data 
Joe Bill Tom JOE BILL TOM 
Raw array data 
Joe Bill Tom JOE BILL TOM 
Natural order sorted array data 
BILL Bill JOE Joe TOM Tom 
Custom order sorted array data 
Tom TOM Joe JOE Bill BILL 
Collection data 
Joe Bill Tom JOE BILL TOM 
Back to Question 4 (p. 1267) 


3.4.24.5.14 Answer 3 
True. 

Back to Question 3 (p. 1267) 
3.4.24.5.15 Answer 2 
True. 

Back to Question 2 (p. 1267) 
3.4.24.5.16 Answer 1 


False. The Collection interface declares a method named toArray_ , which can be called ona Collection 
object to "return an array containing all of the elements in this collection whose runtime type is that of the 
specified array" . 

Back to Question 1 (p. 1267) 


3.4.24.6 Complete program listing 
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Listing 1 . Comparator05.java. 


//File Comparator05.java 
//Copyright 2001, R.G.Baldwin 
import java.util.*; 
import java.io.Serializable; 


public class Comparator05{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparator05 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 
Object[] array; 


ref = new Vector(); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

System.out.println("Collection data"); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println(); 


array = ref.toArray(); 
System. out .println("Raw array data"); 
display (array); 


//Sort the array into natural order 

// and display it. 

Arrays.sort (array); 

System.out.println("Natural order sorted " + 
“array data"); 

display (array); 


//Sort the array into custom order 

// and display it. 

Arrays.sort(array, new TheComparator()); 

System.out.println("Custom order sorted " + 
“array data"); 

display (array); 


iter = ref.iterator(); 

System.out.println("Collection data"); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println() ; 
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}//end dolt() 


static void display(Object[] array){ 


Table 3.517 


3.4.24.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4120r: Review 
e File: Java4120r.htm 

e Published: 12/03/13 

e Revised 12/11/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4.25 Java4130: The Comparator Interface, Part 5°” 


3.4.25.1 Table of Contents 


e Preface (p. 1275) 
Viewing tip (p. 1275) 
x Listings (p. 1275) 


e Preview (p. 1275) 
e Generics (p. 1275) 
e Discussion and sample code (p. 1276) 


Beginning with a quiz (p. 1276) 


* 


Similar to previous programs (p. 1278) 
A new LinkedList object (p. 1278) 
Populating the List (p. 1278) 
Displaying the list (p. 1279) 
Sort the list (p. 1279) 
A very important point (p. 1279) 
The Collections class (p. 1280) 

x The sort method (p. 1280) 


* 
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x Also uses an array (p. 1280) 

«x A flexible approach to sorting (p. 1280) 
The Comparator (p. 1280) 
Display the sorted list (p. 1281) 


Run the program (p. 1281) 
Summary (p. 1282) 
What’s next? (p. 1282) 
Miscellaneous (p. 1282) 


3.4.25.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

This module shows you how to use the sort method of the Collections class along with a Com- 
parator object to sort the contents of a List into reverse natural order. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 37° in 
Oracle’s Java Tutorials 3"! . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.25.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


3.4.25.2.1.1 Listings 


e Listing 1 (p. 1277) . The program named Comparator06. 
e Listing 2 (p. 1278) . A new LinkedList object. 

e Listing 3 (p. 1279) . The fillIt method. 

e Listing 4 (p. 1279) . Sort the list. 

e Listing 5 (p. 1281) . The Comparator. 

e Listing 6 (p. 1281) . Display the sorted list. 


3.4.25.3 Preview 


In this module, I will teach you how to use the sort method of the Collections class along with a 
Comparator object to sort the contents of a List into reverse natural order . 
The methodology that I will teach you is completely general, and can be used to sort a list in a wide 
variety of ways, depending on how you define the compare method of a Comparator object. 
Furthermore, the same sort method and the same Comparator object can be used to sort any 
implementation of a list, so long as the list properly implements the List interface. 


3.4.25.4 Generics 


The code in this series of modules is written with no thought given to Generics 37? . As a result, if you copy 
and compile the code, you will probably get warnings about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


370 http://docs.oracle.com/javase/tutorial/collections/index.html 
371 http://docs.oracle.com/javase/tutorial/index.html 
3”2http://docs.oracle.com/javase /tutorial/java/generics/index.html 
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3.4.25.5 Discussion and sample code 
3.4.25.5.1 Beginning with a quiz 


Let’s begin with a quiz to test your prior knowledge of the Collections Framework. 
What output is produced by the program shown in Listing 1 (p. 1277) ? 


A. Compiler Error 

B. Runtime Error 

C. BILL Bill JOE Joe TOM Tom 
D. Tom TOM Joe JOE Bill BILL 
E. Joe Bill Tom 

F. None of the above. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1272 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Listing 1 . The program named Comparator06. 


//File Comparator06.java 
//Copyright 2001, R.G.Baldwin 
import java.util.*; 
import java.io.Serializable; 


public class Comparator06{ 
public static void main(String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Comparator06 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new LinkedList(); 

Populator.fillIt (ref); 

Collections.sort((List)ref, new TheComparator()); 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 
}//end fillIt() 
}//end class Populator 


class TheComparator implements Comparator,Serializablef{ 


public int compare(Object 01,0bject o2){ 
if(!(o1 instanceof String) ) 
throw new ClassCastException() ; 
if(!(o2 instanceof String) ) 
throw new ClassCastException() ; 


//Do a comparison 
int result = ((String)o1) .compareTo(((String) 02)) ; 
return results (-1); : 
}//end compare (uae e for free at Connexions <http://cnx.org/content /col11441/1.181> 


}//end class TheComparator 
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Table 3.518 


The output produced by this program is shown below: 

Tom TOM Joe JOE Bill BILL 

If that was your answer, you probably already understand most of the material covered in this module. 
In that case, you might consider skipping this module and moving on to the next module. If that wasn’t 
your answer, you should probably continue with your study of this module. 


3.4.25.5.1.1 Similar to previous programs 


The overall structure of the program in Listing 1 (p. 1277) is similar to programs that I have discussed in 
previous modules. Therefore, I will concentrate on those aspects of this program that differentiate it from 
the programs in previous modules. 


3.4.25.5.1.2 A new LinkedList object 


The code in Listing 2 (p. 1278) instantiates a new LinkedList object and passes that object’s reference 
to a method named fillIt where it is populated with the names of several people. 


Listing 2 . A new LinkedList object. 


ref = new LinkedList(); 
Populator.fillIt (ref); 


Table 3.519 


The LinkedList class is one of the concrete implementation classes of the Collections Framework. This 
class implements the Collection interface and the List interface. Here is part of what Oracle has to say 
about the LinkedList class: 


"Linked list implementation of the List interface. Implements all optional list operations, 
and permits all elements (including null). In addition to implementing the List interface, the 
LinkedList class provides uniformly named methods to get, remove and insert an element at the 
beginning and end of the list. These operations allow linked lists to be used as a stack, queue, 
or double-ended queue (deque)." 


3.4.25.5.1.3 Populating the List 


The code in Listing 3 (p. 1279) shows the fillIt method that is used to populate the list with references 
to six different String objects. 

The add method is used to add each new element to the end of the list. As you can see, the elements 
are added to the list in no particular order with respect to their values. 
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Listing 3 . The fillIt method. 


class Populator{ 

public static void fillIt(Collection ref){ 
ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 

}//end fillIt( 

}//end class Populator 


Table 3.520 


3.4.25.5.1.4 Displaying the list 


Although I didn’t bother to do so in this program, if an iterator were to be used to access and display the 
elements in the list following the invocation of the fillIt method, the result would be as shown below: 
Joe Bill Tom JOE BILL TOM 
As you can see, this is the same as the order in which the elements are added to the list. The first element 
is added to the list at index value 0 and the sixth element is added to the list at index value 5. 


3.4.25.5.1.5 Sort the list 


The code shown in Listing 4 (p. 1279) is new to this module. This code uses the sort method of the 
Collections class, along with a Comparator object to sort the contents of the list. 


Listing 4 . Sort the list. 


Collections.sort((List)ref, new TheComparator()); 


Table 3.521 


The sort method expects to receive an incoming parameter of type List . Therefore, it was 
necessary to cast the reference from type Collection to type List 


3.4.25.5.1.6 A very important point 


Unlike the programs in previous modules that simply extracted the contents of the collection into an array 
and sorted the array, this code actually rearranges the contents of the list according to the sorting rules. 


(The programs in previous modules that sorted the array did not rearrange the contents of the 
list. Only the contents of the array were rearranged.) 


Thus, the relationship between an element in the list and the index associated with that element can change 
as a result of the sorting operation shown in Listing 4 (p. 1279) . 

Following the sort, when an iterator is used to access the elements, the elements will be returned by the 
iterator in the newly-sorted order. 
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3.4.25.5.2 The Collections class 


Despite the similarity of the names, the Collections class is different from the Collection interface. 
Here is part of what Oracle has to say about the Collections class: 


"This class consists exclusively of static methods that operate on or return collections. It contains 
polymorphic algorithms that operate on collections, "wrappers", which return a new collection 
backed by a specified collection, and a few other odds and ends." 


3.4.25.5.2.1 The sort method 


The Collections class provides a large number of very interesting and useful methods, such as binary- 
Search , copy , reverse ,and reverseOrder . (The reverseOrder method will be examined in the 
next module.) 

One of the static methods of the Collections class is the sort method. One overloaded version of 
the sort method can be used to sort a list into the natural ordering of its elements. Another overloaded 
version sorts a list according to the order induced by a Comparator 

Here is part of what Oracle has to say about this second version of the sort method that uses a 
Comparator 


public static void sort (List list, Comparator c) "Sorts the specified list according to the 
order induced by the specified comparator. All elements in the list must be mutually comparable 
using the specified comparator ... 


The specified list must be modifiable, but need not be resizable. This implementation dumps 
the specified list into an array, sorts the array, and iterates over the list resetting each element 
from the corresponding position in the array. This avoids the n2 log(n) performance that would 
result from attempting to sort a linked list in place." 


3.4.25.5.2.2 Also uses an array 


I find it interesting that the sort method uses an array as an intermediary in the sorting process. However, 
the difference between this approach and the approach involving arrays shown in previous modules is given 
by the following excerpt from the above quotation: 


"iterates over the list resetting each element from the corresponding position in the array" 


In other words, after sorting the array, the sort method uses the sorted results in the array to rearrange 
the positions of the elements in the list, resulting in a sorted list. 


3.4.25.5.2.3 A flexible approach to sorting 


Thus, the sort method of the Collections class can be used to sort the elements in a list using whatever 
set of comparison rules you program into the compare method of the Comparator object. Furthermore, 
it doesn’t matter how the list is actually implemented so long as it properly implements the List interface. 


3.4.25.5.3 The Comparator 


The code in Listing 5 (p. 1281) shows the class from which the Comparator object was instantiated. 
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Listing 5 . The Comparator. 


class TheComparator implements Comparator ,Serializablef{ 


public int compare(Object 01,0bject o2){ 
if(!(o1 instanceof String) ) 
throw new ClassCastException() ; 
if(!(o2 instanceof String) ) 
throw new ClassCastException() ; 


int result = ((String)o1).compareTo(((String) 02)) ; 
return result*(-1); 
}//end compare () 
}//end class TheComparator 


Table 3.522 


I have presented and explained this class in previous modules, so I won’t discuss it in detail again here. 
Suffice it for now to say that an object instantiated from this class will induce the list to be sorted into 
reverse natural order . 
3.4.25.5.4 Display the sorted list 


The code in Listing 6 (p. 1281) gets and uses an iterator to display the contents of the sorted list. 


Listing 6 . Display the sorted list. 


iter = ref.iterator(); 
while (iter.hasNext()){ 
System.out.print(iter.next() +" "); 
}//end while loop 


Table 3.523 


The output produced by the code in Listing 6 (p. 1281) is shown below: 
Tom TOM Joe JOE Bill BILL 
As you can see, this is reverse natural order as induced by the Comparator object. 


3.4.25.6 Run the program 


I encourage you to copy the code from Listing 1 (p. 1277) . Paste the code into your Java editor. Then 
compile and execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 
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3.4.25.7 Summary 


In this module, I taught you how to use the sort method of the Collections class along witha Comparator 
object to sort the contents of a list. 

By using this approach, you can sort the contents of list according to any set of comparison rules that 
you can program into the compare method of the Comparator object. 

Furthermore, the ability to sort the list is independent of the actual implementation of the list, so long 
as the list properly implements the List interface. For example, the same Comparator object (and 
the same code) can be used to sort an ArrayList ,a LinkedList , ora Vector , producing the same 
results regardless of which class the list object is instantiated from. 


3.4.25.8 What’s next? 


In the next module, I will show you how to use a Comparator created by the reverseOrder method 
of the Collections class to sort a list into reverse natural order . I will also show you how to use the 
reverse method of the Collections class to reverse the order of the elements in a list. 


3.4.25.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4130: The Comparator Interface, Part 5 
e File: Java4130.htm 

e Published: 05/07/13 

e Revised 12/11/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.4.26 Java4130r: Review’” 
3.4.26.1 Table of Contents 
e Preface (p. 1283) 
e Questions (p. 1283) 
1 (p. 1283) , 2 (p. 1283) , 3 (p. 1283) , 4 (p. 1284) , 5 (p. 1284) , 6 (p. 1284) , 7 (p. 1284) , 8 
(p. 1284) , 9 (p. 1284) , 10 (p. 1284) 
Listings (p. 1284) 
Answers (p. 1286) 


Complete program listing (p. 1287) 
Miscellaneous (p. 1289) 


3.4.26.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4130: The Comparator 
Interface, Part 5 374. 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.26.3 Questions 
3.4.26.3.1 Question 1 


What output is produced by the program shown in Listing 1 (p. 1288) ? 


Compiler Error 

Runtime Error 

BILL Bill JOE Joe TOM Tom 
Tom TOM Joe JOE Bill BILL 
Joe Bill Tom 

None of the above. 


Answer 1 (p. 1287) 


3.4.26.3.2 Question 2 

True or False? The LinkedList class implements the Collection interface and the List interface. 
Answer 2 (p. 1286) 

3.4.26.3.3 Question 3 


True or False? Collections is an interface and Collection is a class. 
Answer 3 (p. 1286) 


373This content is available online at <http://cnx.org/content /m48140/1.2/>. 
374http://cnx.org/content /m46193/latest /?collection=coll 1441 /latest 
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3.4.26.3.4 Question 4 


True or False? The Collections class consists exclusively of static methods that operate on or return 
collections. 
Answer 4 (p. 1286) 


3.4.26.3.5 Question 5 


True or False? The sort method of the Collections class, along with a Comparator object can be 
used to sort the contents of a list according to the rules programmed into the Comparator object. 
Answer 5 (p. 1286) 


3.4.26.3.6 Question 6 


True or False? The Collections class provides a large number of very interesting and useful methods, 
such as sort , ternarySearch , copy , reverse ,and reverseOrder 
Answer 6 (p. 1286) 


3.4.26.3.7 Question 7 


True or False? The sort method of the Collections class is an instance (non-static) method. 
Answer 7 (p. 1286) 


3.4.26.3.8 Question 8 


True or False? The sort method of the Collections class can be used without a Comparator object 
to sort a list into descending order according to the natural ordering of its elements. 
Answer 8 (p. 1286) 


3.4.26.3.9 Question 9 


True or False? The sort method of the Collections class uses an array as an intermediary in the sorting 
process. 
Answer 9 (p. 1286) 


3.4.26.3.10 Question 10 


True or False? The rules programmed into the compare method of the class named TheComparator 
in Listing 1 (p. 1288) produces a sort order of ascending natural order when used with the sort method 
of the Collections class to sort the contents of a list. 

Answer 10 (p. 1286) 


3.4.26.4 Listings 
e Listing 1 (p. 1288) . Comparator06.java. 
What is the meaning of the following two images? 


These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 
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None 


Display your namet 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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3.4.26.5 Answers 
3.4.26.5.1 Answer 10 
False. The rules programmed into the compare method of the class named TheComparator in Listing 
1 (p. 1288) produces a sort order of descending natural order when used with the sort method of the 
Collections class to sort the contents of a list. 
Back to Question 10 (p. 1284) 
3.4.26.5.2 Answer 9 
True. 
Back to Question 9 (p. 1284) 
3.4.26.5.3 Answer 8 
False. The sort method of the Collections class can be used without a Comparator object to sort 
a list into ascending order according to the natural ordering of its elements. 
Back to Question 8 (p. 1284) 
3.4.26.5.4 Answer 7 
False. The sort method of the Collections class isa static method. 
Back to Question 7 (p. 1284) 
3.4.26.5.5 Answer 6 
False. The Collections class provides a large number of very interesting and useful methods, such as 
sort , binarySearch , copy , reverse , and reverseOrder . The Collections class does not 
provide a method named ternarySearch . 
Back to Question 6 (p. 1284) 
3.4.26.5.6 Answer 5 
True. 
Back to Question 5 (p. 1284) 
3.4.26.5.7 Answer 4 
True. 
Back to Question 4 (p. 1284) 
3.4.26.5.8 Answer 3 
False. Collection is an interface and Collections is a class. 
Back to Question 3 (p. 1283) 
3.4.26.5.9 Answer 2 


True. 
Back to Question 2 (p. 1283) 
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3.4.26.5.10 Answer 1 


Tom TOM Joe JOE Bill BILL 
Back to Question 1 (p. 1283) 


3.4.26.6 Complete program listing 
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Listing 1 . Comparator06.java. 


//File Comparator06.java 
//Copyright 2001, R.G.Baldwin 
import java.util.*; 
import java.io.Serializable; 


public class Comparator06{ 
public static void main(String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Comparator06 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new LinkedList(); 

Populator.fillIt (ref); 

Collections.sort((List)ref, new TheComparator()); 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 
}//end fillIt() 
}//end class Populator 


class TheComparator implements Comparator,Serializablef{ 


public int compare(Object 01,0bject o2){ 
if(!(o1 instanceof String) ) 
throw new ClassCastException() ; 
if(!(o2 instanceof String) ) 
throw new ClassCastException() ; 


//Do an upper-case comparison 
int result = ((String)o1).compareTo(((String) 02)) ; 
return results (—1); : 
}//end compare (Gu e for free at Connexions <http://cnx.org/content /col11441/1.181> 


}//end class TheComparator 
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Table 3.524 


3.4.26.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4130r: Review 
e File: Java4130r.htm 

e Published: 12/03/13 

e Revised 12/11/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4.27 Java4140: The Comparator Interface, Part 6°” 
3.4.27.1 Table of Contents 


e Preface (p. 1290) 
Viewing tip (p. 1290) 
x Listings (p. 1290) 
e Preview (p. 1290) 
e Generics (p. 1291) 
e Discussion and sample code (p. 1291) 
Beginning with a quiz (p. 1291) 
«x And the answer is ... (p. 1293) 
Similar to previous programs (p. 1293) 
A new ArrayList object (p. 1293) 
Displays the list contents (p. 1293) 
The ArrayList class (p. 1294) 
x The reverse method of the Collections class (p. 1294) 
The Collections class (p. 1295) 
x The reverse method (p. 1295) 


* * * * 


375This content is available online at <http://cnx.org/content /m46194/1.2/>. 
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Contents of the list (p. 1295) 

The reverseOrder method (p. 1295) 

What does Oracle have to say about this? (p. 1295) 
Reverse natural order (p. 1296) 


The wonderful world of the Java interface (p. 1296) 
Sorting the list (p. 1296) 

Source of Comparator object is new (p. 1296) 
Don’t know, don’t care (p. 1296) 

The output (p. 1297) 


Run the program (p. 1297) 
Summary (p. 1297) 
What’s next? (p. 1297) 
Miscellaneous (p. 1297) 


* 
* 
* 
* 
A type-independent Comparator (p. 1296) 
* 
* 
* 
* 
* 


3.4.27.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

This module shows you how to use a Comparator created by the reverseOrder method of the 
Collections class to sort a list into reverse natural order. The module also shows you how to use the 
reverse method of the Collections class to reverse the order of the elements in a list. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 376 in 
Oracle’s Java Tutorials 377 . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.27.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


3.4.27.2.1.1 Listings 


e Listing 1 (p. 1292) . The program named Comparator07. 

e Listing 2 (p. 1293) . A new ArrayList object. 

e Listing 3 (p. 1294) . The fillIt method. 

e Listing 4 (p. 1294) . The reverse method of the Collections class. 
e Listing 5 (p. 1295) . The reverseOrder method. 

e Listing 6 (p. 1296) . Sorting the list. 

e Listing 7 (p. 1297) . Produce the output. 


3.4.27.3 Preview 


In this module, I will teach you how to usea Comparator created by the reverseOrder method of the 
Collections class to sort a list into reverse natural order . I will also teach you how to use the reverse 
method of the Collections class to reverse the order of the elements in a list. 


36 http://docs.oracle.com/javase /tutorial/collections/index.html 
377http://docs.oracle.com/javase/tutorial/index.html 
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3.4.27.4 Generics 


The code in this series of modules is written with no thought given to Generics 378 . As a result, if you copy 
and compile the code, you will probably get warnings about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.27.5 Discussion and sample code 
3.4.27.5.1 Beginning with a quiz 


Let’s begin with a quiz to test your prior knowledge of the Collections Framework. 
What output is produced by the program shown in Listing 1 (p. 1292) (select one or more answers) ? 


. Compiler Error 

. Runtime Error 

Joe Bill Tom JOE BILL TOM 
. BILL Bill JOE Joe TOM Tom 
. TOM BILL JOE Tom Bill Joe 
. Joe Bill Tom JOE TOM BILL 
. Tom TOM Joe JOE Bill BILL 
. Joe Bill Tom 

I. None of the above. 


HOt OAW D> 


38 http://docs.oracle.com/javase /tutorial/java/generics/index.html 
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Listing 1 . The program named Comparator07. 


//File Comparator07.java 
//Copyright 2001, R.G.Baldwin 
import java.util.*; 


public class Comparator07{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Comparator07 


class Worker{ 
public void doIt(){ 
Iterator iter; 
Collection ref; 


ref = new ArrayList(); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println() ; 


Collections.reverse((List) ref) ; 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println() ; 


Comparator aComparator= Collections.reverseOrder () ; 


Collections.sort((List)ref, aComparator) ; 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 
ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 
}//end fillIt() 
}//end class Popul 
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Table 3.525 


3.4.27.5.1.1 And the answer is ... 


The correct answer to the above question is C, E, and G. The output from the program is shown below: 


Joe Bill Tom JOE BILL TOM 
TOM BILL JOE Tom Bill Joe 
Tom TOM Joe JOE Bill BILL 


If that was your answer, you probably already understand most of the material covered in this module. In 
that case, you might consider skipping this module and moving on to the next module. If that wasn’t your 
answer, you should probably continue with your study of this module. 


3.4.27.5.1.2 Similar to previous programs 


The overall structure of this program in Listing 1 (p. 1292) is similar to programs that I have discussed in 
previous modules. Therefore, I will concentrate on those aspects of this program that differentiate it from 
the programs in previous modules. 


3.4.27.5.1.3 A new ArrayList object 


The code in Listing 2 (p. 1293) instantiates a new ArrayList object and passes that object’s reference to 
a method named fillIt where it is populated with the names of several people. 


Listing 2 . A new ArrayList object. 


ref = new ArrayList(); 
Populator.fillIt (ref); 


iter = ref.iterator(); 

while (iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 


Table 3.526 


3.4.27.5.1.4 Displays the list contents 


The code in Listing 2 (p. 1293) also gets an iterator on the list and uses that iterator to display the contents 
of the populated list. At that point in the program, the list contains the following elements in the order 
shown: 

Joe Bill Tom JOE BILL TOM 

You will recognize this as matching the order in which the elements were added to the list by the fillIt 
method shown in Listing 3 (p. 1294) . 
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Listing 3 . The fillIt method. 


class Populator{ 

public static void fillIt(Collection ref){ 
ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 

}//end fillIt( 

}//end class Populator 


Table 3.527 


3.4.27.5.1.5 The ArrayList class 


The ArrayList class is one of the concrete class implementations of the Collections Framework. This class 
implements both the Collection interface and the List interface. Therefore, it is both a collection and 
a list, and adheres to the contracts and stipulations of both interfaces. 

Here is part of what Oracle has to say about the ArrayList class: 


"Resizable-array implementation of the List interface. Implements all optional list operations, 
and permits all elements, including null. ... (This class is roughly equivalent to Vector, except 
that it is unsynchronized.)" 


3.4.27.5.1.6 The reverse method of the Collections class 


The call to the reverse method shown in Listing 4 (p. 1294) is new to this module. 


Listing 4 . The reverse method of the Collections class. 


Collections.reverse((List) ref) ; 


iter = ref.iterator(); 
while(iter.hasNext())f{ 

System.out.print(iter.next() +" "); 
}//end while loop 


Table 3.528 
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3.4.27.5.2 The Collections class 


A previous module discussed the Collections class, indicating that the class provides a number of static 
methods that can be used to manipulate collections. As a refresher, here is part of what Oracle has to say 
about the Collections class: 


"This class consists exclusively of static methods that operate on or return collections. It contains 
polymorphic algorithms that operate on collections, "wrappers", which return a new collection 
backed by a specified collection, and a few other odds and ends." 


You should recall that the Collections class is not the same as the Collection interface. Don’t confuse 
the two. 
3.4.27.5.2.1 The reverse method 


One of the static methods in the Collections class is the method named reverse . Here is part of what 
Oracle has to say about the reverse method: 


"Reverses the order of the elements in the specified list." 


Pretty simple, huh? But also very useful in some cases. 


3.4.27.5.2.2 Contents of the list 


After calling the reverse method on the list, the code in Listing 4 (p. 1294) above used an iterator to get and 
display the contents of the list. The contents of the list at that point in the program were as shown below: 
TOM BILL JOE Tom Bill Joe 
If you compare this with the previous output, you will see that the locations of the elements in the list 
are reversed. The element at index 0 was moved to index 5, the element at index 5 was moved to index 0, 
and the elements in between were moved accordingly. 


3.4.27.5.2.3 The reverseOrder method 


The code in Listing 5 (p. 1295) is also new to this module. This code calls the static reverseOrder method 
of the Collections class and stores the returned value in a reference variable of type Comparator 


Listing 5 . The reverseOrder method. 


Comparator aComparator= Collections.reverseOrder() ; 


Table 3.529 


3.4.27.5.2.4 What does Oracle have to say about this? 


Here is part of what Oracle has to say about the reverseOrder method: 


"Returns a comparator that imposes the reverse of the natural ordering on a collection of objects 
that implement the Comparable interface. (The natural ordering is the ordering imposed by the 
objects’ own compareTo method.) This enables a simple idiom for sorting (or maintaining) 
collections (or arrays) of objects that implement the Comparable interface in reverse-natural- 
order." 
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3.4.27.5.2.5 Reverse natural order 


You will recall that in several previous modules, I have written a class from which I instantiated a Com- 
parator object that was used to sort elements into reverse natural order . I chose that sorting order 
simply because I needed to illustrate how to define such a class, and in my specific cases, reverse natural 
order was relatively easy to implement. (With a little more effort, I could have implemented a variety of 
different sorting orders.) 

In my design of those classes, I made no attempt to write a generic class that could do the job indepen- 
dently of the type of the elements to be sorted. Rather, my Comparator objects tended to be very type 
specific. 


3.4.27.5.3 A type-independent Comparator 


What we see here is much more general and sophisticated. The Comparator object returned by the 
reverseOrder method can be used to impose a reverse natural order on any collection of objects that 
implement the Comparable interface. Thus, the class from which the objects are instantiated doesn’t 
matter, as long as those classes implement the Comparable interface. (I also discussed the Comparable 
interface in some detail in an earlier module. You may want to refer back to that module to learn more 
about it.) 


3.4.27.5.3.1 The wonderful world of the Java interface 

Here again, we see a manifestation of the benefits of polymorphism as implemented using the Java interface. 
(I frequently tell my students that if they don’t understand interfaces, they can’t possibly understand Java.) 
3.4.27.5.3.2 Sorting the list 


The code in Listing 6 (p. 1296) is not new to this module. An earlier module discussed the use of the sort 
method of the Collections class, along with a Comparator object to sort a list. 


Listing 6 . Sorting the list. 


Collections.sort((List)ref, aComparator) ; 


Table 3.530 


3.4.27.5.3.3 Source of Comparator object is new 


The thing that is new to this module is the source of the Comparator object provided to the sort 
method in Listing 6 (p. 1296) . 

In the previous modules, the Comparator object was obtained by instantiating an object from a class 
of my own design. Those classes implemented the Comparator interface. 

In this case, a reference to a Comparator object was returned by the call to the reverseOrder 
method of the Collections class, and that reference was passed as a parameter to the sort method. 


3.4.27.5.3.4 Don’t know, don’t care 


The sort method doesn’t care where the Comparator object comes from, as long as it properly 
implements the Comparator interface. 
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Regardless of the source of the Comparator object, the sort method will use that object to impose 
the sorting rules imposed by the compare method of the object. In this case, the sorting rules cause the 
list to be sorted into reverse natural order . 


3.4.27.5.3.5 The output 


The code in Listing 7 (p. 1297) gets and uses an iterator to display the contents of the list following the call 
tothe sort method in Listing 6 (p. 1296) . 


Listing 7 . Produce the output. 


iter = ref.iterator(); 

while (iter.hasNext())f{ 
System.out.print(iter.next() +" "); 

}//end while loop 


Table 3.531 


The output produced by the code in Listing 7 (p. 1297) is shown below: 
Tom TOM Joe JOE Bill BILL 
You will recognize this as reverse natural order for the elements in the list. 


3.4.27.6 Run the program 


I encourage you to copy the code from Listing 1 (p. 1292) . Paste the code into your Java editor. Then 
compile and execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 
3.4.27.7 Summary 


In this module, I taught you how to use a Comparator created by the reverseOrder method of the 
Collections class to sort a list into reverse natural order . The Comparator object is generic, and 
can be used to sort any list of objects that implement the Comparable interface. 
IĮ also taught you how to use the reverse method of the Collections class to reverse the order of the 
elements in a list. 


3.4.27.8 What’s next? 


In the next module, I am going to dig a little deeper into the implications of using the toArray method 
declared in the Collection interface. 


3.4.27.9 Miscellaneous 
This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java4140: The Comparator Interface, Part 6 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1293 


e File: Java4140.htm 
e Published: 05/07/13 
e Revised 12/11/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.4.28 Java4140r: Review” 
3.4.28.1 Table of Contents 
e Preface (p. 1299) 
e Questions (p. 1299) 
1 (p. 1299) , 2 (p. 1299) , 3 (p. 1299) , 4 (p. 1299) , 5 (p. 1300) , 6 (p. 1300) , 7 (p. 1300) , 8 
(p. 1300) , 9 (p. 1300) , 10 (p. 1300) , 11 (p. 1300) , 12 (p. 1300) , 13 (p. 1301) 
Listings (p. 1301) 
Answers (p. 1302) 


Complete program listing (p. 1304) 
Miscellaneous (p. 1306) 


3.4.28.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4140: The Comparator 
Interface, Part 6 38° . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.28.3 Questions 
3.4.28.3.1 Question 1 


True or False? The reverseOrder method of the Collections class returns a reference to an object of 
type String . 
Answer 1 (p. 1303) 


3.4.28.3.2 Question 2 


True or False? The reverse method of the Collections class returns a reference to an object of the 
interface type List 
Answer 2 (p. 1303) 


3.4.28.3.3 Question 3 


True or False? A Comparator created by the reverseOrder method of the Collections class can be 
used to sort a list into reverse natural order . 
Answer 3 (p. 1303) 


3.4.28.3.4 Question 4 


What output is produced by the program shown in Listing 1 (p. 1305) (select one or more answers) ? 


e Compiler Error 
e Runtime Error 

e Joe Bill Tom JOE BILL TOM 
e BILL Bill JOE Joe TOM Tom 


379This content is available online at <http://cnx.org/content /m48153/1.3/>. 
38°http://cnx.org/content /m46194/latest /?collection=col1 1441 /latest 
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TOM BILL JOE Tom Bill Joe 
Joe Bill Tom JOE TOM BILL 
Tom TOM Joe JOE Bill BILL 
Joe Bill Tom 

None of the above. 


Answer 4 (p. 1303) 


3.4.28.3.5 Question 5 


True or False? The ArrayList class implements both the Collection interface and the List interface. 
Therefore, it is both a collection anda list , and adheres to the contracts and stipulations of both 
interfaces. 

Answer 5 (p. 1303) 


3.4.28.3.6 Question 6 


True or False? The reverseOrder method returns a Comparator that imposes the reverse of the 
natural ordering on a collection of objects that implement the Comparable interface. 

Answer 6 (p. 1303) 
3.4.28.3.7 Question 7 


True or False? The natural ordering of the elements in a collection is the ordering imposed by the objects’ 
own compare method. 
Answer 7 (p. 1303) 
3.4.28.3.8 Question 8 
True or False? All Java objects have a natural ordering . 
Answer 8 (p. 1303) 
3.4.28.3.9 Question 9 


True or False? The Comparator object returned by the reverseOrder method can be used to impose 
a reverse natural order on any collection of objects that implement the Comparable interface. 
Answer 9 (p. 1303) 


3.4.28.3.10 Question 10 
True or False? If you don’t understand interfaces, they can’t possibly understand Java. 
Answer 10 (p. 1302) 


3.4.28.3.11 Question 11 


True or False? A SortedMap isa Map that maintains its entries in ascending order, sorted according 
to the values’ natural ordering, or according to a Comparator provided at the time of the SortedMap 
creation. 

Answer 11 (p. 1302) 


3.4.28.3.12 Question 12 


True or False? An object of type Map is an object that maps keys to values. Such an object can contain 
duplicate keys but cannot contain duplicate values 
Answer 12 (p. 1302) 
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3.4.28.3.13 Question 13 


True or False? An object of type Deque allows elements to be inserted, retrieved, and removed at both 
ends. 
Answer 13 (p. 1302) 


3.4.28.4 Listings 
e Listing 1 (p. 1305) . Comparator07.java. 
What is the meaning of the following two images? 


These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None 


Display your name 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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3.4.28.5 Answers 

3.4.28.5.1 Answer 13 

True. 
Back to Question 13 (p. 1301) 

3.4.28.5.2 Answer 12 

False. Such an object can contain duplicate values but cannot contain duplicate keys 
Back to Question 12 (p. 1300) 

3.4.28.5.3 Answer 11 


False. A SortedMap isa Map that maintains its entries in ascending order, sorted according to the 
keys’ natural ordering, or according to a Comparator provided at the time of the SortedMap 
creation. 
Back to Question 11 (p. 1300) 


3.4.28.5.4 Answer 10 


True, in the opinion of this author. 
Back to Question 10 (p. 1300) 
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3.4.28.5.5 Answer 9 
True. 

Back to Question 9 (p. 1300) 
3.4.28.5.6 Answer 8 


False. The natural ordering of a collection of objects of a given class is determined by the code written 
into the concrete compareTo method when the compareTo method inherited from the Comparable 
interface is defined. Objects instantiated from a class that doesn’t implement the Comparable interface 
don’t have a natural ordering. 

Back to Question 8 (p. 1300) 
3.4.28.5.7 Answer 7 


False. The natural ordering of the elements in a collection is the ordering imposed by the objects’ own 
compareTo method. 
Back to Question 7 (p. 1300) 
3.4.28.5.8 Answer 6 
True. 
Back to Question 6 (p. 1300) 
3.4.28.5.9 Answer 5 
True. 
Back to Question 5 (p. 1300) 
3.4.28.5.10 Answer 4 


The program output is the three lines of text shown below (without the bullets) . 


e Joe Bill Tom JOE BILL TOM 
e TOM BILL JOE Tom Bill Joe 
e Tom TOM Joe JOE Bill BILL 


Back to Question 4 (p. 1299) 


3.4.28.5.11 Answer 3 
True. 

Back to Question 3 (p. 1299) 
3.4.28.5.12 Answer 2 


False? While it is true that the reverse method of the Collections class reverses the order of the 
elements in a specified list, the method has a void return type. 
Back to Question 2 (p. 1299) 


3.4.28.5.13 Answer 1 


False. The reverseOrder method of the Collections class returns a reference to an object of the 
interface type Comparator . 
Back to Question 1 (p. 1299) 
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3.4.28.6 Complete program listing 
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Listing 1 . Comparator07.java. 


//File Comparator07.java 


//Copyright 2001, R.G.Baldwin 
import java.util.*; 


public class Comparator07{ 
public static void main(String args[]){ 


new Worker() .doItQ; 


}//end main() 
}//end class Comparator07 


class Worker{ 
public void doIt(){ 


Iterator iter; 
Collection ref; 


ref = new ArrayList(); 

Populator.fillIt (ref); 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println() ; 


Collections.reverse((List) ref) ; 

iter = ref.iterator(); 

while(iter.hasNext()){ 
System.out.print(iter.next() +" "); 

}//end while loop 

System. out.println() ; 


Comparator aComparator= Collections.reverseOrder () ; 
Collections.sort((List)ref, aComparator) ; 
iter = ref.iterator(); 
while(iter.hasNext())f{ 
System.out.print(iter.next() +" "); 
}//end while loop 
System. out.println() ; 


}//end doIt() 
}// end class Worker 


class Populator{ 
public static void fillIt(Collection ref){ 


ref .add("Joe") ; 
ref .add("Bill") ; 
ref .add("Tom") ; 
ref .add("JOE") ; 
ref .add("BILL") ; 
ref .add("TOM") ; 


}//end fillItQ 


}//end class Popul 
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3.4.28.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4140r: Review 
e File: Java4140r.htm 

e Published: 12/03/13 

e Revised: 12/22/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4.29 Java4150: The toArray Method, Part 1° 


3.4.29.1 Table of Contents 


e Preface (p. 1307) 
Viewing tip (p. 1307) 
x Listings (p. 1307) 
e Preview (p. 1308) 
Generics (p. 1308) 
e Discussion and sample code (p. 1308) 
Beginning with a quiz (p. 1308) 
«x And the answer is ... (p. 1310) 
A new LinkedList collection (p. 1310) 


The LinkedList class (p. 1310) 

Populating the LinkedList collection (p. 1311) 
Four buttons and two labels (p. 1311) 

The toolTipText property (p. 1311) 

Why am I using Swing GUI components? (p. 1311) 


* * * * * 


381 This content is available online at <http://cnx.org/content/m46197/1.4/>. 
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Making the objects distinguishable (p. 1312) 
x Identifying the buttons and labels (p. 1312) 
x Why populate this way? (p. 1312) 
x Display the collection (p. 1312) 
x Downcast is required (p. 1313) 
x The output for the collection (p. 1313) 
Copy collection elements into an array (p. 1313) 
x The toArray method (p. 1314) 
x Display the array contents (p. 1314) 
x The showArray method (p. 1315) 
x The output for the array (p. 1315) 
How "safe" is the array? (p. 1315) 
x Array contains copies of references to objects (p. 1315) 
x Modifying the state of an object (p. 1315) 
x Display array contents after object modification (p. 1316) 
x Display the contents of the collection again (p. 1316) 
The bottom line (p. 1317) 


Run the program (p. 1317) 
Summary (p. 1317) 
What’s next? (p. 1317) 
Miscellaneous (p. 1317) 


3.4.29.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

This module shows you how to use the simpler version of the overloaded toArray method that is 
declared in the Collection interface. The module also explains why you need to exercise care when using 
the elements stored in the resulting array to avoid corrupting the state of the objects referred to by the 
elements in the collection. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 38? in 
Oracle’s Java Tutorials 383 . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.29.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


3.4.29.2.1.1 Listings 


Listing 6 (p. 1314 
Listing 7 (p. 1314 


. Copy collection elements into an array. 
. Display the array contents. 


e Listing 1 (p. 1309) . The program named ToArray01. 

e Listing 2 (p. 1310) . A new LinkedList collection. 

e Listing 3 (p. 1311) . Beginning of the fillIt method. 

e Listing 4 (p. 1312) . Making the objects distinguishable. 
e Listing 5 (p. 1313) . The showCollection method. 

° ( ) 

° ( ) 


382http://docs.oracle.com/javase/tutorial/collections/index.html 
383http://docs.oracle.com/javase/tutorial/index.html 
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e Listing 8 (p. 1314) . The showArray method. 
e Listing 9 (p. 1316) . Modifying the state of an object. 
e Listing 10 (p. 1316) . Display the contents of the collection again. 


3.4.29.3 Preview 


In earlier modules, I used the toArray method, declared in the Collection interface, to copy elements 

from a collection into an array. However, in those modules, I didn’t take the time to fully explain how to use 

the method. Also, I didn’t fully explain the precautions that you need to take when you use the method. 
The Collection interface declares the following two overloaded versions of the toArray method: 


public Object[] toArrayQ 
public Object[] toArray(Object[] a) 


In this module, will teach you how to use the first (simpler) version of the toArray method. I will also 
show why you need to exercise care when using the elements stored in the array to avoid corrupting the state 
of the objects referred to by the elements in the collection. 

I will teach you how to use the second (more complex) version of the toArray method in the next 
module. 


3.4.29.4 Generics 


The code in this series of modules is written with no thought given to Generics 384 . As a result, if you copy 
and compile the code, you will probably get warnings about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.29.5 Discussion and sample code 


3.4.29.5.1 Beginning with a quiz 


Let’s begin with a quiz to test your prior knowledge of the Collections Framework. To take this quiz, examine 
the program shown in Listing 1 (p. 1309) and write down the output produced by the program. 


384http://docs.oracle.com/javase /tutorial/java/generics/index.html 
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Listing 1 . The program named ToArray01. 


//File ToArray01.java 
//Copyright 2001, R.G.Baldwin 
import java.util.*; 
import javax.swing.*; 


public class ToArray01i{ 
public static void main(String args[]){ 
new Worker ().doItQ; 
}//end main() 
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}//end class ToArray01 


class Worker{ 
public void doIt(){ 
Collection ref; 


//Create, populate, and display the 

// contents of a collection 

ref = new LinkedList(Q); 

Populator.fillIt (ref); 
System.out.println("Collection contents"); 
showCollection(ref) ; 


//Get collection contents into the 

// array and display the new 

// contents of the array. 

Object[] array = ref.toArray(); 
System.out.println("New array contents"); 
showArray (array) ; 


//Modify a property of an object 

// referred to by one of the 

// elements in the array. Display 

// array contents after 

// modification 

System.out.println("Modified array contents"); 
((JComponent) array[0]) .setToolTipText ("XX") ; 
showArray (array) ; 


//Display the contents of the 
// collection 
System.out.println("Collection contents"); 
showCollection (ref) ; 

}//end doIt() 


//Utility method for displaying 
// array contents 
void eee array) { 
for(int i = 0; array.length;i SA 
if (array [i] vailable tps free at Og nS done <http://cnx.org/content /col11441/1.181> 
System.out.print("null "); 
}else{ 


System. out . print (((JComponent)array[i]). 
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Table 3.533 


3.4.29.5.1.1 And the answer is ... 


The correct answer to the quiz is the program output shown below: 


Collection contents 

BO B1 L2 B3 B4 L5 

New array contents 

BO B1 L2 B3 B4 L5 
Modified array contents 
XX B1 L2 B3 B4 L5 
Collection contents 

XX B1 L2 B3 B4 L5 


If that was your answer, you probably already understand most of the material covered in this module. In 
that case, you might consider skipping this module and moving on to the next module. If that wasn’t your 
answer, you should probably continue with your study of this module. 


3.4.29.5.2 A new LinkedList collection 


The code in Listing 2 (p. 1310) creates and populates a new LinkedList object and saves the object’s 
reference as the interface type Collection . The collection is populated by passing the LinkedList 
object’s reference to a method named fillit 

The code in Listing 2 (p. 1310) also displays the contents of the LinkedList after it has been populated. 
The list is displayed by passing the LinkedList object’s reference to a method named showCollection 


Listing 2 . A new LinkedList collection. 


Collection ref; 
ref = new LinkedList(); 


Populator.fillIt (ref); 


System. out .println("Collection contents"); 
showCollection(ref); 


Table 3.534 


3.4.29.5.2.1 The LinkedList class 


The LinkedList class is one of the concrete class implementations of the Collections Framework . This 
class implements the Collection interface and the List interface. Thus, it adheres to the contracts and 
stipulations of the List interface. 

Here is part of what Oracle has to say about this class: 
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"Linked list implementation of the List interface. Implements all optional list operations, and 
permits all elements (including null). In addition ..." 


3.4.29.5.2.2 Populating the LinkedList collection 


The beginning of the static fillIt method, used to populate the collection, is shown in Listing 3 (p. 1311) . 


Listing 3 . Beginning of the fillIt method. 


public static void fillIt(Collection ref){ 
ref.add(new JButton()); 
ref.add(new JButton()); 
ref.add(new JLabel()); 
ref.add(new JButton()); 
ref.add(new JButton()); 
ref.add(new JLabel()); 


Table 3.535 
As shown in Listing 3 (p. 1311) , the fillit method begins by calling the add method six times in 
succession, passing references to new anonymous objects as a parameter to the add method. 
3.4.29.5.2.3 Four buttons and two labels 


Four of the objects are instantiated from the class named JButton . Two of the objects are instantiated 
from the class named JLabel . 

Both JButton and JLabel belong to the javax.swing package. Further, both are subclasses of 
the class named JComponent 


3.4.29.5.2.4 The toolTipText property 


Finally, both classes have a property named toolTipText , which can be set and accessed by calling the 
following methods on a reference to the object: 


void setToolTipText (String text) 


String getToolTipText () 


3.4.29.5.2.5 Why am I using Swing GUI components? 


I really don’t plan to do anything special with these Swing GUI components. Rather, I chose to use them 
for illustration purposes simply because they possess the characteristics that I need for this module, and the 
next module as well. Those characteristics are: 


e Both classes subclass the class named JComponent (a common superclass below the Object class). 
e Both classes inherit a property (toolTipText) that can be used to identify them later. 
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3.4.29.5.3 Making the objects distinguishable 


After the code in Listing 3 (p. 1311) has been executed, the buttons and labels are indistinguishable on the 
basis of the null value of their toolTipText property. 

The code in Listing 4 (p. 1312) deals with this issue. This code uses the setToolTipText method 
to store a unique String value in the toolTipText property of the object referred to by each of the 
elements in the collection. 


Listing 4 . Making the objects distinguishable. 


Iterator iter = ref.iterator(); 
int cnt = 0; 
JComponent refVar; 


while (iter.hasNext()){ 
refVar = (JComponent)iter.next(); 
if(refVar instanceof JButton){ 
refVar.setToolTipText ("B"+cnt++) ; 
}else{ 
refVar.setToolTipText("L" + cnt++); 
}//end else 
}//end while loop 


}//end fillIt() 


Table 3.536 


3.4.29.5.3.1 Identifying the buttons and labels 


In addition to storing a unique value in the toolTipText property of the object referred to by each element, 
the code in Listing 4 (p. 1312) also makes it possible to distinguish between the JButton objects and 
the JLabel objects. This is accomplished by including an upper-case "B" in the property value for each 
JButton , and including an upper-case "L" in the property value for each JLabel button. 


3.4.29.5.3.2 Why populate this way? 


This approach to population is, admittedly, a little bit of an overkill for illustrating what I want to illustrate 
in this program. However, I plan to use the same fillIt method in the sample program in the next module, 
and it won’t be an overkill there. 


3.4.29.5.3.3 Display the collection 


The code in Listing 2 (p. 1310) above calls the showCollection method to display the contents of the 
populated LinkedList collection. The showCollection method is shown in Listing 5 (p. 1313) 
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Listing 5 . The showCollection method. 


void showCollection(Collection ref){ 
Iterator iter = ref.iterator(); 
while(iter.hasNext()){ 
System.out.print(((JComponent)iter.next()). 
getToolTipText() +" "); 
}//end while loop 
System. out.println(); 
}//end showCollection 


Table 3.537 


By now, you should have no difficulty understanding the code in Listing 5 (p. 1313) . This code gets an 
iterator on the incoming reference of type Collection . The code then uses that iterator to gain access 
to each element in succession, displaying the String value of the toolTipText property belonging to a 
particular object during each iteration. 


3.4.29.5.3.4 Downcast is required 


Note that the next method of the Iterator interface returns a reference to the next element in the 
collection, as type Object . (Remember, Generics were not used to populate this collection.) 

In order to call the getToolTipText method on the returned reference, the reference must be downcast 
to type JComponent . Since both JButton and JLabel extend JComponent , and the 
getToolTipText method is declared in the JComponent class, it is not necessary to be concerned as to 
whether an object is type JButton or type JLabel to display the value of the toolTipText property. 

(This is an example of polymorphic behavior based on class inheritance.) 


3.4.29.5.3.5 The output for the collection 


The output produced by the code in Listing 2 (p. 1310) is shown below: 


Collection contents 
BO B1 L2 B3 B4 L5 


By examining the "B" and "L" characters in this output, you can identify the JButton objects and the 
JLabel objects. 


3.4.29.5.4 Copy collection elements into an array 


The code in Listing 6 (p. 1314) shows how to use the simple version of the toArray method to create an 
array of type Object that contains a copy of each element in the LinkedList collection. 
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Listing 6 . Copy collection elements into an array. 


Object[] array = ref.toArray(); 


Table 3.538 


3.4.29.5.4.1 The toArray method 
Here is some of what Oracle has to say about this version of the toArray method: 


"Returns an array containing all of the elements in this collection. If the collection makes any 
guarantees as to what order its elements are returned by its iterator, this method must return 
the elements in the same order. 


The returned array will be "safe" in that no references to it are maintained by this collection. 
... The caller is thus free to modify the returned array." 


I will have some more to say about the safe aspects of the array shortly. 


3.4.29.5.4.2 Display the array contents 


The code in Listing 7 (p. 1314) calls a method named showArray to cause the current contents of the 


array to be displayed. 


Listing 7 . Display the array contents. 


System. out .println("New array contents"); 
showArray (array); 


Table 3.539 


The entire showArray method is shown in Listing 8 (p. 1314) . 


Listing 8 . The showArray method. 


void showArray(Object[] array){ 
for(int i = 0; i < array.length;i++){ 
if(array[i] == null){ 
System.out.print("null "); 
}else{ 
System. out.print (((JComponent)array[i]). 
getToolTipText() +" "); 
}//end else 
}//end for loop 
System. out.println() ; 
}//end showArray () 
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Table 3.540 


3.4.29.5.4.3 The showArray method 


The behavior of the ShowArray method is straightforward. The method uses a for loop to access each 
of the elements stored in the array in increasing index order. 

A test is made to determine if the element contains a null reference. If so, then the word null is 
displayed for that element. If not, the getToolTipText method is used to access and display the value of 
the toolTipText property for each element in the array. 


3.4.29.5.4.4 The output for the array 


The output produced by the code in Listing 8 (p. 1314) is shown below: 


New array contents 
BO B1 L2 B3 B4 L5 


As you can see, (except for the String that identifies the type of output) this is an exact match to the 
output produced when the contents of the collection were displayed. 


3.4.29.5.5 How "safe" is the array? 


While it is "safe" to modify the contents of the array as explained in the quotation from Oracle earlier, there 
is still some danger here that you need to be aware of. 

Java collections do not store objects. Rather, Java collections store references to objects. In Java, it is 
entirely possible to have two or more references to the same object. 


3.4.29.5.5.1 Array contains copies of references to objects 


Each element in the array is a copy of an element in the collection. 
Therefore, at this point, for each object being managed by the collection, at least two references exist 
that refer to that object. One copy is contained in the collection. The other copy is contained in the array. 
If you use a reference stored in the array to modify the state of one of those objects, that modification 
is made to the object that is also referenced by an element in the collection. This may or may not be what 
you intend. It’s not necessarily a problem as long as you understand what is going on and be careful how 
you use the references stored in the array. 


3.4.29.5.5.2 Modifying the state of an object 


The code shown in Listing 9 (p. 1316) calls the setToolTipText method on the reference stored in the 
first element in the array to modify the state of the object to which that reference refers. Then the code 
calls the showArray method to display the contents of the array. 
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Listing 9 . Modifying the state of an object. 


System.out.println("Modified array contents"); 
((JComponent)array[0]) .setToolTipText ("XX") ; 
showArray (array) ; 


Table 3.541 
The toolTipText property value for each of the objects referred to by the remaining elements is left 
undisturbed. 
3.4.29.5.5.3 Display array contents after object modification 
The output produced by the code in Listing 9 (p. 1316) is shown below: 


Modified array contents 
XX B1 L2 B3 B4 L5 


As you can see, except for the first element, this is a match for the display of the array contents before the 
state of the object referred by the first element was modified. However, the toolTipText property for the 
object referred to by the first element now contains the string "XX", instead of the string "BO" as before. 


3.4.29.5.5.4 Display the contents of the collection again 


The code in Listing 10 (p. 1316) displays the state of each of the objects referred to by the elements in the 
LinkedList collection. 


Listing 10 . Display the contents of the collection again. 


System.out.println("Collection contents"); 
showCollection (ref) ; 


Table 3.542 


The output produced by Listing 10 (p. 1316) is shown below: 


Collection contents 
XX Bi L2 B3 B4 L5 


As you can see, the state of the object referred to by the reference stored in the first element of the collection 


is also changed. The toolTipText property for that object now contains the string "XX" instead of "BO" 
as before. 
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3.4.29.5.6 The bottom line 


It is safe to modify the contents of the array, even to replace the references in the array with references to 
other objects. Such a replacement has no impact on the contents of the collection. 

However, it is also possible to use the elements of the array to modify the state of the objects referred to 
by the elements in the collection. 

If this is what you intend to do, that’s great. However, if that is not what you intend to do, that may be 
a problem. So, the bottom line is, be careful what you do with the elements in the array. 


3.4.29.6 Run the program 


I encourage you to copy the code from Listing 1 (p. 1309) . Paste the code into your Java editor. Then 
compile and execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 


3.4.29.7 Summary 


In this module, I taught you how to use the simpler version of the overloaded toArray method, declared 
in the Collection interface, to copy the elements from a collection into an array of type Object 

I also showed why you need to exercise care when using the elements stored in the array, to avoid 
corrupting the state of the objects referred to by the elements in the collection. 


3.4.29.8 What’s next? 


In the next module, I will teach you how to use the other, more complex version of the overloaded toArray 
method. 


3.4.29.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4150: The toArray Method, Part 1 
e File: Java4150.htm 

e Published: 05/07/13 

e Revised 12/22/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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-end- 
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3.4.30 Java4150r: Review” 
3.4.30.1 Table of Contents 

e Preface (p. 1319) 

e Questions (p. 1319) 

1 (p. 1319) , 2 (p. 1319) , 3 (p. 1319) , 4 (p. 1319) , 5 (p. 1320) , 6 (p. 1320) 

Images (p. 1320) 
Listings (p. 1320) 
Answers (p. 1321) 


Complete program listing (p. 1323) 
Miscellaneous (p. 1324) 


3.4.30.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4150: The toArray 
Method, Part 1 38° . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.30.3 Questions 
3.4.30.3.1 Question 1 


True or False? The Collection interface declares the following two versions of the toArray method 
(with generics syntax omitted because generics is beyond the scope of this course) . 

public Object|| toArray() 

public Object] toArray(Object]]| a) 

Answer 1 (p. 1322) 


3.4.30.3.2 Question 2 
Write down the output produced by the program in Listing 1 (p. 1323) . 
Answer 2 (p. 1322) 


3.4.30.3.3 Question 3 


True or False? When the toArray method is used to produce an array containing the contents of a 
collection, modifying the contents of the array will also modify the contents of the underlying collection. 
Answer 3 (p. 1321) 


3.4.30.3.4 Question 4 


True or False? When the toArray method is used to produce an array containing the contents of a 
collection, the array ends up containing references to copies of the objects referred to by the elements of the 
collection. 

Answer 4 (p. 1321) 


385This content is available online at <http://cnx.org/content /m48168/1.2/>. 
386http://cnx.org/content /m46197 /latest /?collection=coll 1441 /latest 
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3.4.30.3.5 Question 5 


True or False? In Java, it is not possible to have two or more references to the same object. 
Answer 5 (p. 1321) 


3.4.30.3.6 Question 6 


True or False? When the toArray method is used to produce an array containing the contents of a 
collection, if you use a reference stored in the array to modify the state of the object to which it refers, that 
modification is made to an object that is also referred to by an element in the collection. The array and the 
collection contain references to the same objects. 

Answer 6 (p. 1321) 


3.4.30.4 Images 
e Image 1 (p. 1322) . Answer 2. 


3.4.30.5 Listings 
e Listing 1 (p. 1323) . ToArray01.java. 
What is the meaning of the following two images? 


These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


3.4.30.6 Answers 

3.4.30.6.1 Answer 6 

True. 
Back to Question 6 (p. 1320) 

3.4.30.6.2 Answer 5 

False. In Java, it is entirely possible to have two or more references to the same object. 
Back to Question 5 (p. 1320) 

3.4.30.6.3 Answer 4 


False. When the toArray method is used to produce an array containing the contents of a collection, the 
collection and the array end up containing copies of references to the same underlying objects. 
Back to Question 4 (p. 1319) 


3.4.30.6.4 Answer 3 


False. According to Oracle, 

" The returned array will be "safe" in that no references to it are maintained by this collection. ... The 
caller is thus free to modify the returned array." 

Note, however, that there is still some danger that you need to be aware of, and you must use caution 
when using the contents of the array. 

Back to Question 3 (p. 1319) 
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3.4.30.6.5 Answer 2 


The program shown in Listing 1 (p. 1323) produces the output shown in Image 1 (p. 1322) . 


Image 1 . Answer 2. 


Collection contents 

BO B1 L2 B3 B4 L5 

New array contents 

BO B1 L2 B3 B4 L5 
Modified array contents 
XX B1 L2 B3 B4 L5 
Collection contents 

XX B1 L2 B3 B4 L5 


Table 3.543 


Back to Question 2 (p. 1319) 


3.4.30.6.6 Answer 1 


True. 
Back to Question 1 (p. 1319) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1318 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


3.4.30.7 Complete program listing 


Listing 1 . ToArray01.java. 


//File ToArray01.java 
//Copyright 2001, R.G.Baldwin 
import java.util.*; 
import javax.swing.*; 


public class ToArray01i{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class ToArray01 


class Worker{ 
public void doIt(){ 
Collection ref; 


//Create, populate, and display the 

// contents of a collection 

ref = new LinkedList(); 

Populator.fillIt (ref); 
System.out.println("Collection contents"); 
showCollection (ref) ; 


//Get collection contents into the 

// array and display the new 

// contents of the array. 

Object[] array = ref.toArray(); 
System.out.println("New array contents"); 
showArray (array) ; 


//Modify a property of an object 

// referred to by one of the 

// elements in the array. Display 

// array contents after 

// modification 

System.out.println("Modified array contents"); 
((JComponent)array[0]) .setToolTipText ("XX") ; 
showArray (array) ; 


//Display the contents of the 
// collection 
System.out.println("Collection contents"); 
showCollection (ref) ; 

}//end doIt() 


//Utility method for displaying 
// array contendmailable for free at Connexions <http://cnx.org/content /coll1441/1.181> 
void showArray(Object[] array){ 
for(int i = 0; i < array.length;it++){ 
if(array[i] == null){ 
Svstem.out.print("null "): 
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Table 3.544 


3.4.30.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4150r: Review 
e File: Java4150r-htm 

e Published: 12/04/13 

e Revised 12/22/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 

I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 

In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


3.4.31 Java4160: The toArray Method, Part 2°” 
3.4.31.1 Table of Contents 


e Preface (p. 1325) 
Viewing tip (p. 1325) 
x Listings (p. 1326) 
e Preview (p. 1326) 
Generics (p. 1326) 
e Discussion and sample code (p. 1326) 
Beginning with a quiz (p. 1326) 
x And the answer is ... (p. 1328) 
Similar to previous program (p. 1328) 
A populated array (p. 1328) 
Display the array contents (p. 1329) 
A new LinkedList collection (p. 1329) 


Populating the LinkedList collection (p. 1329) 
Four buttons and two labels (p. 1330) 


* * * * * * 


387This content is available online at <http://cnx.org/content /m46198/1.2/>. 
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x The toolTipText property (p. 1330) 

x JButton and JLabel (p. 1331) 

x Making the objects distinguishable (p. 1331) 

x Identifying the buttons and labels (p. 1331) 

x Display the collection (p. 1331) 

x Copy collection elements into an array (p. 1331) 
The toArray method (p. 1332) 

x The essential difference (p. 1332) 

x Type is not an issue for the simpler version (p. 1332) 

* Size is not an issue for the simpler version (p. 1332) 
More-complex version presents some issues (p. 1332) 

x The type issue (p. 1332) 

x Two types of objects in this collection (p. 1333) 

x The size issue (p. 1333) 

* So, what did I do? (p. 1333) 

x More information from Oracle (p. 1333) 
The output (p. 1333) 

x Demonstrates same array was used (p. 1334) 

x What if the array was too small? (p. 1334) 

x Not difficult to demonstrate (p. 1334) 

x Array as large as or larger than collection (p. 1334) 

x Array smaller than the collection (p. 1334) 
Modify an object (p. 1335) 

x Now for the caution (p. 1336) 


Run the program (p. 1336) 
Summary (p. 1336) 
What’s next? (p. 1337) 
Miscellaneous (p. 1337) 


3.4.31.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
in general and the Java Collections framework in particular. 

This module shows you how to use the more-complex version of the toArray method declared in the 

Collection interface. The module discusses issues regarding the type of the array and the types of the 

objects referred to by the elements in the collection. The module also discusses issues regarding the relative 
sizes of the array and the collection. Finally, the module reaffirms that you need to exercise caution when 
using the elements stored in the array, to avoid corrupting the state of the objects referred to by the elements 
in the collection. 

In addition to studying these modules, I strongly recommend that you study the Collections Trail 388 in 
Oracle’s Java Tutorials 38° . The modules in this collection are intended to supplement and not to replace 
those tutorials. 


3.4.31.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


388 http://docs.oracle.com/javase/tutorial/collections/index.html 
38°http://docs.oracle.com/javase/tutorial/index.html 
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3.4.31.2.1.1 Listings 


Listing 1 (p. 1327) . The program named ToArray02. 

Listing 2 (p. 1328) . A populated array. 

Listing 3 (p. 1329) . A new LinkedList collection. 

Listing 4 (p. 1330) . The fillIt method. 

Listing 5 (p. 1331) . Copy collection elements into an array. 
( ) 


Listing 6 (p. 1336) . Modify an object . 


3.4.31.3 Preview 


The Collection interface declares the following two overloaded versions of the toArray method: 


public Object[] toArray( 
public Object[] toArray(Object[] a) 


In the previous module, I taught you how to use the first (simpler) of the two methods. I also discussed 
the need to exercise care when using the elements stored in the returned array to avoid corrupting the state 
of the objects referred to by elements in the collection. 

In this module, I will teach you how to use the second (more-complex) version of the toArray method 
declared in the Collection interface. I will discuss issues regarding the type of the array and the types of 
the objects referred to by the elements in the collection. I will also discuss issues regarding the relative sizes 
of the array and the collection. 

Finally, I will reaffirm that you need to exercise care when using the elements stored in the array, to 
avoid corrupting the state of the objects referred to by the elements in the collection. 


3.4.31.4 Generics 


The code in this series of modules is written with no thought given to Generics 3% . As a result, if you copy 
and compile the code, you will probably get warnings about unchecked or unsafe operations . 

While you will ultimately need to understand how to use Generics, that is a very complex topic. An 
understanding of Generics is beyond the scope of this course. Therefore, for purposes of this course, you can 
simply ignore those warnings. 


3.4.31.5 Discussion and sample code 


3.4.31.5.1 Beginning with a quiz 


As has been the case in the last few modules, let’s begin with a quiz to test your prior knowledge of the 
Collections Framework. To take this quiz, examine the program shown in Listing 1 (p. 1327) and write 
down the output produced by that program. 


39°http://docs.oracle.com/javase/tutorial/java/generics/index.html 
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Listing 1 . The program named ToArray02. 


//File ToArray02.java 
//Copyright 2001, R.G.Baldwin 
import java.util.*; 
import javax.swing.*; 


public class ToArray02{ 
public static void main(String args[]){ 
new Worker().doItQ; 
}//end main() 
}//end class ToArray02 


class Worker{ 
public void doIt(){ 
Collection ref; 


//Create, populate, and display 
// the contents of an array 
JComponent[] array = new JComponent [8]; 
for(int cnt=0;cnt<8;cnt++){ 
array[cnt] = new JButton(); 
array[cnt].setToolTipText("" + (cnt+10)); 
}//end for loop 
System.out.println(); 
showArray(array,"Original array contents"); 


//Create, populate, and display the 

// contents of a collection 

ref = new LinkedList(); 

Populator.fillIt (ref); 
showCollection(ref,"Collection contents"); 


//Get collection contents into the 

// array and display the new 

// contents of the array. 

array = (JComponent[])ref.toArray (array); 
showArray(array,"New array contents"); 


//Modify a property of an object 

// referred to by one of the 

// elements in the array. Display 

// array contents after 

// modification 

((JComponent)array[0]) .setToolTipText ("XX") ; 
showArray(array,"Modified array contents"); 


//Display the contents of the collection 
showCollection(ref,"Collection contents") ; 
}//end doIt() 


//Utility method for displaying 
// array contents 
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Table 3.545 


3.4.31.5.1.1 And the answer is ... 


The correct answer to the quiz is the program output shown below: 


Original array contents 
10 11 12 13 14 15 16 17 
Collection contents 

BO B1 L2 B3 B4 L5 

New array contents 

BO B1 L2 B3 B4 L5 null 17 
Modified array contents 
XX B1 L2 B3 B4 L5 null 17 
Collection contents 

XX B1 L2 B3 B4 L5 


If that was your answer, you probably already understand most of the material covered in this module. In 
that case, you might consider skipping this module and moving on to some more productive activity. If that 
wasn’t your answer, you should probably continue with your study of this module. 


3.4.31.5.1.2 Similar to previous program 


Except for the use of a different version of the toArray method, the overall structure of the program in 
Listing 1 (p. 1327) is similar to the program in the previous module. Therefore, I will concentrate on those 
aspects of this program that differentiate it from the program in the previous module. 


3.4.31.5.1.3 A populated array 


Unlike the program in the previous module, the code in Listing 2 (p. 1328) creates and populates an eight- 
element array of type JComponent . This is the array that will be re-populated by the toArray method 
later in the program. The array is populated with a set of initial element values at this point to make it 
obvious when it is re-populated (overwritten elements) by the toArray method later. 


Listing 2 . A populated array. 


JComponent[] array = new JComponent [8]; 


for(int cnt=0;cnt<8;cnt++){ 
array[cnt] = new JButton(); 
array[cnt].setToolTipText("" + (cnt+10)); 
}//end for loop 
System. out.println() ; 
showArray(array,"Original array contents"); 
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Table 3.546 


The JButton class, the JLabel class, and the setToolTipText method were discussed in detail 
in the previous module, so I won’t repeat that discussion here. 


3.4.31.5.1.4 Display the array contents 


After the array is populated by the code in Listing 2 (p. 1328) , a reference to the array object is passed to 
the showArray method (also in Listing 2 (p. 1328) ) to display the contents of the array. 

With the exception of some minor changes implemented in this program to make the use of the showAr- 
ray method more compact, this is the same showArray method used in the previous module. Therefore, 
I won’t discuss that method further in this module. The output produced by the code in Listing 2 (p. 1328) 
is as follows: 


Original array contents 
10 11 12 13 14 15 16 17 


As you can see, each of the eight elements in the array was initialized with an easily-recognizable and unique 
value, ( which may be overwritten by the toArray method later). 


3.4.31.5.1.5 A new LinkedList collection 


The code in Listing 3 (p. 1329) creates and populates a new LinkedList collection. The collection is 
populated by passing the LinkedList object’s reference to a method named fillIt 

The code in Listing 2 (p. 1328) also displays the contents of the LinkedList collection after it has 
been populated. The list is displayed by passing the LinkedList object’s reference to a method named 
showCollection 


Listing 3 . A new LinkedList collection. 


ref = new LinkedList(); 
Populator.fillIt (ref); 
showCollection(ref,"Collection contents") ; 


Table 3.547 


Except for a couple of minor changes to the showCollection method, the code to create, populate, 
and display the collection is the same as the code in the previous module. 


3.4.31.5.1.6 Populating the LinkedList collection 


A couple of points regarding the fillIt method (shown in Listing 4 (p. 1330) ) are worthy of note. 
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Listing 4 . The fillIt method. 


public static void fillIt(Collection ref){ 
ref.add(new JButton()); 
ref.add(new JButton()); 
ref.add(new JLabel()); 
ref.add(new JButton()); 
ref.add(new JButton()); 
ref.add(new JLabel()); 


Iterator iter = ref.iterator(); 
int cnt = 0; 
JComponent refVar; 
while(iter.hasNext())f{ 
refVar = (JComponent)iter.next(); 
if(refVar instanceof JButton){ 
refVar.setToolTipText ("B"+cnt++) ; 
}else{ 
refVar.setToolTipText("L" + cnt++); 
}//end else 
}//end while loop 


}//end fillItQ 


Table 3.548 


The filllt method begins by calling the add method six times in succession, passing references to new 
anonymous objects (of types JButton and JLabel) as a parameter to the add method. 


3.4.31.5.1.7 Four buttons and two labels 


Four of the objects are instantiated from the class named JButton . The other two objects are instantiated 
from the class named JLabel 

Both JButton and JLabel belong to the javax.swing package. Further, both are subclasses of 
the class named JComponent 


3.4.31.5.1.8 The toolTipText property 


Finally, both classes have a property named toolTipText , which can be set and accessed by calling the 
following methods on a reference to the object: 


void setToolTipText (String text) 


String getToolTipText () 
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3.4.31.5.1.9 JButton and JLabel 


I chose to use objects of these two classes for illustration purposes simply because they possess the charac- 
teristics that I need for this module. Those characteristics are: 


e Both classes subclass the class named JComponent (a common superclass below the Object class). 
e Both classes inherit a property (toolTipText) that can be used to identify them later. 


3.4.31.5.1.10 Making the objects distinguishable 


After adding the objects’ references to the collection, the code in Listing 4 (p. 1330) uses the setToolTip- 
Text method to store a unique String value in the toolTipText property of the object referred to by 
each of the elements in the collection. 


3.4.31.5.1.11 Identifying the buttons and labels 


In addition to storing a unique value in the toolTipText property of the object referred to by each element, 
the code in Listing 4 (p. 1330) also makes it possible to distinguish between the JButton objects and 
the JLabel objects. This is accomplished by including an upper-case "B" in the property value for each 
JButton , and including an upper-case "L" in the property value for each JLabel button. 


3.4.31.5.1.12 Display the collection 


The code in Listing 3 (p. 1329) above calls the showCollection method to display the contents of the 
populated LinkedList collection. The output produced by the code in Listing 3 (p. 1329) is shown below: 


Collection contents 
BO B1 L2 B3 B4 L5 


Each term in the output is the String value ofthe toolTipText property for a particular object. Hence, 
there are six terms in the output, one for each element in the collection. 


3.4.31.5.1.13 Copy collection elements into an array 


Having completed the preliminaries, we have now reached the point that is the main thrust of this module. 
The code in Listing 5 (p. 1331) shows how to use the more-complex version of the toArray method to 
copy the elements in the collection into an array. 


Listing 5 . Copy collection elements into an array. 


array = (JComponent[])ref.toArray(array) ; 
showArray(array,"New array contents"); 


Table 3.549 
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The code in Listing 5 (p. 1331) also causes the contents of the array to be displayed after it receives the 
elements from the collection. 

The first statement in Listing 5 (p. 1331) causes the first seven elements in the array to be overwritten 
with element values from the collection (plus one null value). 

The second statement in Listing 5 (p. 1331) causes the contents of the array to be displayed. 


3.4.31.5.2 The toArray method 


The most important thing to note about Listing 5 (p. 1331) is that a reference to an array object is passed 
as a parameter to the toArray method. (The simpler version of the toArray method, discussed in the 
previous module, doesn’t take any parameters. ) 


3.4.31.5.2.1 The essential difference 


The essential difference between the two overloaded versions of the toArray method has to do with the 
origin of the array into which the toArray method copies the elements from the collection. 

With the simpler version of the toArray method that takes no parameters, the toArray method 
creates a new array object of type Object , populates it, and returns that object’s reference as type 
Object 


3.4.31.5.2.2 Type is not an issue for the simpler version 


Since the new array object is of type Object , (when the rules for Generics are not adhered to) there are 
no issues regarding type compatibility between the type of the array and the types of the elements stored in 
the collection. A reference to an object of any type can be stored in an array of the generic type Object]| 


3.4.31.5.2.3 Size is not an issue for the simpler version 


Also, since the array is created when it is needed by the simpler version of the toArray method, there are 
also no size issues. The array is created to be of the correct size to contain copies of all of the elements in 
the collection. 


3.4.31.5.3  More-complex version presents some issues 


With the more-complex version of the toArray method (shown in Listing 5 (p. 1331) ) , the programmer 
must provide the array object that will be populated by the toArray method. In this situation, there are 
size issues as well as type issues to be dealt with. 


3.4.31.5.3.1 The type issue 


Here is some of what the Oracle documentation for the LinkedList class has to say about the type issue 
for this version of the toArray method: 


"Returns an array containing all of the elements in this list in the correct order. The runtime 
type of the returned array is that of the specified array. ... Throws: ArrayStoreException - if the 
runtime type of (the specified array) is not a supertype of the runtime type of every element in 
this list. 


In other words, the type of the array passed as a parameter to the toArray method must be a superclass 
of the classes from which all of the objects being managed by the collection were instantiated. 
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3.4.31.5.3.2 Two types of objects in this collection 


In this program, the collection is managing objects of the types JButton and JLabel . Each of these 
types is a subclass of the class named JComponent . For that reason, the type of array that I instantiated 
and passed to the toArray method is JComponent|] . 


3.4.31.5.3.3 The size issue 


Here is some of what the Oracle documentation for the LinkedList class has to say about the size issue 
for this version of the toArray method. 


"If the list fits in the specified array, it is returned therein. Otherwise, a new array is allocated 
with the runtime type of the specified array and the size of this list. If the list fits in the specified 
array with room to spare (i.e., the array has more elements than the list), the element in the 
array immediately following the end of the collection is set to null. This is useful in determining 
the length of the list only if the caller knows that the list does not contain any null elements." 


3.4.31.5.3.4 So, what did I do? 


Knowing all of this in advance, I purposely caused the size of the JComponent array to be larger (by 
two elements) than the number of elements in the collection. Therefore, the array that I passed to the 
toArray method was populated and a reference to that populated array was returned. 


(Had my array been smaller than the number of elements in the collection, the toArray method 
would have created and populated a new array of type JComponent and would have returned a 
reference to that new array object. In that case, my array would have been used by the toArray 
method only for the purpose of determining the runtime type of my array.) 


3.4.31.5.3.5 More information from Oracle 


Here is some additional information about the toArray method provided by the Oracle documentation 
for the Collection interface: 


"If this collection makes any guarantees as to what order its elements are returned by its iterator, 
this method must return the elements in the same order." 


Because the iterator for a LinkedList object returns the elements in increasing index order, the toArray 
method, in this case, copies the element at each index position in the collection into the element at the same 
index position in the array. Thus, reference values are copied from each element in the collection into the 
first six elements in the array. 


3.4.31.5.4 The output 


The output produced by the code in Listing 5 (p. 1331) is shown below: 


New array contents 
BO B1 L2 B3 B4 L5 null 17 


You will note that the first six elements in the array match the six elements in the collection (the initial 
values placed in the array earlier when the array was instantiated have been overwritten). 

You will also note that the value of the seventh element in the array (index value 6) has been overwritten 
with a null reference. 
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3.4.31.5.4.1 Demonstrates same array was used 


Note finally that the last element in the array was not overwritten. It still contains the value placed there 
when the array object was instantiated. This demonstrates that the array that I passed to the toArray 
method was populated with the collection data, and a reference to that array was returned by the toArray 
method. 


3.4.31.5.4.2 What if the array was too small? 


Had my array been too small, it would have been discarded by the toArray method. The toArray 
method would have created and populated a new array object of the correct size and runtime type, and 
would have returned a reference to that new array. 


3.4.31.5.4.3 Not difficult to demonstrate 


Although this is not demonstrated by this program, it is easy to modify the program to demonstrate this 
feature. 

A String representation of the array object can be displayed using a System.out.printIn(array) 
statement before and after the array is passed to the toArray method. 


3.4.31.5.4.4 Array as large as or larger than collection 


For the cases where my array contained six, seven, or eight elements, and the collection contained six 
elements, the String representations of the array object before and after the call to the toArray method 
were the same. For one case, those String representations were as follows: 


[Ljavax.swing. JComponent ; 049ba38 
[Ljavax.swing. JComponent ; 049ba38 


In other words, the reference variable named array referred to the same array object before and after the 
call tothe toArray method. 
3.4.31.5.4.5 Array smaller than the collection 


When I reduced the size of the array to five elements, keeping the size of the collection at six elements, the 
before and after String representations of the array object were as follows: 


[Ljavax.swing.JComponent ; 0506411 
[Ljavax.swing. JComponent ; @21807c 


In this case, the reference to the array object returned by the toArray method was different from the 


reference that was passed to the toArray method. In other words, the returned reference referred to a 
different array object than was referred to by the reference that was passed to the toArray method. 
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3.4.31.5.5 Modify an object 


As in the program in the previous module, the code shown in Listing 6 (p. 1336) modifies the value of the 
toolTipText property of the object whose reference is stored in index 0 of the array. 
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Listing 6 . Modify an object . 


((JComponent) array [0]) .setToolTipText ("XX"); 
showArray(array,"Modified array contents"); 


showCollection(ref,"Collection contents"); 


Table 3.550 


The code in Listing 6 (p. 1336) also displays the contents of the array and the contents of the collection 
after the modification is made. 
The output produced by the code in Listing 6 (p. 1336) is shown below: 


Modified array contents 
XX B1 L2 B3 B4 L5 null 17 
Collection contents 

XX B1 L2 B3 B4 L5 


3.4.31.5.5.1 Now for the caution 


Note that the value of the toolTipText property of the object referred to by the reference at index 0 of 
the array, and the same property of the object referred to by the reference at index 0 of the collection was 
overwritten by "XX". (This is true because both references refer to the same object.) 

This is the case regardless of which version of the toArray method is used. Therefore, the same 
cautions discussed in the previous module apply here as well. 


3.4.31.6 Run the program 


I encourage you to copy the code from Listing 1 (p. 1327) , Paste the code into your Java editor. Then 
compile and execute it. 

Run the program and observe the results. Experiment with the code. Make changes, run the program 
again, and observe the results of your changes. Make certain that you can explain why your changes behave 
as they do. 


3.4.31.7 Summary 


In this module, I taught you how to use the more-complex version of the two overloaded versions of the 
toArray method, declared in the Collection interface, to copy the elements from a collection into an 
array of type JComponent 

I discussed issues regarding the type of the array and the type of the objects referred to by the elements in 
the container. I also discussed issues regarding the size of the array as compared to the number of elements 
in the collection. 

Finally, I reaffirmed that you need to exercise care when using the elements stored in the array, to avoid 
corrupting the state of the objects referred to by the elements in the collection. 
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3.4.31.8 What’s next? 


For now, at least, this module concludes the series of modules on the Java Collections Framework. If I have 
time later, I will come back and add more modules to teach you how to use the Map and SortedMap 
interfaces, and the concrete class implementations of those interfaces. 


3.4.31.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4160: The toArray Method, Part 2 
e File: Java4160.htm 

e Published: 05/07/13 

e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.4.32 Java4160r: Review” 
3.4.32.1 Table of Contents 


e Preface (p. 1338) 
e Questions (p. 1338) 


1 (p. 1338) , 2 (p. 1338) , 3 (p. 1338) , 4 (p. 1338) , 5 (p. 1339) , 6 (p. 1339) , 7 (p. 1339) , 8 
(p. 1339) , 9 (p. 1339) , 10 (p. 1339) , 11 (p. 1339) , 12 (p. 1339) 


Images (p. 1339) 

Listings (p. 1340) 

Answers (p. 1341) 

Complete program listing (p. 1343) 
Miscellaneous (p. 1345) 


3.4.32.2 Preface 


This module is one in a collection of modules on Java Collections designed for teaching ITSE2321 - Object- 
Oriented Programming (Java) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4160: The toArray 
Method, Part 2 39? . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


3.4.32.3 Questions 
3.4.32.3.1 Question 1 


True or False? The Collection interface declares the following two versions of the toArray method 
(with generics syntax omitted because generics is beyond the scope of this course) . 

public Object|| toArray() 

public Object] toArray(Object]]| a) 

Answer 1 (p. 1342) 


3.4.32.3.2 Question 2 
Write down the output produced by the program shown in Listing 1 (p. 1344) . 
Answer 2 (p. 1342) 


3.4.32.3.3 Question 3 


True or False? The Collections class (as opposed to the Collection interface) , provides static 
methods that operate on collections. 
Answer 3 (p. 1342) 


3.4.32.3.4 Question 4 


True or False? TreeSet is a class in the Java Collections Framework . 
Answer 4 (p. 1342) 


391 This content is available online at <http://cnx.org/content /m48166/1.2/>. 
392 http://cnx.org/content /m46198 /latest /?collection=col1 1441 /latest 
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3.4.32.3.5 Question 5 


True or False? A SortedMap isa Map that maintains its entries in ascending order, sorted according 
to the values’ natural ordering, or according to a Comparator provided at the time of the SortedMap 
creation. 

Answer 5 (p. 1342) 
3.4.32.3.6 Question 6 


True or False? An object of type SortedSet isa Set that, by default, maintains its elements in descending 
order. 

Answer 6 (p. 1342) 
3.4.32.3.7 Question 7 


True or False? An object of type Map is an object that maps keys to values. Such an object can contain 
duplicate keys but cannot contain duplicate values. 

Answer 7 (p. 1342) 
3.4.32.3.8 Question 8 


True or False? An object of type Deque allows elements to be inserted, retrieved, and removed at both 
ends. 
Answer 8 (p. 1341) 
3.4.32.3.9 Question 9 
True or False? Objects of type List allow duplicates.. 
Answer 9 (p. 1341) 
3.4.32.3.10 Question 10 
True or False? Objects of type Set allow duplicates.. 
Answer 10 (p. 1341) 
3.4.32.3.11 Question 11 
True or False? Set is an interface in the Collections Framework . 
Answer 11 (p. 1341) 
3.4.32.3.12 Question 12 
True or False? Collection is the class that forms the root of the Collections Framework hierarchy. 
Answer 12 (p. 1341) 
3.4.32.4 Images 
e Image 1 (p. 1342) . Answer 2. 
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3.4.32.5 Listings 
e Listing 1 (p. 1344) . ToArray02.java. 
What is the meaning of the following two images? 


These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None 


Display your nam: 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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3.4.32.6 Answers 

3.4.32.6.1 Answer 12 

False. Collection is an interface, not a class. 
Back to Question 12 (p. 1339) 

3.4.32.6.2 Answer 11 

True. 
Back to Question 11 (p. 1339) 

3.4.32.6.3 Answer 10 

False. Objects of type Set do not allow duplicates. 
Back to Question 10 (p. 1339) 

3.4.32.6.4 Answer 9 

True. 
Back to Question 9 (p. 1339) 

3.4.32.6.5 Answer 8 


True. 
Back to Question 8 (p. 1339) 
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3.4.32.6.6 Answer 7 

False. An object of type Map can contain duplicate values but cannot contain duplicate keys. 
Back to Question 7 (p. 1339) 

3.4.32.6.7 Answer 6 

False. An object of type SortedSet isa Set that, by default, maintains its elements in ascending order. 
Back to Question 6 (p. 1339) 

3.4.32.6.8 Answer 5 


False. A SortedMap isa Map that maintains its entries in ascending order, sorted according to the 
keys’ natural ordering, or according to a Comparator provided at the time of the SortedMap creation. 
Back to Question 5 (p. 1339) 


3.4.32.6.9 Answer 4 
True. 

Back to Question 4 (p. 1338) 
3.4.32.6.10 Answer 3 
True. 

Back to Question 3 (p. 1338) 
3.4.32.6.11 Answer 2 


The output produced by the program in Listing 1 (p. 1344) is shown in Image 1 (p. 1342) . 


Image 1 . Answer 2. 


Original array contents 
10 11 12 13 14 15 16 17 
Collection contents 

BO B1 L2 B3 B4 L5 

New array contents 

BO B1 L2 B3 B4 L5 null 17 
Modified array contents 
XX B1 L2 B3 B4 L5 null 17 
Collection contents 

XX B1 L2 B3 B4 L5 


Table 3.551 


Back to Question 2 (p. 1338) 


3.4.32.6.12 Answer 1 


True. 
Back to Question 1 (p. 1338) 
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3.4.32.7 Complete program listing 
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Listing 1 . ToArray02.java. 


//File ToArray02.java 
//Copyright 2001, R.G.Baldwin 
import java.util.*; 
import javax.swing.*; 


public class ToArray02{ 
public static void main(String args[]){ 
new Worker().doItQ; 
}//end main() 
}//end class ToArray02 


class Worker{ 
public void doIt(){ 
Collection ref; 


//Create, populate, and display 
// the contents of an array 
JComponent[] array = new JComponent [8]; 
for(int cnt=0;cnt<8;cnt++){ 
array[cnt] = new JButton(); 
array[cnt].setToolTipText("" + (cnt+10)); 
}//end for loop 
System.out.println(); 
showArray(array,"Original array contents"); 


//Create, populate, and display the 

// contents of a collection 

ref = new LinkedList(); 

Populator.fillIt (ref); 
showCollection(ref,"Collection contents"); 


//Get collection contents into the 

// array and display the new 

// contents of the array. 

array = (JComponent[])ref.toArray (array); 
showArray(array,"New array contents"); 


//Modify a property of an object 

// referred to by one of the 

// elements in the array. Display 

// array contents after 

// modification 

((JComponent)array[0]) .setToolTipText ("XX") ; 
showArray(array,"Modified array contents"); 


//Display the contents of the collection 
showCollection(ref,"Collection contents") ; 
}//end doIt() 


//Utility method for displaying 
// array contents 
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Table 3.552 


3.4.32.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4160r: Review 
e File: Java4160r.htm 

e Published: 12/04/13 

e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.5 Practice Programs 
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3.5.1 Java OOP: ITSE 2321 Practice Group 1” 
3.5.1.1 ITSE 2321 Object-Oriented Programming - Practice Group 1 


Java and Media Library Version Requirements (p. 1347) 
Input Image Files (p. 1347) 

Solution source code files (p. 1347) 

Output Images (p. 1347) 

New Classes (p. 1347) 

Hints (p. 1348) 

Testing Your Programs (p. 1348) 

Program Specifications (p. 1348) 


Program 1 (p. 1348) 
Program 2 (p. 1354) 
Program 3 (p. 1359) 
Program 4 (p. 1364) 
Program 5 (p. 1369) 


e Miscellaneous Information (p. 1378) 


3.5.1.1.1 Java and Media Library Version Requirements 


Your programs must be compatible with Oracle’s Standard Edition JDK Version 1.7 or later. 

Some of the programs in this group require you to use the Guzdial-Ericson multimedia class library. You 
will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 3% . 


3.5.1.1.2 Input Image Files 
Links are provided within the individual program specifications for downloading any image files that may 
be required to write, compile, and test your programs. 


3.5.1.1.3 Solution source code files 


Links are provided within the individual program specifications for downloading source code files that contain 
the programming solutions. You can compile and execute those programs using procedures described in Java 
OOP: The Guzdial-Ericson Multimedia Class Library 3°% . 


3.5.1.1.4 Output Images 

Your output image(s) must match my output image(s) in every respect including color, size, position, etc. 
Don’t forget to display your name in the output image(s) as shown. 

3.5.1.1.5 New Classes 


You may define new classes and add import directives as needed to cause your programs to behave as 
required, but you may not modify the class definitions for the given classes named ProbXX. 


393 This content is available online at <http://cnx.org/content /m44252/1.8/>. 
394 http://cnx.org/content /m44148 /latest / 
395http://cnx.org/content /m44148 /latest / 
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3.5.1.1.6 Hints 


For some of the programs, you may first need to deduce the algorithm used to transform the input image 
into the output image, and then write a working program that implements that algorithm. In some cases, 
you may need to compare numeric color values for corresponding pixels in the input and output images in 
order to deduce the algorithm. 

You can obtain those color values using the following procedure: 


1. Click on the input image file link(s) and use the capabilities of your browser to download and save the 
image file(s). 

2. Click on the Java solution source code link(s) and use the capabilities of your browser to download 
and save the source code file(s). 

3. If necessary, replace calls to the show method in my source code with calls to the explore method 
to force the program to display the output images in a PictureExplorer window. 

4. Write, compile, and execute a simple Java program that will display each input image file in a 
PictureExplorer window. 

5. Use the input and output PictureExplorer windows to compare the input and output color values 
on a pixel by pixel basis. 


In addition to the hints listed above, I will precede the detailed specifications for each program with a 
discussion that contains hints about the concepts and skills that you will probably need to successfully write 
the program. 

In order to write this or any other Java program of substance, you will need to know how to use 3°96 the 
Java Platform, Standard Edition API Specification 397 as well as the documentation for the Guzdial-Ericson 
Multimedia Class Library °°° . 

You may find other useful hints in my online tutorials and slides for this course as well as in the YouTube 
video lectures for this course. 


3.5.1.1.7 Testing Your Programs 


You can compile and execute your program by following the instructions given at Java OOP: The Guzdial- 
Ericson Multimedia Class Library °° . 


3.5.1.1.8 Program Specifications 
3.5.1.1.8.1 Program 1 


Discussion 

The following is a non-exhaustive list of concepts that you need to understand along with knowledge 
and skills that you need to possess in order to successfully write this program and/or understand the given 
solution in Prob01.java 4°° . Some of these items are general in nature and some are specific to the use of 
Ericson’s multimedia library. 


e How to design and implement an algorithm that will transform Prob01.jpg 4°! into the image shown 
in Figure 1 (p. 1354) . 
e How to incorporate and use an external class library 4°? in addition to the standard Java class library. 


396 http://cnx.org/content /m45117 /latest / 
397http://docs.oracle.com/javase/7/docs/api/index.html 
398http://cnx.org/content /m44148/latest /#4Discussion_and_sample_ code 
399http://cnx.org/content /m44148 /latest / 

400 http://cnx.org/content /m44252/latest /Prob01.java 
401http://cnx.org/content /m44252/latest /Prob01.jpg 

402 http://cnx.org/content /m44148 /latest / 
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The general syntax 493 for a Java application (not a Java applet). 

How to write 4° , compile, and execute 4° a Java application that uses the Guzdial-Ericson Multimedia 
Class Library. 

How to use the standard print and println 
command-line screen. 

The effect of overridden 407 versions of the toString 4°8 method on the print and println methods 
Knowledge of the need for and use of import directives 4° . 

How to define *!° and instantiate an object 41! of a new class named Prob01Runner 
Knowledge of the difference between local variables 41? and instance variables 41° . 
How to declare local reference variables 414 of a given type. 

How to save the Prob01Runner object's reference in a reference variable 
Prob01Runner named obj 

How to call #6 the run method, (which controls the major behavior of the program) , on the 
Prob01Runner object’s reference. 

How to use private 417 , public 418 , protected 419 
How to declare and use reference variables 4?! 
How to select the appropriate overloaded constructors 
World , Turtle , and Picture classes. 

How to define a constructor 4° for a class. 

How to write accessor methods 4? in your new class definition that return references to Turtle and 
World objects. 

How and why to call accessor methods 
How to instantiate anonymous objects 
How to replace 47° the default white Picture object encapsulated in a World object with a new 
and different Picture object encapsulating the contents of a local image file. 

How to call a method on a Picture object to write text 43° onto the Picture object. 

How to call a variety of methods 43! on objects of the Turtle class to cause the Turtle objects in 
your world to do things, such as move forward, change their colors, etc. 


406 methods of the System class to display text on the 


415 of type 


420 access modifiers. 


2 


, and package-private 


versus primitive variables 4? 


423 ; 


in order to instantiate objects 474 


of Ericson’s 


427 on objects. 
428 


403 http://cnx.org/content /m44150/latest/#Listing 9 
404http://cnx.org/content /m44148/latest/#Listing 2 
405http://cnx.org/content /m44148/latest/#Figure 4 
406http://cnx.org/content/m44150/latest /#Listing 5 
407 http://cnx.org/content /m44190/latest / 

408 http://cnx.org/content /m44149/latest / 

409 http://cnx.org/content /m44149/latest/#Listing 1 
“19h ttp://cnx.org/content /m44149/latest/#Listing 2 
411 http://cnx.org/content /m44149/latest/#Listing 1 
412 http://cnx.org/content /m44204/latest / 
“13http://cnx.org/content /m44150/latest / 
414http://cnx.org/content /m44153/latest / 

“15 http://cnx.org/content /m44150/latest/#Listing 2 
“16h ttp://cnx.org/content /m44149/latest/#Listing 1 
“1 7http://cnx.org/content /m44149/ 
“18http://cnx.org/content /m44153/latest / 
419http://docs.oracle.com/javase /tutorial/java/javaOO /accesscontrol.html 
420http://cnx.org/content /m44149/ 

421 http://cnx.org/content /m44149/latest / 
422http://cnx.org/content /m44149/latest / 
423http://cnx.org/content /m44149/latest/#Figure_ 4 
424nttp://cnx.org/content /m44149/latest/#Listing 2 
“25 http://cnx.org/content /m44193/latest / 
426http://cnx.org/content /m44149/latest/#Listing 4 
“7http://cnx.org/content /m44149/latest / 
“28http://cnx.org/content /m44206 /latest / 
429http://cnx.org/content /m44149/latest/#Listing 5 
430http://cnx.org/content /m44149/latest/#Listing 6 
431 http://cnx.org/content /m44149/latest/#Listing 7 
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How pictures are composed of images. 

How images are composed of pixels. 

How pixels are composed of red, green, and blue color values. 

How objects can be used to represent pictures, images, and pixels. 

How methods can be called on those objects to manipulate the red, green, and blue color values. 


Listing 1 . Write the Java application described below. 


/*File Prob01 Copyright 2012 R.G.Baldwin 

Write a program named Prob01 that uses the class definition shown below and Ericson’s media library 
along with the image file named Prob01.jpg 43? to produce the graphic output image shown in Figure 1 
(p. 1354) below. 

Click Prob01.java 433 to download a Java source file containing the solution to this program. 

In addition to the output image, your program must display your name and the other three lines of text 
shown below on the command-line screen: 


Display your name here. 
A 300 by 274 world with 2 turtles in it. 
joe turtle at 256, 131 heading 45.0. 
sue turtle at 50, 37 heading 0.0. 
FOSS AS I IOI I II I I I I I I ICI IK IK 1K 1 A 2K EEE EEEE EEEE a ak ak af 2k a / 
public class Prob01{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
Prob01Runner obj = new Prob0iRunner(); 
obj .run(); 


System. out.println(obj.getMars()); 
System. out.println(obj.getJoe()); 
System. out.println(obj.getSue()); 
}//end main 
}//end class ProbOind program specifications. 


Table 3.553 


432 http://cnx.org/content /m44252/latest /Prob01.jpg 
433 http://cnx.org/content /m44252/latest /Prob01.java 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1346 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1347 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1348 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1349 


Figure 1 . Required output image for Prob01. 


Table 3.554 


3.5.1.1.8.2 Program 2 


Discussion 

The following is a non-exhaustive list of concepts that you need to understand along with knowledge 
and skills that you need to possess in order to successfully write this program and/or understand the given 
solution in Prob02.java “34 . Some of these items are general in nature and some are specific to the use of 
Ericson’s multimedia library. I won’t repeat the items listed under Program 1 (p. 1348) above. Instead, I 
will concentrate on new concepts, knowledge, and skills not included in the above list. 


e How to design and implement an algorithm that will transform Prob02.jpg **° into the image shown 
in Figure 2 (p. 1359) . 

e How to declare and initialize 47° instance variables in a single statement. 
How to instantiate a new object 43? of Ericson’s Picture class encapsulating the contents of a local 
image file. 

e How to call methods 

e How to declare a reference variable 


438 on the new Picture object for a variety of purposes. 


439 capable of storing a reference to a one-dimensional array object. 


434http://cnx.org/content /m44252/latest /Prob02.java 
435 http://cnx.org/content /m44252/latest /Prob02.jpg 

436http://cnx.org/content /m44203/latest/#Listing 2 
437http://cnx.org/content /m44203/latest/#Listing 2 
438 http://cnx.org/content /m44203/latest/#Listing 3 
439 http://cnx.org/content /m44203/latest/#Listing 4 
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e How to populate a one-dimensional array object *4° of type Pixel[] with references to all of the 
Pixel objects encapsulated in a Picture object. 

e How to use al oop structure 44! to individually access the reference to each Pixel object in the array 
object. 

e How to use a reference toa Pixel object to modify 44? the red, green, and blue color values belonging 
to the pixel that is represented by the Pixel object. 

e How usea pair of PictureExplorer objects to design and implement an algorithm that will transform 
the original image 443 into the required output image shown in Figure 2 (p. 1359) . 

e How to display “44 your modified Picture object in an object of Ericson’s PictureExplorer class. 


e How to confirm the validity of your algorithm by numerically comparing the color values in your output 
with the color values produced by compiling and running the program solution 445 given below. 


Listing 2 . Write the Java application described below. 


/*File Prob02 Copyright 2012 R.G.Baldwin 

Write a program named Prob02 that uses the class definition shown below and Ericson’s media library 
along with the image file named Prob02.jpg 446 to produce the graphic output image shown in Figure 2 
(p. 1359) below. 

Click Prob02.java 447 to download a Java source file containing the solution to this program. 

In addition to the output image, your program must display your name and the other text shown below 
on the command-line screen: 


Display your name here. 
Picture, filename Prob02.jpg height 274 width 365 
FOSSA IOI I ICI CI I I I I I I A IK I I 2K 12K EEEE EEE EEE EEEE EEEE EEE EEEN 
public class Prob02{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
ProbO2Runner obj = new ProbO02Runner(); 
obj .run(); 
System. out.println(obj.getPicture()); 
}//end main 
}//end class Prob02 
//End program specifications. 


Table 3.555 


440 http://cnx.org/content /m44203/latest/#Listing 4 
441 http://cnx.org/content /m44203/latest/#Listing 4 
442http://cnx.org/content /m44203/latest/#Listing 4 
443 http://cnx.org/content /m44252/latest /Prob02.jpg 

444 ttp://cnx.org/content /m44203/latest/#Listing 5 
445 http://cnx.org/content /m44252/latest /Prob02.java 
446 http://cnx.org/content /m44252/latest /Prob02.jpg 

447 http://cnx.org/content /m44252/latest /Prob02.java 
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| Figure 2 
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. Required output image for Prob02. 
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R: 0 G 132 B: 48 Color at location: E 


Table 3.556 


3.5.1.1.8.3 Program 3 


Discussion 


The following is a non-exhaustive list of concepts that you need to understand along with knowledge 
and skills that you need to possess in order to successfully write this programand/or understand the given 


solution in Prob03.java 


448 Some of these items are general in nature and some are specific to the use 


of Ericson’s multimedia library. I won’t repeat the items listed above. Instead, I will concentrate on new 
concepts, knowledge, and skills not included in the above lists. 

There are at least two alternative ways to write a program that will satisfy these requirements. 

Both alternatives 


448 http://cnx.org/content /m44252/latest /Prob03.java 
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e How to design and implement an algorithm that will transform Prob03.jpg 449 into the required output 
image shown in Figure 3 (p. 1364) . 
Alternative 1 


e How to create a new one-dimensional array object 45° of type Pixel[] and populate it with references 
to all of the Pixel objects encapsulated in a Picture object. 

e How to use some complicated indexing arithmetic 4! in conjunction with the one-dimensional array 
mentioned above to apply the required algorithm. 


Alternative 2 


e How to use a nested loop structure 45? to achieve the same result. 
e How to use a cast operator 453 . 


Listing 3 . Write the Java application described below. 


/*File Prob03 Copyright 2012 R.G.Baldwin 

Write a program named Prob03 that uses the class definition shown below and Ericson’s media library 
along with the image file named Prob03.jpg 454 to produce the graphic output image shown in Figure 3 
(p. 1364) below. 

Click Prob03.java *°° to download a Java source file containing the solution to this program. 

In addition to the output, your program must display your name and the other text shown below on the 
command-line screen: 


Display your name here. 
Picture, filename Prob03.jpg height 274 width 365 


FOS OOS O IORI ORICA SIOI ISI I I II I I I ISI I a Kk ak ak ak ka 4 / 
public class Prob03{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
ProbO3Runner obj = new ProbO03Runner() ; 
obj .run(); 
System. out.println(obj.getPicture()); 
}//end main 
}//end class Prob03 
//End program specifications. 


Table 3.557 


449 http://cnx.org/content /m44252/latest /Prob03.jpg 
450http://cnx.org/content /m44204/latest/#Listing 3 
451 http://cnx.org/content /m44204/latest/#Listing 5 
452http://cnx.org/content /m44207/latest /#Listing 5 
453 http://cnx.org/content /m44168/ 
454http://cnx.org/content /m44252/latest /Prob03.jpg 
455 http://cnx.org/content /m44252/latest /Prob03.java 
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Figure 3 . Required output image for Prob03. 
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Table 3.558 


3.5.1.1.8.4 Program 4 


Discussion 

The following is a non-exhaustive list of concepts that you need to understand along with knowledge 
and skills that you need to possess in order to successfully write this programand/or understand the given 
solution in Prob04.java 456 . Some of these items are general in nature and some are specific to the use 
of Ericson’s multimedia library. I won’t repeat the items listed above. Instead, I will concentrate on new 
concepts, knowledge, and skills not included in the above lists. 


456http://cnx.org/content /m44252/latest /Prob04.java 
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How to design and implement an algorithm that will transform Prob04.jpg 457 into the image shown 
in Figure 4 (p. 1369) . 

Similarities and differences between classes and interfaces 
The different types under which you can store an object’s reference when the class from which the 
object was instantiated extends a class and implements one or more interfaces. 

The kinds of new relationships that are created when a class implements one or more interfaces. 

The implications of inheriting one or more abstract methods. 

The significance of all interface methods being implicitly abstract. 

That DigitalPicture is an interface 4°9 and is not a class in Ericson’s library. 

The relationship that exists between the DigitalPicture interface and the Picture class. 

The circumstances under which an accessor method can return a reference to an object as type 
DigitalPicture 

The difference between displaying a Picture object with the show and explore methods. 


458 


Listing 4 . Write the Java application described below. 


vhs 


File Prob04 Copyright 2012 R.G.Baldwin 


Write a program named Prob04 that uses the class definition shown below and Ericson’s media library 
along with the image file named Prob04.jpg 46° to produce the graphic output image shown in Figure 4 


(p 
Cl 
In 


. 1369) below. 


ick Prob04.java 46! to download a Java source file containing the solution to this program. 
addition to the output image, your program must display your name and the other text shown below 


on the command-line screen: 


Display your name here. 
Picture, filename Prob04.jpg height 274 width 365 


xk 


EEE EEEE EEEE EE EEEE EEEE EE EEEE EEE EEE EE EEEE EE EEE EEEE EEEE EE EA 


public class Prob04{ 


//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
Prob04Runner obj = new Prob04Runner(); 
DigitalPicture digitalPicture = 
obj .getDigitalPicture(); 
System. out .println(digitalPicture); 
digitalPicture.show(); 
}//end main 


}//end class Prob04 
//End program specifications. 


Table 3.559 


457http://cnx.org/content /m44252/latest /Prob04.jpg 

458 http://cnx.org/content /m44195/latest / 
459http://cnx.org/content /m44195/latest /?collection=col1 1441 /latest 
460http://cnx.org/content /m44252/latest /Prob04.jpg 

461 http://cnx.org/content /m44252/latest /Prob04.java 
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Figure 4 . Required output image for Prob04. 


Prob04.jpg 1 


Put your name here 


Table 3.560 


3.5.1.1.8.5 Program 5 


Discussion 

The following is a non-exhaustive list of concepts that you need to understand along with knowledge 
and skills that you need to possess in order to successfully write this program and/or understand the given 
solution in Prob05.java 46? . Some of these items are general in nature and some are specific to the use 
of Ericson’s multimedia library. I won’t repeat the items listed above. Instead, I will concentrate on new 
concepts, knowledge, and skills not included in the above lists. 


e How to design and implement an algorithm that will transform Prob05a.jpg 4°? and Prob05b.jpg 464 
into the images shown in Figure 5 (p. 1374) and Figure 6 (p. 1378) . 

e What it means for the method named getDigitalPictures to return a reference to an object as type 
DigitalPicture[] 465 . 

e What you can do with a reference of type DigitalPicture[] . 

e The implications of the fact that calling the show method each of the elements of the array of type 
DigitalPicture[] produces a different output image. 


462 http://cnx.org/content /m44252/latest /Prob05.java 
463h¢ttp://cnx.org/content /m44252/latest /Prob05a.jpg 
464 http://cnx.org/content /m44252/latest /Prob05b.jpg 
465 http://cnx.org/content /m44198/latest/#Listing 1 
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Listing 5 . Write the Java application described below. 


/*File Prob05 Copyright 2012 R.G.Baldwin 


Write a program named Prob05 that uses the class definition shown below and Ericson’s media library 
along with the image files named Prob05a.jpg 466 and Prob05b.jpg 467 to produce the pair of graphic 


output images shown in Figure 5 (p. 1374) and Figure 6 (p. 1378) below. 


Note that unless you know how to position the output images on the screen, they will both end up in the 
upper-left corner of the screen with one image partially or completely covering the other image. Use your 


mouse to drag and separate the images. 


Click Prob05.java 468 to download a Java source file containing the solution to this program. 


In addition to the output images mentioned above, your program must display your name and the other 


text shown below on the command-line screen: 


Display your name here. 
Picture, filename Prob05b.jpg height 309 width 412 
Picture, filename Prob0ba.jpg height 274 width 365 
FOSSA ASI CI I I II I I I IK I ICI IOI IK IK kf 2K 12K 1 24 2k fk fC 2K 2K ak ak af ak EN 
public class Prob05{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
ProbO5Runner obj = new ProbO5Runner() ; 
DigitalPicture[] digitalPictures = 
obj.getDigitalPictures() ; 


System. out.println(digitalPictures[0]); 
digitalPictures[0].show() ; 


System. out.println(digitalPictures[1]); 
digitalPictures[1].show() ; 
}//end main 
}//end class Prob05 
//End program specifications. 


Table 3.561 


466 http://cnx.org/content /m44252/latest /Prob05a.jpg 
467http://cnx.org/content /m44252/latest /Prob05b.jpg 
468 http://cnx.org/content /m44252/latest /Prob05.java 
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| Prob05b.jpg 


Put yourname here 
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Figure 5 . First required output image for Prob05. 


ProbO5b.jpg 


Table 3.562 
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Figure 6 . Second required output image for Prob05. 


Prob05a.jpg 


Put your name here 


Table 3.563 


3.5.1.2 Miscellaneous Information 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: ITSE 2321 Practice Group 1 
e File: PracticeGroup01.htm 

e Published: 08/03/12 

e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
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compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.5.2 Java OOP: ITSE 2321 Practice Group 2°” 
3.5.2.1 ITSE 2321 Object-Oriented Programming - Practice Group 2 


Java and Media Library Version Requirements (p. 1380) 
Input Image Files (p. 1380) 

Solution source code files (p. 1380) 

Output Images (p. 1380) 

New Classes (p. 1380) 

Hints (p. 1381) 

Testing Your Programs (p. 1381) 

Program Specifications (p. 1381) 


Program 1 (p. 1381) 
Program 2 (p. 1386) 
Program 3 (p. 1391) 
Program 4 (p. 1396) 
Program 5 (p. 1401) 


e Miscellaneous Information (p. 1405) 


3.5.2.1.1 Java and Media Library Version Requirements 


Your programs must be compatible with Sun’s Standard Edition JDK Version 1.7 or later. 

Some of the programs in this group require you to use the Guzdial-Ericson multimedia class library. You 
will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 47° . 


3.5.2.1.2 Input Image Files 

Links are provided within the individual program specifications for downloading any image files that may 
be required to write, compile, and test your programs. 

3.5.2.1.3 Solution source code files 


Links are provided within the individual program specifications for downloading source code files that contain 
the programming solutions. You can compile and execute those programs using procedures described in Java 
OOP: The Guzdial-Ericson Multimedia Class Library 4” . 


3.5.2.1.4 Output Images 

Your output image(s) must match my output image(s) in every respect including color, size, position, etc. 
Don’t forget to display your name in the output image(s) as shown. 

3.5.2.1.5 New Classes 


You may define new classes and add import directives as needed to cause your programs to behave as 
required, but you may not modify the class definitions for the given classes named ProbXX. 


469This content is available online at <http://cnx.org/content /m44254/1.7/>. 
470 http://cnx.org/content /m44148 /latest / 
47. http://cnx.org/content /m44148 /latest / 
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3.5.2.1.6 Hints 


For some of the programs, you may first need to deduce the algorithm used to transform the input image 
into the output image, and then write a working program that implements that algorithm. In some cases, 
you may need to compare numeric color values for corresponding pixels in the input and output images in 
order to deduce the algorithm. 

You can obtain those color values using the following procedure: 


1. Click on the input image file link(s) and use the capabilities of your browser to download and save the 
image file(s). 

2. Click on the Java solution source code link(s) and use the capabilities of your browser to download 
and save the source code file(s). 

3. If necessary, replace calls to the show method in my source code with calls to the explore method 
to force the program to display the output images ina PictureExplorer window. 

4. Write, compile, and execute a simple Java program that will display each input image file in a 
PictureExplorer window. 

5. Use the input and output PictureExplorer windows to compare the input and output color values 
on a pixel by pixel basis. 


In addition to the hints listed above, I will precede the detailed specifications for each program with a 
discussion that contains hints about the concepts and skills that you will probably need to successfully write 
the program. 

In order to write this or any other Java program of substance, you will need to know how to use 4”? the 
Java Platform, Standard Edition API Specification 473 as well as the documentation for the Guzdial-Ericson 
Multimedia Class Library 4% . 

You may find other useful hints in my online tutorials and slides for this course as well as in the YouTube 
video lectures for this course. 


3.5.2.1.7 Testing Your Programs 


You can compile and execute your program by following the instructions given at Java OOP: The Guzdial- 
Ericson Multimedia Class Library 4° . 


3.5.2.1.8 Program Specifications 
3.5.2.1.8.1 Program 1 


Discussion 

The following is a non-exhaustive list of concepts that you need to understand along with knowledge 
and skills that you need to possess in order to successfully write this program and/or understand the given 
solution in Prob01.java 47° . Some of these items are general in nature and some are specific to the use of 
Ericson’s multimedia library. I won’t repeat the items that were listed with the programs in Practice Group 
1477 | Instead, I will concentrate on new concepts, knowledge, and skills not included in previous lists. 


e How to design and implement an algorithm that will transform the original image 47° into the image 
shown in Figure 1 (p. 1386) . 
e How to instantiate an object and call a method on that object in a single statement 47 . 


472 http://cnx.org/content /m45117 /latest / 
473http://docs.oracle.com/javase/7/docs/api/index.html 
474http://cnx.org/content /m44148 /latest /#Discussion and sample code 
475http://cnx.org/content /m44148/latest / 

476 http://cnx.org/content /m44254/latest /Prob01.java 
477http://cnx.org/content /m44252/latest / 

478http://cnx.org/content /m44254/latest /Prob01.jpg 
479http://cnx.org/content /m44207/latest/#Listing 1 
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How methods belonging to an object call other methods 4°° belonging to the same object. 
How to call a method on an object to modify the object saving only 48! a reference to the modified 
object. 

e The use of nested loops 48? to access and modify image pixels on the basis of the horizontal and vertical 
coordinates of the pixels. 
How to create a mirror image of a portion of an image about a vertical line 48° in the image. 
How to create a mirror image of a portion of an image about a horizontal 484 line in the image. 


Listing 1 . Write the Java application described below. 


/*File Prob01 Copyright 2012 R.G.Baldwin 

Write a program named Prob01 that uses the class definition shown below and Ericson’s media library 
along with the image file named Prob01.jpg 485 to produce the graphic output image shown in Figure 1 
(p. 1386) below. 

Click Prob01.java 486 to download a Java source file containing the solution to this program. 

In addition to the output image, your program must display your name and the other text shown below 
on the command-line screen: 


Display your name here. 
Picture, filename Prob01.jpg height 240 width 320 
FOSSA IO I II I I ICI I I I I I I A IK I ACK 12K 2K 21K EEE 2K EEEE fk ok ak ak ak ak a / 
public class Prob01{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
Picture pic = new Prob01Runner().run(); 
System. out.println(pic); 
}//end main method 
}//end class Prob01 
//End program specifications. 


Table 3.564 


480http://cnx.org/content /m44207 /latest /#Listing_3 
481http://cnx.org/content /m44207 /latest /#Listing_3 
482http://cnx.org/content /m44207 /latest /#Listing_5 
483 http://cnx.org/content /m44207/latest/#Listing 4 
484http://cnx.org/content /m44207/latest/#Listing 7 
485 http://cnx.org/content /m44254/latest /Prob01.jpg 

486 http://cnx.org/content /m44254/latest /Prob01.java 
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Prob01.jpg 
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Figure 1 . Required output image for Prob01. 


Prob0O1.jpg 


Table 3.565 


3.5.2.1.8.2 Program 2 


Discussion 

The following is a non-exhaustive list of concepts that you need to understand along with knowledge 
and skills that you need to possess in order to successfully write this program and/or understand the given 
solution in Prob02.java “8? . Some of these items are general in nature and some are specific to the use of 
Ericson’s multimedia library. I won’t repeat the items that were listed with the programs in Practice Group 
1 488 or earlier programs in this practice group. Instead, I will concentrate on new concepts, knowledge, and 
skills not included in previous lists. 


e How to design and implement an algorithm that will transform Prob02a.jpg 48° and Prob02b.jpg 49° 
into the image shown in Figure 2 (p. 1391) . 


487http://cnx.org/content /m44254/latest /Prob02.java 
488h¢ttp://cnx.org/content /m44252/latest / 

489 http://cnx.org/content /m44254/latest /Prob02a.jpg 
490 http://cnx.org/content /m44254 /latest /Prob02b.jpg 
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e How to flip 4°! an image around its center line. 
e How to crop *? an image. 
e How to copy 4°? one image onto another image. 


Listing 2 . Write the Java application described below. 


/*File Prob02 Copyright 2012 R.G.Baldwin 

Write a program named Prob02 that uses the class definition shown below and Ericson’s media library 
along with the image files named Prob02a.jpg 494 and Prob02b.jpg 4% to produce the graphic output 
image shown in Figure 2 (p. 1391) below. 

Click Prob02.java *°° to download a Java source file containing the solution to this program. 

In addition to the output image, your program must display your name and the other text shown below 
on the command-line screen: 


Display your name here. 
Picture, filename Prob02a.jpg height 118 width 100 
Picture, filename Prob02b.jpg height 240 width 320 
Picture, filename None height 101 width 77 
BOSSA OI I CI CI I ICI I I CK IK I I 2K 12K 1 4 21K EEE 2K EEEE fC 2K 2K ok ak ak ak a / 
public class Prob02{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
Picture[] pictures = new Prob02Runner() .run(); 
System. out.println(pictures[0]); 
System. out.println(pictures[1]) ; 
System. out.println(pictures[2]) ; 
}//end main method 
}//end class Prob02 
//End program specifications. 


Table 3.566 


491 http://cnx.org/content /m44238/latest/#Listing 4 
492http://cnx.org/content /m44238/latest/#Listing 4 
493 http://cnx.org/content /m44238/latest/#Listing 7 
494h¢ttp://cnx.org/content /m44254 /latest /Prob02a.jpg 
495 http://cnx.org/content /m44254 /latest /Prob02b.jpg 
496http://cnx.org/content /m44254 /latest /Prob02.java 
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Prob02b.jpg 


R: 160 G: 180 B: 162 Color at location: 
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ProbO2b.jpg 
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Figure 2 . Required output image for Prob02. 


ProbO2b.jpg 


Table 3.567 


3.5.2.1.8.3 Program 3 


Discussion 

The following is a non-exhaustive list of concepts that you need to understand along with knowledge 
and skills that you need to possess in order to successfully write this program and/or understand the given 
solution in Prob03.java 4°? . Some of these items are general in nature and some are specific to the use of 
Ericson’s multimedia library. I won’t repeat the items that were listed with the programs in Practice Group 
1 498 or earlier programs in this practice group. Instead, I will concentrate on new concepts, knowledge, and 
skills not included in previous lists. 


e How to design and implement an algorithm that will transform Prob03a.bmp *°° , Prob03b.bmp °°° 


497http://cnx.org/content /m44254 /latest /Prob03.java 
498h¢ttp://cnx.org/content /m44252/latest / 
49°http://cnx.org/content /m44254 /latest /Prob03a.bmp 
50°http://cnx.org/content /m44254/latest /Prob03b.bmp 
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Prob03c.bmp *°! , and Prob03d.jpg °°? into the image shown in Figure 3 (p. 1396) . 

Green screen processing °°? of image data. 

Differences among bmp, jpg °° , and png files insofar as green screen processing is concerned. 
Scaling °° the size of images while maintaining the aspect ratio. 


Listing 3 . Write the Java application described below. 


/*File Prob03 Copyright 2012 R.G.Baldwin 

Write a program named Prob03 that uses the class definition shown below and Ericson’s media library 
along with the image files named Prob03a.bmp °° , Prob03b.bmp °°” , Prob03c.bmp °°8 , and Prob03d.jpg 
509 to produce the graphic output image shown in Figure 3 (p. 1396) below. 

Click Prob03.java °!° to download a Java source file containing the solution to this program. 

In addition to the output, your program must display your name and the other text shown below on the 
command-line screen: 


Display your name here. 
Picture, filename None height 256 width 344 
FOSSA AI A ICI I ICI I I EE EEEE EEE EEEE EEE 12K EEEE EEEE EEE EEEN 
public class Prob03{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
ProbO3Runner obj = new ProbO3Runner() ; 
obj .run(); 
}//end main 
}//end class Prob03 
//End program specifications. 


Table 3.568 


50lhttp://cnx.org/content /m44254 /latest /Prob03c.bmp 
502http://cnx.org/content /m44254/latest /Prob03d.jpg 
503http://cnx.org/content /m44210/latest / 
504http://cnx.org/content /m44210/latest /#Discussion_and_sample_code 
'05http://cnx.org/content /m44210/latest/#Listing 4 

“06 http://cnx.org/content /m44254/latest /Prob03a.bmp 
507http://cnx.org/content /m44254/latest /Prob03b.bmp 
508http://cnx.org/content /m44254/latest /Prob03c.bmp 
50°http://cnx.org/content /m44254/latest /Prob03d.jpg 
*10http://cnx.org/content /m44254/latest /Prob03.java 
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None 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1391 


Figure 3 . Required output image for Prob03. 


Table 3.569 


3.5.2.1.8.4 Program 4 


Discussion 

The following is a non-exhaustive list of concepts that you need to understand along with knowledge 
and skills that you need to possess in order to successfully write this program and/or understand the given 
solution in Prob04.java °!! . Some of these items are general in nature and some are specific to the use of 
Ericson’s multimedia library. I won’t repeat the items that were listed with the programs in Practice Group 
1 512 or earlier programs in this practice group. Instead, I will concentrate on new concepts, knowledge, and 
skills not included in previous lists. 


511 http://cnx.org/content /m44254/latest /Prob04.java 
512http://cnx.org/content /m44252 /latest / 
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e How to design and implement an algorithm that will transform Prob04a.bmp °!? , Prob04b.bmp 514 , 
and Prob04c.jpg °° into the image shown in Figure 4 (p. 1401) . 

How to use one image as a pattern °!® to perform modifications on another image. 

How to brighten °!” the colors of selected pixels in an image. 


How to tint 518 the colors of selected pixels in an image. 


Listing 4 . Write the Java application described below. 


/*File Prob04 Copyright 2012 R.G.Baldwin 

Write a program named Prob04 that uses the class definition shown below and Ericson’s media library 
along with the image files named Prob04a.bmp °!* , Prob04b.bmp °° , and Prob04c.jpg 5?! to produce 
the graphic output image shown in Figure 4 (p. 1401) below. 

Click Prob04.java °2? to download a Java source file containing the solution to this program. 

In addition to the output image, your program must display your name and the other text shown below 
on the command-line screen: 


Display your name here. 
Picture, filename None height 293 width 392 
BOSSA A I I II I I I I I II I ICI IK 1K 1K EEE EEE EEEE EEEE a ak ak ak ak ak / 
import java.awt.Color; 
public class Prob04{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
Prob04Runner obj = new Prob04Runner() ; 
obj .run(); 
}//end main 
3//end class Prob04 
//End program specifications. 


Table 3.570 


*13http://cnx.org/content /m44254/latest /Prob04a.bmp 
514http://cnx.org/content /m44254/latest /Prob04b.bmp 
*15http://cnx.org/content /m44254/latest /Prob04c.jpg 
°16http://cnx.org/content /m44234/latest /#Listing 5 
517http://cnx.org/content /m44234/latest: / 
°18http://cnx.org/content /m44234/latest/#Listing 8 
*19http://cnx.org/content /m44254/latest /Prob04a.bmp 
520http://cnx.org/content /m44254/latest /Prob04b.bmp 
521 http://cnx.org/content /m44254/latest /Prob04c.jpg 
522http://cnx.org/content /m44254/latest /Prob04.java 
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Display your name here. 
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Display your name here. 
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Figure 4 . Required output image for Prob04. 


None 


Display your name here. 


Table 3.571 


3.5.2.1.8.5 Program 5 


Discussion 

The following is a non-exhaustive list of concepts that you need to understand along with knowledge 
and skills that you need to possess in order to successfully write this program and/or understand the given 
solution in Prob05.java 5?3 . Some of these items are general in nature and some are specific to the use of 
Ericson’s multimedia library. I won’t repeat the items that were listed with the programs in Practice Group 
1 54 or earlier programs in this practice group. Instead, I will concentrate on new concepts, knowledge, and 
skills not included in previous lists. 


e How to design and implement an algorithm that will transform Prob05a.jpg °° into the image shown 
in Figure 5 (p. 1404) . 
e How to extend a class to make it possible to override one or more methods 5”° belonging to the class. 


523http://cnx.org/content /m44254/latest /Prob05.java 
524http://cnx.org/content /m44252/latest / 
©25http://cnx.org/content /m44254/latest /Prob05.jpg 
©26http://cnx.org/content /m44177/latest / 
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Listing 5 . Write the Java application described below. 


/*File Prob05 Copyright 2012 R.G.Baldwin 

Write a program named Prob05 that uses the class definition shown below and Ericson’s media library 
along with the image file named Prob05a.jpg °?’ to produce the graphic output image shown in Figure 5 
(p. 1404) below. 

Click Prob05.java 58 to download a Java source file containing the solution to this program. 

In addition to the output images mentioned above, your program must display your name and the other 
text shown below on the command-line screen: 


Display your name here. 
Simple Picture, filename Prob05.jpg height 240 width 320 


FOS OSG AGIOS IIRC ASIII CI ICI I I I I IS I a Ka ak ak ak ka 4 / 
public class Prob05{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
MyPicture pic = new Prob05Runner().run(); 
System. out.println(pic); 
pic.addMessage("String", 10,50); 
pic.show() ; 
}//end main method 
}//end class Prob05 
//End program specifications. 


Table 3.572 


527http://cnx.org/content /m44254/latest /Prob05.jpg 
©28http://cnx.org/content /m44254/latest /Prob05.java 
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Figure 5 . Required output image for Prob05. 
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Table 3.573 


3.5.2.2 Miscellaneous Information 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: ITSE 2321 Practice Group 2 
e File: PracticeGroup02.htm 

e Published: 08/03/12 

e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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3.5.3 Java OOP: ITSE 2321 Practice Group 3%” 
3.5.3.1 ITSE 2321 Object-Oriented Programming - Practice Group 3 


Java and Media Library Version Requirements (p. 1406) 
Input Image Files (p. 1406) 

Solution source code files (p. 1406) 

Output Images (p. 1406) 

New Classes (p. 1406) 

Hints (p. 1407) 

Testing Your Programs (p. 1407) 

Program Specifications (p. 1407) 


Program 1 (p. 1407) 
Program 2 (p. 1409) 
Program 3 (p. 1414) 
Program 4 (p. 1419) 
Program 5 (p. 1423) 


e Miscellaneous Information (p. 1426) 


3.5.3.1.1 Java and Media Library Version Requirements 


Your programs must be compatible with Sun’s Standard Edition JDK Version 1.7 or later. 

Some of the programs in this group require you to use the Guzdial-Ericson multimedia class library. You 
will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 530 . 


3.5.3.1.2 Input Image Files 

Links are provided within the individual program specifications for downloading any image files that may 
be required to write, compile, and test your programs. 

3.5.3.1.3 Solution source code files 


Links are provided within the individual program specifications for downloading source code files that contain 
the programming solutions. You can compile and execute those programs using procedures described in Java 
OOP: The Guzdial-Ericson Multimedia Class Library °°! . 


3.5.3.1.4 Output Images 

Your output image(s) must match my output image(s) in every respect including color, size, position, etc. 
Don’t forget to display your name in the output image(s) as shown. 

3.5.3.1.5 New Classes 


You may define new classes and add import directives as needed to cause your programs to behave as 
required, but you may not modify the class definitions for the given classes named ProbXX. 


529This content is available online at <http://cnx.org/content /m44255/1.5/>. 
'30http://cnx.org/content /m44148 /latest / 
°31http://cnx.org/content /m44148 /latest / 
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3.5.3.1.6 Hints 


For some of the programs, you may first need to deduce the algorithm used to transform the input image 
into the output image, and then write a working program that implements that algorithm. In some cases, 
you may need to compare numeric color values for corresponding pixels in the input and output images in 
order to deduce the algorithm. 

You can obtain those color values using the following procedure: 


1. Click on the input image file link(s) and use the capabilities of your browser to download and save the 
image file(s). 

2. Click on the Java solution source code link(s) and use the capabilities of your browser to download 
and save the source code file(s). 

3. If necessary, replace calls to the show method in my source code with calls to the explore method 
to force the program to display the output images in a PictureExplorer window. 

4. Write, compile, and execute a simple Java program that will display each input image file in a 
PictureExplorer window. 

5. Use the input and output PictureExplorer windows to compare the input and output color values 
on a pixel by pixel basis. 


You may find other useful hints in my online tutorials and slides for this course as well as in the YouTube 
video lectures for this course. 

3.5.3.1.7 Testing Your Programs 

You can compile and execute your program by following the instructions given at Java OOP: The Guzdial- 
Ericson Multimedia Class Library °°? . 

3.5.3.1.8 Program Specifications 

3.5.3.1.8.1 Program 1 


Listing 1 . Write the Java application described below. 


/*File Prob01 Copyright 2012 R.G.Baldwin 

Write a program named Prob01 that uses the class definition shown below and Ericson’s media library 
along with the image file named Prob01.jpg °°? to produce the graphic output image shown in Figure 1 
(p. 1409) below. 

Click Prob01.java 534 to download a Java source file containing the solution to this program. 

In addition to the output image, your program must display your name and the other text shown below 
on the command-line screen: 


Display your name here. 
Picture, filename None height 201 width 201 
FOSSA AAS IRI II II I I I I I I ICI IK IK I aK EEE 12K 1 24 EEE EEEE a ak ak ak ak EN 
public class Prob01{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new Prob0iRunner().run(); 
}//end main method 
}//end class Prob01//End program specifications. 


°32http://cnx.org/content /m44148 /latest / 
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Figure 1 . Required output image for Prob01. 


Table 3.575 


3.5.3.1.8.2 Program 2 
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Listing 2 . Write the Java application described below. 


/*File Prob02 Copyright 2012 R.G.Baldwin 

Write a program named Prob02 that uses the class definition shown below and Ericson’s media library 
along with the image file named Prob02.jpg °° to produce the graphic output image shown in Figure 2 
(p. 1414) below. 

Click Prob02.java 536 to download a Java source file containing the solution to this program. 

In addition to the output image, your program must display your name and the other text shown below 
on the command-line screen: 


Display your name here. 
Picture, filename None height 404 width 425 
FOSSA I ICICI I I II I I I IK I II 1K 1 2K 21K EEE 2K EEEE EE ok EEEE EN 
public class Prob02{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new ProbO2Runner().run(); 
3//end main method 
}//end class Prob02//End program specifications. 


Table 3.576 


535http://cnx.org/content /m44255/latest /Prob02.jpg 
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Figure 2 . Required output image for Prob02. 
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Table 3.577 


3.5.3.1.8.3 Program 3 


Listing 3 . Write the Java application described below. 


continued on next page 
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/*File Prob03 Copyright 2012 R.G.Baldwin 

Write a program named Prob03 that uses the class definition shown below and Ericson’s media library 
to produce the graphic output image shown in Figure 3 (p. 1418) below. 

Click Prob03.java 537 to download a Java source file containing the solution to this program. 

In addition to the output, your program must display your name and the other text shown below on the 
command-line screen: 


Display your name here. 
Picture, filename None height 300 width 300 
2 ICA IACI ICR I ACA A A fC fC A 2k 2k 2A 2K AK A OK 2K 2K A 2K fC OK 2k 2k fC fC 2k ok a ka / 
public class Prob03{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new ProbO3Runner().run(); 
}//end main method 
}//end class Prob03//End program specifications. 


Table 3.578 


E None = EX) 
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Figure 3 . Required output image for Prob03. 


None 


Display your name here. 


Table 3.579 
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3.5.3.1.8.4 Program 4 


Listing 4 . Write the Java application described below. 


/*File Prob04 Copyright 2012 R.G.Baldwin 

Write a program named Prob04 that uses the class definition shown below and Ericson’s media library 
along with the image file named Prob04a.jpg °°° to produce the graphic output image shown in Figure 4 
(p. 1422) below. 

Click Prob04.java 53° to download a Java source file containing the solution to this program. 

In addition to the output image, your program must display your name and the other text shown below 
on the command-line screen: 


Display your name here. 
Picture, filename None height 256 width 341 
FOSSA AAS CIO I II I I I II I ICI IK IK IK EEE 12K EEEE EEEE EEE EEEN 
public class Prob04{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new ProbO04Runner().run(); 
3//end main method 
}//end class Prob04 
//End program specifications. 


Table 3.580 


538http://cnx.org/content /m44255 /latest /Prob04a.jpg 
*39http://cnx.org/content /m44255/latest /Prob04.java 
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None 


Display:your name foe 
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Figure 4 . Required output image for Prob04. 


None 


Display your name here. = 


Table 3.581 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1418 CHAPTER 3. ITSE 2321 OBJECT-ORIENTED PROGRAMMING (JAVA) 


3.5.3.1.8.5 Program 5 


Listing 5 . Write the Java application described below. 


/*File Prob05 Copyright 2012 R.G.Baldwin 

Write a program named Prob05 that uses the class definition shown below and Ericson’s media library 
along with the image files named Prob05a.jpg °4° and Prob05b.jpg 54! to produce the graphic output 
image shown in Figure 5 (p. 1426) below. 

Click Prob05.java °4? to download a Java source file containing the solution to this program. 

In addition to the output images mentioned above, your program must display your name and the other 
text shown below on the command-line screen: 


Display your name here. 
Picture, filename None height 252 width 330 
FOSSA IA I IOI I I I I I I IK I IK IK 1K AK EEE 2K EEEE EEE EEEE EEEN 
public class Prob05{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new ProbO5Runner().run(); 
}//end main method 
}//end class Prob05//End program specifications. 


Table 3.582 


40h ttp://cnx.org/content /m44255 /latest /Prob05a.jpg 
541 http://cnx.org/content /m44255 /latest /Prob05b.jpg 
542http://cnx.org/content /m44255 /latest /Prob05.java 
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Figure 5 . Required output image for Prob05. 


None 


Display your namethe 


Table 3.583 


3.5.3.2 Miscellaneous Information 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: ITSE 2321 Practice Group 3 
e File: PracticeGroup03.htm 

e Published: 08/03/12 

e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
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a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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I'TSE2317 - Java Programming 
(Intermediate) 


4.1 Preface 


4.1.1 Jy0030: Java OOP: Preface to ITSE 2317' 
4.1.1.1 Table of Contents 


e Welcome (p. 1429) 
Essence of OOP (p. 1430) 
Programming Oldies but Goodies (p. 1430) 
Downloads (p. 1430) 


e Miscellaneous (p. 1430) 


4.1.1.2 Welcome 


Welcome to the course material for ITSE2317 - Java Programming (Intermediate) , which I teach 
at Austin Community College ? in Austin, TX. 

Information about the course 

The college website for this course is: http://www-.austincc.edu/baldwin/ 3 

As of December 2013, the State of Texas description for this course reads as follows: 


"Introduction to object-oriented Java programming including the fundamental syntax and se- 
mantics of Java for applications and web applets." 


The prerequisite for the course is ITSE 2321 4 or department approval. 

Beginning in the Spring 2014 semester, this course and the follow-on course ( INEW 2338 Advanced 
Java ) were updated to take on a more web-centric flavor than was previously the case. The course now 
covers three major topics : 


e Generics ê 


e Event Handling 7 


1This content is available online at <http://cnx.org/content /m45258/1.6/>. 
*http://www.austincc.edu/ 

3http://www.austincc.edu/baldwin/ 

“http://cnx.org/content /m45222 
>http://cnx.org/content /m48259 /latest /?collection=col11441/latest 
®http://cnx.org/contents/4acd2bdb-ed66-4d33-92e4-463bc9308dc3 
“http://cnx.org/contents/a9f3bd88-95fe-4198-b01d-328c1bb66d23 
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JavaServer Pages (JSP) 8 


This material is contained in three major sub-collections in the section titled ITSE2317 - Java Pro- 
gramming (Intermediate) at Object-Oriented Programming (OOP) with Java ° . 


4.1.1.3 Additional material 
4.1.1.3.1 Essence of OOP 


In addition to the three sub-collections mentioned above (p. 1429) , there is also a sub-collection titled 

Essence of OOP that contains necessary background material for an understanding of Event Handling 
. This is a continuation of a sub-collection having the same title that begins in the prerequisite course, ITSE 
2321 1° 


4.1.1.3.2 Programming Oldies but Goodies 


While much of the material required to succeed in this course is contained in the modules in the sub-collection 
titled ITSE 2317 - Java Programming (Intermediate) ,a large amount of relevant material is also 
contained in the collection titled Programming Oldies but Goodies !! , which is a work in process. The 
material in that collection has not yet been converted to the cnxml format required by cnx.org. Instead, the 
material in that collection is still in its original html format. 

You would do well to familiarize yourself with that material as well. 


4.1.1.3.3 Downloads 


I encourage you to take advantage of all of the download options that cnx.org has to offer in order to 
customize this material for use in your organized courses or for personal self study. 


4.1.1.4 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jy0030: Java OOP: Preface to ITSE 2317 
e File: Jy0030.htm 

e Published: November 29, 2012 

e Revised 09/04/15/15 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


IĮ also want you to know that I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 


Shttp://cnx.org/contents/2fcb0594-fe48-4870-9cee-a8d0f74509d1 

*http://cnx.org/content /col11441 /latest / 
Mhttp://cnx.org/contents/e86afl09-f5f1-4de8-a8f0-be0ef2d87567 
http://cnx.org/content /coll11478 /latest / 
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a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


4.2 Essence of OOP 


4.2.1 Java OOP: The AWT and Swing, A Preview” 
4.2.1.1 Table of Contents 


Preface (p. 1431) 
Discussion (p. 1431) 
What’s next? (p. 1433) 
Miscellaneous (p. 1433) 


4.2.1.2 Preface 


This module is part of a collection of modules designed to teach you about Object-Oriented Programming 
(OOP) using Java. 

(Editor’s note: As you will see when you read this module, the original version was written about 
fourteen years ago. However, despite numerous improvements that have occurred in Java since then, most 
of what was true on this topic in 1998 is still true in 2012. A wise man once said, "If it ain’t broke, don’t fix 
it." 

One of the changes that you will see in subsequent modules is that the name of the package that contains 
the Swing classes has been changed to javax.swing .) 


4.2.1.3 Discussion 


This module provides a very brief preview of some of what you can expect to find in subsequent modules 
regarding the Abstract Windows Toolkit ( AWT ) and the Swing component set. 

The user interface of a modern computer program often involves techniques to activate many of the 
human senses. We use icons, text boxes, images, sound, boardroom graphics, etc. 

We weren’t too concerned with these aspects of programming in the prerequisite course (ITSE 2321) 
because there was a lot that you needed to learn to prepare yourself for understanding material of this sort. 
That is about to change. 

Much of the actual programming that you will do with Java will involve those aspects of the interface 
that we commonly refer to as the Graphical User Interface (GUI) . 

As of 5/10/98, there are two primary packages that are used for GUI programming under JDK 1.1.6: 

1. java. awt .* 

2. com.sun.java. swing .* 
There are, of course, numerous other packages that are used in support of these two packages. 

The AWT material was made available to Java programmers early in the life of Java. This was the 
original material that was used to create graphical user interfaces. Major improvements to the AWT were 
introduced with the release of JDK 1.1. 


!2This content is available online at <http://cnx.org/content /m44331/1.3/>. 
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The Swing components became available in released form for use with JDK 1.1 around the beginning 
of 1998. These components added significantly to the ability of the programmer to create GUIs, both in 
terms of functionality and cosmetics. 

The capability and cosmetics of the AWT were very limited but Swing made GUI programming in 
Java competitive in the real world. A Java programmer no longer need apologize for the quality of the GUIs 
that she can create. 

We expect that these two packages may become more integrated (causing changes in your import 
directives) with the release of JDK 1.2, (probably sometime in 1998) but hopefully the concepts involved 
won’t be greatly different. 

As of 3/5/97, there were more than fifty classes defined in package java.awt . We will discuss some of 
the more important AWT classes in subsequent modules. 

As of 5/10/98, the com.sun.java.swing package contains more than 75 classes and about 20 interfaces. 
You might expect, therefore, that learning to use this material effectively won’t be a trivial task. 

It is very important to understand that Swing is an extension of, and not a replacement for the AWT 
. While it is true that there is some overlap (for example a Swing JButton component might be 
viewed as an improved functional replacement for an AWT Button component, and once you begin 
using Swing buttons you may choose to never again usean AWT button) , the basic functionality 
of Swing is built upon the functionality of the AWT 

Therefore, as students, we cannot simply skip over an understanding of the AWT and move on to 
Swing . The AWT isthe foundation for Swing 

We must first understand the AWT and then understand how Swing extends and improves on the 

AWT . I will attempt to integrate an understanding of both the AWT and Swing in the remaining 
modules in this collection. 

We will begin by introducing you to a few simple components of each type and use these components to 
teach you about such topics as event-driven programming, layout, graphics, etc. Then, time permitting, we 
will dig a little deeper into the more complex aspects of both the AWT and Swing components and 
other features. 

What I won’t do is show you a lot of pictures of various AWT and Swing components as is the 
case with many books and other tutorials (although such pictures can be important for an appreciation of 
GUI programming) . (Have you noticed how many Java books use copies of the JavaSoft documentation 
as filler material to make the book appear to contain more information than it actually contains? At least 
half of many of the books currently in print is nothing more than a reproduction of the documentation that 
you can download for free from JavaSoft. Oh well, enough of that!) 

If you want to see some pictures of AWT and Swing components (which would be only natural) , 
you can create them yourself on your own computer screen. 

For examples of the AWT components, simply look in the folders in the software that you downloaded 
from JavaSoft. When you install JDK 1.1.6, a folder named "demo" will be created that contains about 
two-dozen sample programs. Many of these sample programs have graphical user interfaces that make use 
of the AWT . Just run the programs to see examples of the use of the AWT 

When you download and install Swing 1.0.1, a folder named "examples" will be created. This folder 
contains about nine folders, each of which contains a demonstration application or applet that makes use of 

Swing . You can run these programs to see the examples on your computer screen. 

A particularly interesting demonstration application is the one named SwingSet . One of the new 
components in Swing is a tabbed pane that looks much like a common cardboard file folder with a labeled 
tab on the top, bottom, left, or right. The AWT doesn’t contain such a component. 

This demonstration starts with about twenty such tabbed panes on the screen, each one of which demon- 
strates one aspect of the use of Swing . By clicking on each of the labeled tabs, you can select and exercise 
one aspect of Swing . In addition, there are five menus that contain selections, some of which impact the 
behavior of some aspect of the demonstration. 

While you are there, pay attention to the fact that virtually all of the Swing components are also 
containers, so it is possible to cause other items (such as images) to be contained in components such as 
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buttons and menus. 

Take a look at the pane labeled RadioButtons and see how two different images of JavaSoft’s little 
creature named Duke can be made to function as a radio button. In this case, the selected Duke is waving 
while the unselected Dukes aren’t waving. 

Duke shows up again under ToggleButtons where the button which has been toggled has Duke animated 
in a child’s swing. 

The Checkboxes pane uses light bulbs that either are or are not illuminated to illustrate selection of 
Checkbox items. 

The examples on the Slider pane are truly impressive (the AWT doesn’t have a slider component, 
although it is possible to usea ScrollBar as a crude slider) . 

Take a look at the ListBox pane to see another example of using images inside of a component. 

The DebugGraphics pane demonstrates how to run your program in slow motion so that you can see 
how the components are assembled for debugging purposes. Note that a Slider is used to control the speed 
of assembly of the components. 

And of course, every where you turn in this demo, you will see tool tips that are not a part of the 
AWT . For a little comic relief, take a look at the ToolTips pane. 

Don’t forget to pull down the Options menu and select the "look and feel" of the different panes as you 
view them. 

Actually, words are inadequate to describe what you are going to find when you install and run the 
SwingSet demonstration. To use a corny phrase made famous by an old TV commercial (which many of 
you are probably too young to remember) , "Try it, you'll like it." 


4.2.1.4 What’s next? 


The next module in the collection will take a first look at callbacks . 


4.2.1.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: The AWT and Swing, A Preview 
e File: Java0073.htm 

e Published: 1998 

e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


4.2.2 Java OOP: Callbacks - I” 
4.2.2.1 Table of Contents 


e Preface (p. 1434) 


Viewing tip (p. 
x Figures (p. 


1434) 
1434) 


x Listings (p. 1434) 


e Preview (p. 1435) 


e Discussion and sample code (p. 1436) 


Unicast sample program (p. 1436) 
Multicast sample program (p. 1441) 


Summary (p. 1450) 


4.2.2.2 Preface 


Run the program (p. 1450) 


What’s next? (p. 1450) 
Miscellaneous (p. 1450) 


This module is one in a series of three modules designed to teach you about callbacks in Object-Oriented 
Programming (OOP) using Java. The other two modules are titled Callbacks - II and Callbacks - III. If 
interested, you will find those modules at http://www.dickbaldwin.com/toc.htm 14 . 


4.2.2.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


4.2.2.2.1.1 Figures 


e Figure 1 (p. 1443) . 
e Figure 2 (p. 1447) . 


4.2.2.2.1.2 Listings 


Listing 1 (p. 1436 
Listing 2 (p 
Listing 3 (p. 1438 
Listing 4 (p 
Listing 5 (p. 1440 
Listing 6 ( 
Listing 7 (p. 1442 
Listing 8 (p. 1443 
Listing 9 (p 
Listing 10 (p 
Listing 11 (p. 144 
Listing 12 (p 
Listing 13 (p 


Documentation for the removeElement method. 
Output from Callback02. 


. Define the CallBack interface. 

. Define the Teacher class. 

. Define the Student class. 

. A controlling class named Callback01. 

. Complete listing of program named Callback01. 


) 
) 
) 
) 
) 
p. 1442) . 
) 
) 
) 
4 
5 


Define the CallBack interface. 


. Define the Teacher class. 
. Define the method named register. 
. The unRegister method. 


. Define the callTheRoll method. 
. Define the class named Dog. 
. Define the class named Callback02. 


13This content is available online at <http://cnx.org/content /m44333/1.3/>. 
'4http://www.dickbaldwin.com/toc.htm 
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4.2.2.3 Preview 


Many processes in the standard Java API make use of a mechanism that might be referred to as a callback 
mechanism. Basically, this is a mechanism where a method in one object asks a method in another object 
to "call me back" or "notify me" when an interesting event happens. 

An interesting event 

For example, an interesting event might be that the price of a specified stock goes above its previous high 
value, or the toaster finishes toasting the bread. 


Multicasting 
In fact, many different objects may ask one object to notify them when the interesting event happens. 
This is sometimes referred to as multicasting . (The one-to-one case is often referred to as unicasting.) 


Going further, many different objects may ask one object to notify them when any interesting event in 
a family of interesting events happens, and to identify the specific event that actually happened along with 
the notification. 

Many examples 

For example, we see different forms of callback activity in conjunction with 


e the Delegation Event Model used with GUIs in JDK 1.1, 
e the Observer/Observable concept used in the Model-View-Controller paradigm, 
e the concept of Bound Properties and Constrained Properties in Java Beans , etc. 


You can find examples of all of these in the pages of my online tutorial lessons. 
Callback implementation 

Callback capabilities are often implemented in other languages by passing a function pointer to another 
function. The receiving function uses the passed function pointer to call another function when an interesting 
event happens. However, Java doesn’t support function pointers. In this module, we will learn how to 
implement the callback mechanism using interfaces instead. 

From the simple to the more complex 

As usual, our approach will be to learn the material by reviewing programs that progress from very 
simple to more complex. As mentioned earlier, this topic consumes all of this module and two additional 
lessons on my website as well. 

Meaningful scenarios 

It is usually easier to understand abstract concepts if they are explained in terms of meaningful scenarios. 
In this case, our scenario will consist of a teacher and some students . In the beginning there will only be 
one student. Ultimately there will be many students and there will also be some animals in the classroom 
as well. 

Registration 

The students (and the animals) register themselves on the teachers roll book to be notified of interesting 
events. Initially the interesting event will simply be the teacher taking the roll. Ultimately the interesting 
event will be notification that it is either time for recess, or it is time for lunch. 

Unicast and multicast scenarios 

Initially, only one student receives notification of the one type of event. Ultimately, all of the students 
and all of the animals receive notification of both types of event (recess or lunch) but some of those who 
are notified choose to ignore the notification. 

We will refer to the case where only one student is on the list as the unicast program. We will refer to 
the case where many students (and possibly animals as well) are on the list as the multicast program. 
This terminology was selected because it matches the terminology used in the JDK 1.1 documentation for 
the Delegation Event Model. 

Without further discussion, let’s look at some code. 
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4.2.2.4 Discussion and sample code 
4.2.2.4.1 Unicast sample program 


The purpose of this program is to develop a callback capability using Interfaces . This version of the 
program is designed to emphasize the structure of the process. Therefore an effort was made to avoid the 
requirement for any extra code so it doesn’t do anything fancy. 

A CallBack interface 

This program defines a CallBack interface (interface named CallBack ) that can be used to 
establish a new type of object reference, and also to declare the interface to a method named callBack 
that will be contained in all objects of classes that implement the interface. This method will then be used 
to notify those objects whenever something interesting happens. 

A Teacher class 

The program defines a Teacher class that has the ability to 


e create and maintain a list of (only) one object of the interface type (multiple objects come later) , 
and 
e to notify that object that something interesting has happened by calling its callBack method. 


(As mentioned earlier, the size of the list was constrained to only one object in order to emphasize call- 
back structure and avoid getting bogged down in list processing. A subsequent version will implement list 
processing.) 

A Student class 

The program defines a class named Student that implements the CallBack interface. Objects of 
the Student class can be registered on the list maintained by an object of the Teacher class, and 
can be notified by the object of the Teacher class whenever something interesting happens. Notification 
takes the form of calling the callBack method on the object. 

The method named callBack 

The body of the callBack method can be designed to do anything, but in this case, to keep things 
simple, it just announces that it has been called. 

The controlling class 

Finally, the program defines a controlling class named Callback01 that ties all the pieces together and 
exercises them. 

The program was originally tested using JDK 1.1.3 under Win95 and more recently tested using JDK 
1.7 under Windows Vista. 

The output from the program is shown in the complete program listing in a later section. 

Interesting unicast code fragments 

Listing 1 (p. 1436) defines an interface named CallBack that creates a new type and declares a generic 
method named callBack that can be used to execute a callback on any object that is instantiated from a 
class that implements the interface. 


Listing 1 . Define the CallBack interface. 


interface CallBack{ 
public void callBack(); 
3//end interface CallBack 


Table 4.1 
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A class that can register and notify objects of type CallBack 

Next we need a class whose objects can maintain a list of references to objects of type CallBack 
(objects whose class implements the CallBack interface) . 

We refer to the process of putting an object on the list is registering the object. 

This class also needs to have the ability to notify all the objects on that list when something interesting 
happens. We will name this class Teacher in keeping with the scenario described earlier. 

As mentioned earlier, to keep things simple, and emphasize the callback structure without getting bogged 
down in list processing, we will begin with a limitation of one object for the length of the list. 

The unicast class named Teacher 

The unicast Teacher class consists of one instance variable of type CallBack (the interface type) 
and two instance methods. 

One of the methods named register places an object on the list. The other method named callTheRoll 
calls the callBack method on the object that is on the list. 

Note that the object on the list is guaranteed to have a method named callBack because it implements 
the CallBack interface. Otherwise, it couldn’t get on the list in the first place. This is because the 
register method requires the incoming object’s reference to be of type CallBack 

The Teacher class is defined in Listing 2 (p. 1437) . 


Listing 2 . Define the Teacher class. 


class Teacher{ 
CallBack obj; //list of objects of type CallBack 


//Method to add objects to the list. 

void register(CallBack obj){ 
this.obj = obj; 

}//end register() 


//Method to notify all objects on the list 
void callTheRol1(){ 

obj .callBack() ; 
}//end callTheRol1() 


}//end class Teacher 


Table 4.2 


A class that implements the CallBack interface 

Next, we need a class that implements the CallBack interface. Objects of this class can be registered 
on the list maintained by an object of the Teacher class, and will be notified whenever that object calls 
the callBack method on the registered objects on the list. In keeping with the scenario described earlier, 
we will name this class Student 

By claiming to implement the CallBack interface, this class is required to provide a concrete definition 
for the method named callBack that is declared in the interface. Otherwise, the program won’t compile. 
In this case, that definition is rather simple. The callBack method simply announces that it has been 
called. 


The callback mechanism 
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As we saw above, an object of the Teacher class will call the callBack method on all objects on its 
list when the interesting event occurs. It is important to note that the callback mechanism is to call this 
method. 

The Student class is defined in Listing 3 (p. 1438) . 


Listing 3 . Define the Student class. 


class Student implements CallBack{ 
String name; 


Student (String name){//constructor 
this.name = name; //save the name to identify the obj 
}//end constructor 


public void callBack(){ 
System.out.println(name + " here"); 
}//end callBack() 
}//end class Student 


Table 4.3 


A controlling class named Callback01 
Finally, we need a controlling class to tie all the pieces together and to exercise them. The main method 
in this class 


instantiates an object of the Teacher class named missJones , 
instantiates an anonymous Student object named" Joe ", 

registers the object on the list maintained by missJones , and 

calls the callTheRoll method on missJones to cause the objects on the list to be notified (to 


cause their callBack methods to be called). 


This is not too complicated once you break the process into its component, parts. 
The class named Callback01 is defined in Listing 4 (p. 1439) . 
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Listing 4 . A controlling class named Callback01. 


class Callback01{ 

public static void main(String[] args){ 
//Instantiate Teacher object 
Teacher missJones = new Teacher(); 
//Instantiate and register a Student object with the 
// Teacher object 
missJones.register(new Student ("Joe")) ; 
//Cause the Teacher object to do a callBack on the 
// Student object. 
missJones.callTheRoll (); 

}//end main() 

3//end class Callback01 


Table 4.4 


There you have it. This simple program contains the sum and substance of one approach to callbacks in 
Java. 


It is critical to note that the objects registered on the list are of the interface type CallBack . This 
guarantees that there cannot be an object on the list that does not have an instance method named callBack 


Unicast Program Listing 


A complete listing of the program is provided in Listing 5 (p. 1440) so that you can view the code 
fragments in context. 
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Listing 5 . Complete listing of program named Callback01. 


/*File Callback01.java Copyright 1997, R.G.Baldwin 
The purpose of this program is to develop a callback 
capability using Interfaces. This version of the 
program is designed to emphasize the structure of 
the process, and therefore an effort was made to 
avoid the requirement for any extra code to do 
anything fancy. 


Tested using JDK 1.1.3 under Win95. 
The output from the program is: 


Joe here. 
BOSSA AOKI RI IAI II I II AI ICI II I I IK I FI IK EEE EEE 2K 21 2K a EEE EEEN 
//First we define an interface that will create a new type 
// and declare a generic method that can be used to 
// callback any object that is of a class that implements 
// the interface. 
interface CallBack{ 

public void callBack(); 
}//end interface CallBack 


//Next we need a class whose objects can maintain a 
// registered list of objects of type CallBack (whose 
// class implements the CallBack interface) and can 
// notify all the objects on that list when something 
// interesting happens. 


//To keep things simple, and emphasize the structure of 
// what we are doing, we will begin with a limitation 
// of one object on the length of the list. 


class Teacher{ 
CallBack obj; //list of objects of type CallBack 


//Method to add objects to the list. 

void register(CallBack obj){ 
this.obj = obj; 

}//end register() 


//Method to notify all objects on the list that 
// something interesting has happened. 
void callTheRol1(){ 
//Call the callBack() method on the object. The 
// object is guaranteed to have such a method because 
// it is of a class that implements the CallBack 
// interface. 
obj .callBack ( 
}//end callTheRoll() 
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Table 4.5 


4.2.2.4.2 Multicast sample program 


The multicast version of this program does not modify the basic callback mechanism developed in the 
previous program. It simply enhances that mechanism to make it possible to maintain a list of objects 
registered for callback and to notify all the objects on that list when an interesting event happens. 

In case you started reading at this point, this is an enhanced version of the program named Callback01 
. You should familiarize yourself with that program before trying to understand this program. 

A list of registered objects 

This program has the capability to create and maintain a list of objects that register for callback whereas 
the program named Callback01 could only remember a single object for callback. 

Multiple classes implement CallBack interface 

In addition, this program defines two different classes that implement the CallBack interface. Mixed 
objects of those two types are maintained on the list and notified at callback time. This is a subtle but very 
important point. It is not necessary that all the objects that are registered on a callback list be of the same 
class type, only that they all be of a class that implements the CallBack interface. 

The CallBack interface 

As before, this program defines a CallBack interface that establishes a new type of object, and also 
declares the interface to a method named callBack that is contained in all objects of classes that implement 
the interface. Because the callBack method is guaranteed to be contained in all of the objects on the list, 
it can be used to notify those objects whenever something interesting happens. 

The Teacher class 

The program defines a Teacher class that creates and maintains a list of objects of the CallBack 
interface type, and notifies those objects that something interesting has happened by calling the callBack 
method on each of the objects on the list. 

The size of the list is limited only to the largest Vector object that can be accommodated by the 
system. (See the Java documentation or my online tutorials for information about the Vector class.) 

The Student and Dog classes 

The program defines a class named Student that implements the CallBack interface. The program 
also defines a class named Dog that implements the CallBack interface as well. (Back in the description 
of the scenario, I promised you that missJones was going to have to deal with animals in the classroom. 
I’m glad I don’t have that problem.) 

Registration and notification of Student and Dog objects 

Objects of the Student and Dog classes can be registered on the list (of CallBack objects) 
maintained by an object of the Teacher class (because they both implement the CallBack interface) 
, and can be notified by the object of the Teacher class whenever something interesting happens. 

Addition and removal from the list 

Note that objects can be added to the list and then removed from the list. One object is first added and 
later removed for demonstration purposes. 

The callback mechanism 

As before, notification takes the form of calling the callBack method on each of the objects on the list. 

Behavior of the callBack methods 

The behavior of the callBack methods in the classes that implement the interface can be designed to 
do anything. In this case, to keep things simple, they just announce that they have been called. However, 
they make the announcement in slightly different ways. 

Text display statements 

This program contains display statements in the registration and notification methods for demonstration 
purposes only, and to allow us to track what is happening as the program runs. 

The controlling class 
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Finally, the program defines a controlling class named Callback02 that ties all the pieces together and 
exercises them. 

The program was originally tested using JDK 1.1.3 under Win95 and more recently tested using JDK 
1.7 under Windows Vista. 

The output from the program is shown following a discussion of the controlling class at the end of the 
next section. 

Interesting multicast code fragments 

Listing 6 (p. 1442) defines an interface that creates a new type and declares a generic method that can 
be used to call back any object that is of a class that implements the interface. There is nothing new here. 


Listing 6 . Define the CallBack interface. 


interface CallBack{ 
public void callBack(); 
3//end interface CallBack 


Table 4.6 


A class that can register and notify objects of type CallBack 

Next we need a class whose objects can maintain a registered list of objects of type CallBack (objects 
whose class implements the CallBack interface) and can notify all the objects on that list when 
something interesting happens. As before, we name this class Teacher 

The Teacher class 

The Teacher class has grown to the point that we will break it into parts and discuss them separately. 
There is quite a bit here that is new, due simply to the requirement for list processing. There is nothing 
new about the basic callback mechanism. 

An object of type Vector 

We start out by replacing the single instance variable of type CallBack by a reference to an object of 
type Vector . We will maintain our list in an object of type Vector 

Recall that a Vector object can only work with references to objects of type Object , so this will 
entail some down casting later. 

(Editor’s note: Sometime around JDK 1.5, a concept known as generics was released into Java, which 
eliminated the restriction to objects of type Object mentioned in the previous paragraph. However, this 
code has not been updated to take advantage of that capability.) 

The constructor for our new Teacher class, which is shown in Listing 7 (p. 1442) , instantiates the 
Vector object. 


Listing 7 . Define the Teacher class. 


class Teacher{ 
Vector objList; //list of objects of type CallBack 


Teacher (){//constructor 
objList = new Vector(); 
3//end constructor 
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Table 4.7 


The method named register 

Next we need a method to add objects to the list. We will synchronize it to protect against the possibility 
of two or more objects on different threads trying to register at the same time. 

Note that the references to the objects are received as type CallBack , which is the interface type, 
and stored as type Object , because the Vector class only accommodates references to objects of type 
Object . (See the earlier editor’s note.) Again, this will lead to some down casting requirements later. 


Listing 8 . Define the method named register. 


synchronized void register(CallBack obj){ 
this.objList.addElement (obj); 
System.out.println(obj + " added"); 
}//end register() 


Table 4.8 


The unRegister method 

To be general, we also need a method to remove objects from the list. Removal of an object from the 
list is a little more complicated than adding an object to the list due to the possibility of having two or 
more identical objects on the list. (We could, and possibly should, guard against that possibility when 
constructing the list.) 

Figure 1 (p. 1443) contains a partial excerpt from the JDK 1.1.3 documentation, which describes the 
removeElement method of the Vector class that we are using to accomplish this (three different 
methods are available to remove objects from a Vector ). 


Figure 1 . Documentation for the removeElement method. 


public final synchronized boolean removeFlement (Object obj) 


This method removes the first occurrence of the argument from this 
vector. Indices beyond that point are adjusted appropriately 


Parameters: obj - the component to be removed. 


Returns: true if the argument was a component of this vector; 
false otherwise. 


Table 4.9 
Registered object removal code 


Given that explanation, the code for removal of an object from the list is straightforward. The unReg- 
ister method is shown in Listing 9 (p. 1444) . 
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Listing 9 . The unRegister method. 


synchronized void unRegister(CallBack obj) { 
if (this.objList .removeElement (obj) ) 
System.out.println(obj + " removed") ; 
else System.out.println(obj + " not in the list"); 
}//end register () 


Table 4.10 


The callTheRoll method 

Now we need a method to notify all of the objects on the list that something interesting has happened. 

We will name this method callTheRoll to adhere to our classroom scenario. 
Maintain the integrity of the callback list 

One of the potential problems with this type of callback mechanism is that when the callback method is 
called on an object, that method might take a while to finish. 

(As an aside, when writing callback methods, if they do anything significant in terms of time, the code in 
the method should probably spawn another thread to do the actual work and return as quickly as possible.) 

This leads to the possibility that additional objects might attempt to register during that time interval. 
To protect against this, we make a copy of the state of the list object as it existed at the point in time that 
the decision was made to do the callbacks, and then perform the callbacks using that copy. That way, the 
original list is free to be updated as needed during this interval. 

So, we start out by creating a clone of the list. We also synchronize this process to prevent the list from 
being modified while we are creating the clone. 

Following this, we use a for loop to access all the objects on the list, and call the callBack method 
on those objects. (Actually, the list contains references to objects, and not the actual objects, so we are 
calling the method on the references. ) 

As promised earlier, we have to downcast from Object to CallBack to gain access to the callBack 
method in the objects. 


Listing 10 . Define the callTheRoll method. 


void callTheRol1(){ 
Vector tempList;//save a temporary copy of list here 


synchronized (this) { 
tempList = (Vector) objList.clone() ; 
}//end synchronized block 


for(int cnt = 0; cnt < tempList.size(); cnt++){ 
((CallBack)tempList.elementAt (cnt) ).callBack() ; 
}//end for loop 
}//end callTheRoll() 


Table 4.11 
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End of the class named Teacher 

That ends the discussion of the class named Teacher and brings us to the class named Student that 
implements the CallBack interface. This class hasn’t changed. As indicated earlier, this version of the 
program also has a class named Dog that implements the interface. These two classes are essentially the 
same. 

Define the class named Dog 

Because of their similarity, and because they are essentially the same as in the previous program, I will 
simply show the class named Dog with no further discussion. 


Listing 11 . Define the class named Dog. 


class Dog implements CallBack{ 
String name; //store name here for later ID 


Dog(String name) {//constructor 
this.name = name; //save the name to identify the obj 
}//end constructor 


//An object of the Teacher class will call this method 
// as the callback mechanism to notify an object of this 
// class that something interesting has happened. 


public void callBack(){//announce callBack 
System.out.println("Woof, Woof " + name); 


}//end overridden callBack() 
}//end class Dog 


Table 4.12 
The controlling class 


That brings us to the controlling class named Callback02 that ties all the pieces together and exercises 
them. This class is shown in Listing 12 (p. 1446) . 
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Listing 12 . Define the class named Callback02. 


class Callback02{ 
public static void main(String[] args){ 


//Instantiate Teacher object 
Teacher missJones = new Teacher(); 


//Instantiate some Student objects 


Student tom = new Student ("Tom"); 
Student sue = new Student ("Sue"); 
Student peg = new Student ("Peg"); 
Student bob = new Student ("Bob"); 
Student joe = new Student ("Joe"); 


//Instantiate some Dog objects. 
Dog spot = new Dog("Spot") ; 

Dog fido = new Dog("Fido") ; 

Dog brownie = new Dog("Brownie") ; 


//Register some Student and Dog objects with the 
// Teacher object. 
System.out.println("Register Tom"); 
missJones.register (tom); 
System.out.println("Register Spot"); 
missJones.register (spot); 
System.out.println("Register Sue"); 
missJones.register (sue) ; 
System.out.println("Register Fido"); 
missJones.register(fido) ; 
System.out.println("Register Peg"); 
missJones.register (peg) ; 
System.out.println("Register Bob"); 
missJones.register (bob); 
System.out.println("Register Brownie"); 
missJones.register (brownie) ; 


//Remove a Student object from the list. 
System.out.println("Remove Peg"); 
missJones.unRegister (peg) ; 


//Try to remove an object that is not on the list. 
System.out.println("Try to remove Joe"); 
missJones.unRegister (joe) ; 


System. out .println();//blank line 
//Cause the Teacher object to do a callBack on all 


// the objects on the list. 
missJones.callTheRoll (); 


}//end main() 
}//end class Callback02 
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Table 4.13 


Differences relative to Callback01 

This program differs from the previous program primarily in terms of the volume of Student and Dog 
objects to be instantiated and registered on the Teacher object. There are also a lot of display statements 
to help us keep track of what is going on. 

The ability to remove objects from the list is also illustrated. 

Call the roll 

Finally, the callback to the objects on the list is executed in Listing 12 (p. 1446) by calling the 
callTheRoll method on the Teacher object named missJones . The output from running this 
program is shown later. 

Mixed object types 

A subtle, but extremely important point is illustrated here. Student and Dog are different classes. 
Objects of both of those classes are registered on the single object of the Teacher class. The Teacher 
object doesn’t care that they are different, so long as they are all instantiated from classes that implement 
the CallBack interface. The register method will only accept object references of type CallBack 

Program output 

The output from running this program is shown in Figure 2 (p. 1447) . You can see the identification of 
each individual object as it is added to, or removed from the list. 


Figure 2 . Output from Callback02. 


Register Tom 
Student@1icc73e added 
Register Spot 
Dog@icc74e added 
Register Sue 
Student@1cc741 added 
Register Fido 
Dog@icc751 added 
Register Peg 
Student@1cc744 added 
Register Bob 
Student@1cc747 added 
Register Brownie 
Dog@icc754 added 
Remove Peg 
Student@1icc744 removed 
Try to remove Joe 
Student@icc74a not in the list 


Tom here 

Woof, Woof Spot 
Sue here 

Woof, Woof Fido 
Bob here 

Woof, Woof Brownie 


Table 4.14 
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Note that the attempt to remove Joe from the list was not successful because he was never registered in 
the first place. 

Finally, you see the output produced by calling callTheRoll which in turn calls the callBack method 
on each of the objects on the list. 

Note that Peg didn’t appear in the roll call because she was first added and then removed from the list 
before the roll call was taken. 

The sum and substance 

So there you have it, the sum and substance of multicast callbacks in Java. Obviously improvements 
could be made. You can see a couple of them in the remaining two tutorial lessons on callbacks that are 
published on my website. 

Multicast Program Listing 

A complete listing of the multicast program named Callback02 is provided in Listing 13 (p. 1449) . 
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Listing 13 . Complete listing of program named Callback02. 


/*File Callback02.java Copyright 1997, R.G.Baldwin 
The purpose of this program is to develop a callback 
capability using Interfaces. 


This is an enhanced version of the program named 
CallbackO1. You should familiarize yourself with 
the earlier program before getting into this program. 


This version has the added capability to create and 
maintain a list of objects that register for callback 
whereas the program named Callback0O1 could only remember 
a single object for callback. 


Tested using JDK 1.1.3 under Win95. 
The output from the program was: 


Register Tom 
Student@icc73e added 
Register Spot 
Dog@icc74e added 
Register Sue 
Student@1cc741 added 
Register Fido 
Dog@icc751 added 
Register Peg 
Student@1cc744 added 
Register Bob 
Student@1cc747 added 
Register Brownie 
Dog@icc754 added 
Remove Peg 
Student@1icc744 removed 
Try to remove Joe 
Student@icc74a not in the list 


Tom here 

Woof, Woof Spot 
Sue here 

Woof, Woof Fido 
Bob here 

Woof, Woof Brownie 


Note that Peg didn’t appear in the callBack list because 
she was first added to, and later removed from the list. 
FEO ak ak ak ak aK aK aK 3K 3K 3K 3K 3K 3K ak ak ak aK ak 3K 3K 3K 3K I I I II ICI II I I 3K 3K a a a K ÞK ÞK ÞK ÞK ÞK 34 34 34 / 
import java.util.*; 


//First we define an interface that will create a new type 


// and declare a generic method that can be used 
Re ilabl f tC <ht tent 111441/1.181> 

// callback any o ject that is SPRL PRS, 5 finat cas ofglcontent/co / 

// the interface. 


interface CallBack{ 
public void cal1Back() ; 
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Table 4.15 


4.2.2.5 Run the program 


I encourage you to copy the code from Listing 5 1° and Listing 13 (p. 1449) . Compile the code and execute 
it. Experiment with the code, making changes, and observing the results of your changes. Make certain that 
you can explain why your changes behave as they do. 


4.2.2.6 Summary 


In this module, you learned the fundamentals of callbacks using interfaces in Java. 


4.2.2.7 What’s next? 


In the next module, you will learn about something that goes by the name Delegation Event Model along 
with a few other names as well. 


4.2.2.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Callbacks - I 
e File: Java0077.htm 

e Published: 1998 

e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


lhttp://cnx.org/content /m44333/latest /../../Part%201/Java3102/Java3102.htm#Listing 5 
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4.2.3 Java OOP: Event Handling in JDK 1.1, A First Look, Delegation Event 
Model” 


4.2.3.1 Table of Contents 


e Preface (p. 1451) 
Viewing tip (p. 1451) 


x Figures (p. 1452) 
x Listings (p. 1452) 


e Introduction (p. 1452) 
e Design Goals of the JDK 1.1 Delegation Event Model (p. 1452) 
e Simplified Overview of the New Delegation Model (p. 1453) 


Sample Program (p. 1454) 
Interesting Code Fragments (p. 1454) 
Program Listing for Event08 (p. 1463) 


e More Detailed Overview of the Delegation Model (p. 1465) 


Event Hierarchy (p. 1465) 

Low-level vs. Semantic Events (p. 1466) 
Event Listeners (p. 1467) 

Event sources (p. 1467) 

Adapters (p. 1469) 

Filtering for Performance (p. 1469) 


e Another Sample Program (p. 1470) 


Event09 Interesting Code Fragments (p. 1473) 
Event09 Program Listing (p. 1477) 


Summary (p. 1479) 
Review (p. 1480) 

Run the program (p. 1480) 
Summary (p. 1479) 
Miscellaneous (p. 1480) 


4.2.3.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 
(Editor’s note: As you read this module, you will see that it was originally written in 1997. However, 
despite many improvements in Java since 1997, most of what was true in 1997 is still true in 2012.) 
This module makes several references to my website, which is located at 
http://www.dickbaldwin.com/toc.htm !7 . A copy of the original html version of this module is 
available here 18 . 


4.2.3.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


16This content is available online at <http://cnx.org/content /m44340/1.4/>. 
'Thttp://www.dickbaldwin.com/toc.htm 
18http://cnx.org/content /m45597 /latest /Java080.htm 
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4.2.3.2.1.1 Figures 


e Figure 1 (p. 1462) . Program output. 
e Figure 2 (p. 1473) . Screen output from Event09. 


4.2.3.2.1.2 Listings 


Listing 1 (p. 1454) . The main method for Event08. 


e 
) 
e Listing 2 (p. 1455) . Beginning of the constructor. 
e Listing 3 (p. 1455) . Instantiate two Listener objects. 
e Listing 4 (p. 1456) . Register the listener objects. 
e Listing 5 (p. 1456) . Make the Frame visible. 
e Listing 6 (p. 1457) . Beginning of the class named WProcl. 
e Listing 7 (p. 1457) . The windowClosing event handler. 
e Listing 8 (p. 1458) . Definition for the class named WProc2. 
e Listing 9 (p. 1464) . Complete listing for Event08. 
e Listing 10 (p. 1473) . Beginning of the class named Event09. 
e Listing 11 (p. 1474) . The class named MyFrame. 
e Listing 12 (p. 1475) . Beginning of the class named GUI. 
e Listing 13 (p. 1475) . Register two listener objects. 
e Listing 14 (p. 1476) . The class named MouseProc. 
e Listing 15 (p. 1476) . The class named WProcl. 
e Listing 16 (p. 1478) . Complete listing of Event09. 


4.2.3.3 Introduction 


This module provides a description of the Delegation Event Model as defined in JDK 1.1 along with sample 
programs that illustrate some aspects of the model. I describe how the event model maps to the AWT API. 

Much of this information was taken from the documentation released with the various versions of JDK 
1.1, and is the intellectual property of Sun Microsystems. The material is being reproduced here for the sole 
purpose of assisting students in learning how to use the event model. 


4.2.3.4 Design Goals of the JDK 1.1 Delegation Model 


According to Sun, the primary design goals of the event model in the AWT are the following: 


Design goals: 


e Simple and easy to learn 

e Support a clean separation between application and GUI code 

e Facilitate the creation of robust event handling code which is less error-prone (strong compile- 
time checking) 

e Flexible enough to enable varied application models for event flow and propagation 

e For visual tool builders, enable run-time discovery of both events that a component generates 
as well as the events it may observe 

e Support backward binary compatibility with the old model 


It will be up to you to decide if they have met their goals. 
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4.2.3.5 Simplified Overview of the New Delegation Model 


First, I will provide a simplified overview of the model including a sample program. Following that, I will 
embark on a detailed discussion of the model. Hopefully the simplified discussion and the sample program 
will help you to understand the material in the detailed discussion. 

Also, the earlier module on callbacks 1° should have given you considerable background to help you 
understand this material. If you are not familiar with the callback material, you should go back and review 
that material. 

Event sources and listeners 

Events are now organized into a hierarchy of event classes. The model makes use of event sources 
and event listeners 

An event source is an object that has the ability 


e to determine when an interesting event has occurred, and 
e to notify listener objects of the occurrence of the event. 


Although you as the programmer establish the framework for such notification, the actual notification takes 
place automatically behind the scenes. 
A listener object is an instance of a class (or instance of a subclass of a class) that 


e implements a specific listener interface. 


A number of listener interfaces are defined where each interface declares the methods appropriate for a 
specific class of events. Thus, there is natural pairing of classes of events and interface definitions. 

For example, there is a class of mouse events that includes most of the events normally associated with 
mouse action. There is a matching interface definition, which is used to define a listener class for those events 

(actually this is the one case where two interfaces are defined to match up with a single event class) . 
Registration 

A listener object can be registered on a source object to be notified of the occurrence of all events of 
the specific class for which the listener object is designed. 

Once a listener object is registered to be notified of those events, the occurrence of an event defined by 
the specified class will automatically call the matching method in the listener object. The code in the body 
of the method is designed by the programmer to perform the desired action when the event occurs. 

Multiple notification methods 

Some event classes (such as the mouse events, for example) involve a number of different possible event 
types (notification methods) . A listener class that implements the matching interface for that event class 
must implement or define (provide a body for) all the methods declared in the interface. 

Adapter classes 

An intermediate set of classes, known as Adapter classes, is provided to prevent this from becoming 
burdensome. These Adapter classes implement the listener interfaces, and define the matching interface 
methods with empty methods. 

A listener class can then be defined that extends the Adapter class instead of implementing the 
corresponding listener interface. With this approach, the listener class need only override those methods of 
interest since the requirement to define all of the interface methods has already been satisfied by the Adapter 
class. 

An example 

For example, in the sample program that follows, two different listener objects instantiated from two 
different listener classes are registered to receive all events involving the manipulation of a Frame object 
(opening, closing, minimizing, etc.) 

One of the listener classes implements the WindowListener interface and hence must define all six 
methods of that interface. 


'9http://cnx.org/content /m44333/latest /?collection=col11441/latest 
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The other listener class extends the WindowAdapter class, which in turn implements the 
WindowListener interface. The WindowAdapter class defines all six methods as empty methods. 
Thus, this listener class can get by with overriding only two of the six methods of the interface. 


4.2.3.5.1 Sample Program 


This program named Event08 (p. 1464) was designed for simplicity. In this program, the code in each of the 
methods is simple. In all cases but one, the code simply displays a message indicating that the method has 
been called. Obviously, in order for a program to be of much value, the body of code in the methods would 
have to be much more substantive, or at least would have to call other methods that are more substantive. 

This program illustrates the use of Event Sources , Event Listeners , and Adapters inthe Delegation 
Event Model . 

Description 
Briefly, this program (p. 1464) instantiates an object that creates a user interface consisting of a simple 
Frame object. This object is an Event Source that notifies two different Event Listener objects of 

Window events. 

One of the Listener objects implements the WindowListener interface and defines all of the 
methods declared in that interface. The other Listener object extends the Adapter class named 
Window Adapter 

As explained earlier, the purpose of Adapter classes (as used in this context) is to implement the 
Listener interfaces and to define all of the methods with empty methods. 

Classes that extend the Adapter classes can then selectively override only those methods of interest. 
This Listener object overrides only two of the methods. 

(Note that this program does not terminate and return control to the operating system. You must 
forcefully terminate it.) 

This program was originally tested using JDK 1.1.3 under Win95. More recently it was tested using JDK 
1.7 under Windows Vista. 

The output produced by running the program is presented later in this module. 


4.2.3.5.2 Interesting Code Fragments 


Listing 1 (p. 1454) shows the main method of the controlling class that instantiates a Graphical User 
Interface (GUI) object. There are more compact (and more cryptic) ways to accomplish this objective, but 
for the time being, in order to achieve clarity, I will use this approach. 


Listing 1 . The main method for Event08. 


public class Event08 {//controlling class 
public static void main(String[] args){ 
GUI gui = new GUI();//instantiate a GUInterface object 
}//end main 
3//end class Event08 


Table 4.16 


The GUI class is rather long, so I will break it up and discuss it in parts. 
This class is used 


e to instantiate and display a user interface object, 
e to instantiate two Listener objects, and 
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e to register those two objects for notification whenever a Window event occurs. 


The class begins by defining its own constructor. The first interesting code in the constructor is the code to 
instantiate an object of type Frame , set its size, and give it a title, as shown in Listing 2 (p. 1455) . 


Listing 2 . Beginning of the constructor. 


class GUI{ 

public GUI(Q {//constructor 
//Create a new Frame object 
Frame displayWindow = new Frame(); 
displayWindow. setSize (300, 200) ; 
displayWindow.setTitle("Copyright 1997, R.G.Baldwin") ; 


Table 4.17 


What is a Frame? 
The JDK documentation describes a Frame as follows: 


Description of a Frame: A Frame is a top-level window with a title and a border. The 
default layout fora frame is BorderLayout . (We will learn more about layout managers later) 


Frames are capable of generating the following types of window events: 


e WindowOpened 

e WindowClosing 

e WindowClosed 

e WindowlIconified 

e WindowDeiconified 
e Window Activated 

e WindowDeactivated. 


Stated differently, a Frame object is the type of GUI object that we might refer to as a window or a 
form in a typical GUI environment. 

Instantiate two Listener objects 

Listing 3 (p. 1455) instantiates two Listener objects that will process Window events. 

The class definitions, named Wprocl and Wproc2_, for these two classes will follow the discussion 
of the GUI class. 

(Note that I am passing a reference to the Frame object to the constructor for one of these 

classes. There is a better (and more cryptic) way to achieve the same objective without the need to pass the 
reference. Again, since this program was designed for clarity, I am doing it the obvious way.) 


Listing 3 . Instantiate two Listener objects. 


continued on next page 
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WProci winProcCmdi = new WProci(displayWindow) ; 
WProc2 winProcCmd2 = new WProc2(); 


Table 4.18 


Register the listener objects 

The code in Listing 4 (p. 1456) is extremely important. This is the code by which we register the listener 
objects for notification of Window events where the Frame object named displayWindow is the 
source of the events. 

Pay close attention to the syntax of these two statements, because you will be using this syntax often. 
In subsequent modules, we will dig deeper into the Delegation Event Model and I will teach you what is 
going on behind the scenes when you execute statements of this sort. 


Listing 4 . Register the listener objects . 


displayWindow.addWindowListener (winProcCmd1) ; 
displayWindow. addWindowListener (winProcCmd2) ; 


Table 4.19 


Interpretation 

The interpretation of the code in Listing 4 (p. 1456) is that the two listener objects named win- 
ProcCmd1 and winProcCmd2 are added to a list of listener objects that are to be automatically 
notified 


e whenever an event of the WindowEvent class occurs 
e with respect to the Frame object named displayWindow 


These listener objects are notified by calling the methods in the objects that match the specific type of the 
event (open window, close window, closing window, minimize window, etc.) 

Make the Frame visible 

We wrap up the definition of our GUI class with the statement shown in Listing 5 (p. 1456) that 
causes the Frame object to become visible on the screen. Note that this statement also causes the 
windowActivated and windowOpened events to be generated. (Current jargon would say that those 
events are "fired".) 


Listing 5 . Make the Frame visible. 


displayWindow.setVisible(true) ; 
}//end constructor 
}//end GUI class definition 


Table 4.20 
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Code for the Listener objects 

At this point, we have examined the code that will create a Frame object and display it on the screen. 
Also we have examined the code that registers two Listener objects on the Frame object. However, 
at this point, the program cannot be compiled because the classes from which the two Listener objects 
are to be instantiated have not yet been defined. That will be our next assignment. 

Beginning of the class named WProcl 

Listing 6 (p. 1457) begins the definition of the classes that can be used to instantiate Listener objects. 

The first class definition that we will look at implements the WindowListener interface. This 
requires that all the methods declared in the interface be defined in this class. This class defines all of the 
methods. Each of the methods displays a descriptive message whenever it is called. 

I will begin the discussion with the constructor as shown in Listing 6 (p. 1457) . 


Listing 6 . Beginning of the class named WProcl. 


class WProci implements WindowListener{ 
Frame displayWindowRef ; 


WProci(Frame windowIn){//constructor 
this.displayWindowRef = windowIn; 
3//end constructor 


Table 4.21 


(Note that the constructor for this class requires a reference to the Source object to be passed as a 
parameter. As mentioned earlier, this is not the preferred way to accomplish our objective, but it is the most 
straightforward and easy to understand. That is why I elected to use it here. The code in the constructor 
saves a reference tothe Source object in an instance variable named displayWindowRef _ .) 

Implementing the WindowListener interface 

It is important to note that this class implements the WindowListener interface. This means that 
it must define all of the methods that are declared in that interface. 

If you examine the complete program listing that is presented later, you will see that there is one method 
definition in this class definition for each of the methods that are declared in the WindowListener 
interface. 

The definition of all the interface methods are very similar, so I am not going to show all of them here. 
However, I will show the one that requires the reference to the source object that was discussed above, which 
is the most complicated one of the set. 

The windowClosing event handler 

The methods that are declared in the listener interfaces are often referred to as event handler methods 
or event handlers for short. The windowClosing event handler method is shown in Listing 7 (p. 1457) 
. As you can see, this method starts out by displaying a message. Then it calls the dispose method on 
the Frame object. That is the reason that a reference to the Frame object was required to be passed 
in as a parameter. 

Calling the dispose method causes a WindowClosed event to be fired. (As far as I know, that is 
the only way to cause a WindowClosed event to be fired.) 
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Listing 7 . The windowClosing event handler. 


public void windowClosing(WindowEvent e){ 
System.out.println("WProci windowClosing test msg"); 
displayWindowRef .dispose() ;//generate WindowClosed 

}//end windowClosing() 


Table 4.22 


The class named WProc2 
The class definition shown in Listing 8 (p. 1458) does not implement the WindowListener interface. 
Instead, it extends the WindowAdapter class. Therefore, it can selectively override only those methods 
that are of interest. 
In this case, only two of the methods of the WindowListener interface are overridden. These overridden 
methods display a message whenever they are called. 


Listing 8 . Definition for the class named WProc2. 


class WProc2 extends WindowAdapter{ 


public void windowIconified(WindowEvent e){ 
System. out. print1n( 
"xkxkkkkkk WProc2 windowIconified test msg"); 
3//end windowIconified() 


public void windowDeiconified(WindowEvent e){ 
System. out. print1n( 
"xkkkkkkk WProc2 windowDeiconified test msg"); 
3//end windowDeiconified() 


}//end class WProc2 


Table 4.23 


Program output 


Figure 1 (p. 1462) shows a sample output from this program. The small Frame in the upper-left 
corner is the graphic Frame object. A command-line screen with text output is shown immediately below 
the Frame. 
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windowhctivated test msg 
windowOpened test msg 

WProci windowDeactivated test msg 

Proci windowfActivated test msg 
windowDeactivated test msg 
windowAhctivated test msg 
windowlconified test msg 

peeeeeeec YProc2 windowlconified test msg 

Proci windowDeactivated test msg 

Proci windowDeiconified test msg 

peace YProc2 windowDeiconified test msg 

Proci windowActivated test msg 

WProci windowDeactivated test msg 
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M:\Baldwin\AA-School\Connexions\Java OOP\ITSE231?7\Essence of OOP Java0080\Code em 


windowhctivated test msg 
windowOpened test msg 
windowDeactivated test msg 
windowAhctivated test msg 
windowDeactivated test msg 
windowAhctivated test msg 
windowlconified test msg 

peeeeeeec YProc2 windowlconified test msg 

Proci windowDeactivated test msg 

Proci windowDeiconified test msg 

peace YProc2 windowDeiconified test msg 

Proci windowActivated test msg 

WProci windowDeactivated test msg 
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windowhctivated test msg 
windowOpened test msg 

WProci windowDeactivated test msg 

Proci windowfActivated test msg 
windowDeactivated test msg 
windowAhctivated test msg 
windowlconified test msg 

peeeeeeec YProc2 windowlconified test msg 

Proci windowDeactivated test msg 

Proci windowDeiconified test msg 

peace YProc2 windowDeiconified test msg 

Proci windowActivated test msg 

WProci windowDeactivated test msg 
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Figure 1 . Program output. 


-x 


M:\Baldwin\fAA-School\Connexions\Java OOP\ITSE231?7\Essence of ee 
cho off a 
Proci windowActivated test msg 

windowOpened test msg 

windowDeactivated test msg 

windowActivated test msg 

windowDeactivated test msg 

windowActivated test msg 

windowlconified test msg 
peeeeeec YWProc2 windowlconified test msg 
WProci windowDeactivated test msg 


Proci windowDeiconified test msg 
pence YProc2 windowDeiconified test msg 
Proci windowActivated test msg 

WProci windowDeactivated test msg 


Table 4.24 


The text output 

The output from running this program for a variety of user actions is shown below. You should be able 
to correlate the messages shown in the output with the event handler methods discussed above and the user 
actions that caused those event handlers to be called. 


Text output from Event08 
This program was tested using JDK 1.1.3 under Win95. 


When executed, this application places a simple empty 
Frame object on the screen. 


Starting the program produces the following output: 
WProci windowActivated test msg 


Wproci windowOpened test msg 


Pressing the minimize button on the Frame produces the 
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following output: 


WProci windowIconified test msg 
xxAKKKAK WProc2 windowIconified test msg 
WProci windowDeactivated test msg 


Restoring the Frame after minimization produces the 
following output: 


WProci windowActivated test msg 

WProci windowDeiconified test msg 

xxAKKKAK WProc2 windowDeiconified test msg 
WProci windowActivated test msg 


Closing the Frame by pressing the X-icon in the upper 
right of the Frame produces the following output. 


WProci windowClosing test msg 
WProci windowDeactivated test msg 
WProci windowClosed test msg 


4.2.3.5.3 Program Listing for Event08 


A complete listing of the program is provided in Listing 9 (p. 1464) . You can view the code that was not 
shown above in this listing. 
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Listing 9 . Complete listing for Event08. 


/*File Event08.java Copyright 1997, R.G.Baldwin 
Rev 01/10/98 


Illustrates the use of Event Sources, Event Listeners, and 
Adapters in the Delegation Event Model. 


Briefly, this application instantiates an object that 
creates a user interface consisting of a simple Frame 
object. This object is an Event Source that notifies two 
different Event Listener objects of Window events. 


One of the Listener objects implements the WindowListener 
interface and overrides all of the methods declared in 
that interface. 


The other Listener object extends the Adapter class named 
WindowAdapter. The purpose of Adapter classes is to 
implement the Listener interfaces and to define all of 
the methods with empty methods. Classes that extend the 
Adapter classes can then selectively override only those 
methods of interest. This Listener object overrides only 
two of the methods. 


Note that this application does not terminate and return 
control to the operating system. You must forcefully 
terminate it. 


This program was tested using JDK 1.1.3 under Win95. 


When executed, this application places a simple empty 
Frame object on the screen. 


Starting the program produces the following output: 
WProci windowActivated test msg 
Wproci windowOpened test msg 


Pressing the minimize button on the Frame produces the 
following output: 


WProci windowIconified test msg 
xkKKKKK WProc2 windowIconified test msg 
WProci windowDeactivated test msg 


Restoring the Frame after minimization produces the 
following output: 


WProci windowActivated test msg 
WProci windowDeiconified test msg 
akKKKKKK WProc2 windowDeiconified test msg 
WProci windowActivated test ms 
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Table 4.25 


4.2.3.6 More Detailed Overview of the Delegation Model 


JDK 1.1 encapsulates events in a class hierarchy with the root class named java.util.EventObject 

The propagation of an event from a Source object toa Listener object involves calling a method 
on the Listener object and passing an object that contains encapsulated information about the event. 
Note that each event class may include more than one actual type of event (as determined by the methods 
declared in the listener interface) . 

An event listener 

A Listener object is an instance of a class that implements a specific EventListener interface 
extended from the generic java.util.EventListener 

An EventListener interface declares one or more methods that must be defined in the Listener 
class. Those methods are called by the event source in response to each specific event type handled by the 
interface. 

The calling of these methods is the mechanism by which the Source notifies the Listener of the 
occurrence of an event of a specific type. 

An event source 

An Event Source is an object that "originates" or "fires" events by calling the methods of one or more 
Listener objects. The Source maintains a list containing a reference to all of the Listener objects 
that have registered to be notified of events of that class. 

Registration of event listener objects 

The programmer causes Listener objects to be added to this list using add (EventType) Listener 
method calls. 

Placing references to Listener objects on the list is often referred to as registering specific Listeners 
to receive notification of specific events. 

Notifying listener objects 

Once the list is populated ( Listener objects are registered) , the Source object uses that list 
to notify each Listener of the occurrence of an event of the specified type without further effort on the 
part of the programmer. 

Event sources and listeners 

The Event Source is often a GUI component and the Listener is commonly an object of a class 
that implements the appropriate listener interface, but this is not a requirement. For example we will learn 
later how to cause a program to generate events without any physical involvement on the part of a user and 
a GUI component. 

The Listener object could also be another AWT component that implements one or more Listener 
interfaces for the purpose of hooking GUI objects up to each other. 


4.2.3.6.1 Event Hierarchy 


As mentioned earlier, each specific event type is a member of a class of event types and these classes form a 
hierarchy of event classes. 

Since a single event class may be used to represent more than one event type (i.e. MouseEvent 
represents mouse up, mouse down, mouse drag, mouse move, etc.) , some event classes may also contain 
an "id" (unique within that class) that maps to its specific event types. 

Setter and getter methods 

There are no public fields in the event classes. Rather the data in the event is encapsulated and available 
only through the use of appropriate setter and getter methods. 

The setter methods only exist for attributes on an event that can be modified by a listener. If you 
continue with your studies in Java, you will learn that the setter and getter methods match a design 
pattern for Java Beans. 
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A concrete set of event classes is defined by the AWT. In addition, programmers may define their own 
event types by subclassing either java.util.EventObject or one of the AWT event classes. 


4.2.3.6.2 Low-level vs. Semantic Events 
The AWT provides two conceptual types of events: 


e low-level events 
e semantic events 


Low-level events 
A low-level event is one that represents a low-level input or window-system occurrence on a visual 
component on the screen. As of February 1997, JDK 1.1 defined the following low-level event classes: 


Low-level event classes 


e java.util. EventObject 
- java.awt.AWTEvent 
xjava.awt.event.ComponentEvent (component resized, moved,etc.) 
-java.awt.event.FocusEvent (component got focus, lost focus) 
-java.awt.event .Input Event 
-java.awt.event.KeyEvent (component got key-press, key-release,etc.) 
-java.awt.event.MouseEvent (component got mouse-down, mouse-move,etc.) 
-java.awt.event.ContainerEvent 
-java.awt.event. WindowEvent 


As indicated earlier, some of the event classes encompass several different event types. Generally, there are 
corresponding Listener interfaces for each of the event classes, and corresponding interface methods for 
each of the different event types in each event class. 

Semantic events 

Semantic events are defined at a higher-level to encapsulate the semantics of a user interface component’s 
model. As of February 1997, the semantic event classes defined by the JDK 1.1 version of the AWT were as 
follows: 


Semantic event classes 


e java.util.EventObject 


- java.awt.AWTEvent 
xjava.awt.event.ActionEvent ("do a command") 
xjava.awt.event.AdjustmentEvent ("value was adjusted") 
xjava.awt.event.ItemEvent ("item state has changed") 
xjava.awt.event.TextEvent ("the value of the text object changed") 


A more general event type 

The semantic events are not tied to specific screen-based component classes, but may apply across 
a set of components that implement a similar semantic model. For example, a Button object will fire 
an "action" event when it is pressed and a List object will fire an "action" event when an item is 
double-clicked. 

Not tied to user actions 

Even though the above discussion seems to tie these event classes to user actions on screen components 
(because that is the norm) , you need to remember that there is nothing to prevent you from having your 
code generate events of these types completely independent of such user actions. For example, you can easily 
cause an ActionEvent to be generated and attributed to some component whenever a software timer 
expires. We will learn how to do this sort of thing in subsequent modules. 
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4.2.3.6.3 Event Listeners 


An EventListener interface will typically have a separate method for each distinct event type that the event 
class represents. For example, the FocusEventListener interface defines two methods, focusGained 
and focusLost_, one for each event type that the FocusEvent class represents. 

Low-level listener interfaces 

As of February 1997, the low-level listener interfaces defined by the JDK 1.1 version of the AWT were 
as follows: 


Low-level listener interfaces 


e java.util_EventListener 


- java.awt.event.ComponentListener 

- java.awt.event.ContainerListener 

- java.awt.event.FocusListener 

- java.awt.event.KeyListener 

- java.awt.event.MouseListener 

- java.awt.event.MouseMotionListener 
- java.awt.event.WindowListener 


If you match this up with the previous list of low-level event classes, you will see that there is a listener 
interface defined for each of the "leaf" classes in the hierarchy of event classes. (In fact, there are two 
different listener interfaces defined for the _MouseEvent class. This will be discussed further at the 
appropriate point in time.) 

Semantic listener interfaces 

As of February 1997, the semantic listener interfaces defined by the AWT were as follows: 


Semantic event listener interfaces 


e java.util.EventListener 


- java.awt.event.ActionListener 

- java.awt.event.Adjustment Listener 
- java.awt.event.ItemListener 

- java.awt.event.Text Listener 


There is a one-to-one correspondence between semantic listener interfaces and semantic event classes. 


4.2.3.6.4 Event Sources 


All AWT event sources support a multicast model for listeners. This means that multiple listeners can be 
added and removed from a single source. In other words, notification of the occurrence of the same event 
can be sent to one or more listener objects. 

According to JDK 1.1 documentation, 

"The API makes no guarantees about the order in which the events are delivered to a set of registered 
listeners for a given event on a given source. Additionally, any event which allows its properties to be 
modified (via setXXX() methods) will be explicitly copied such that each listener receives a replica of the 
original event. If the order in which events are delivered to listeners is a factor for your program, you should 
chain the listeners off a single listener which is registered on the source (the fact that the event data is 
encapsulated in a single object makes propagating the event extremely simple)." 

Low-level event sources 

As before, a distinction is drawn between low-level and semantic events. The source for low-level 
events will often be one of the visual component classes ( Button , Scrollbar , etc.) because 
the event is bound to the actual component on the screen (but counterfeit events can be generated) . 

As of February 1997, JDK 1.1 defined low-level listeners on the following components. 
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Low-level listener components 


e java.awt.Component 


- addComponentListener(Component Listener 1) 

- addFocusListener(FocusListener 1) 

- addKeyListener(KeyListener 1) 

- addMouseListener(MouseListener 1) 

- addMouseMotionListener(MouseMotionListener 1) 


e java.awt.Container 


- addContainerListener(ContainerListener 1) 


e java.awt.Dialog 


- addWindowListener(WindowListener 1) 


e java.awt.Frame 


- addWindowListener(WindowListener 1) 


Must take inheritance into account 

To determine all of the specific event types that can be communicated from a source object to a listener 
object, you must take inheritance into account. 

For example, as you will see in a sample program later in this module, a source object can detect mouse 
events ona Frame object and notify a MouseListener object of the occurrence of those events even 
though the above list does not show a MouseListener ona Frame . This is possible because a Frame 
object indirectly extends the Component class, and MouseListener is defined for the Component 


class. 
Semantic event sources 


As of February 1997, JDK 1.1 defined the following semantic listeners for AWT components: 


Semantic listener components 


e java.awt.Button 


- addActionListener(ActionListener 1) 


e java.awt.Choice (implements java.awt.ItemSelectable) 


- addItemListener(ItemListener 1) 


e java.awt.Checkbox (implements java.awt.ItemSelectable) 


- addItemListener(ItemListener 1) 


e java.awt.CheckboxMenultem (implements java.awt.ItemSelectable) 


- addItemListener(ItemListener 1) 


e java.awt.List (implements java.awt.ItemSelectable) 


- addActionListener(ActionListener 1) 
- addItemListener(ItemListener 1) 


e java.awt.Menultem 


- addActionListener(ActionListener 1) 


e java.awt.Scrollbar (implements java.awt. Adjustable) 


- addAdjustmentListener(AdjustmentListener 1) 


e java.awt.TextArea 


- addTextListener(TextListener 1) 
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e java.awt.TextField 


addActionListener( ActionListener 1) 
- addTextListener(TextListener 1) 


The nature of semantic events 

The nature of semantic event types can be inferred by noticing that in some cases, different types of 
components support the same type of semantic event. For example, four different types of components are 
identified in the above list that can register and service action events 

A single ActionEvent listener object could be registered to be notified of action events on one or more 
components of all of these types. Of course, it would then be necessary for the code in that event handler 
to determine which source was responsible for generating the event if such identification is important. 

An important difference between low level events and semantic events has to do with where the classes 
that define those events plug into the class hierarchy. Low level events plug in further down the class 
hierarchy and inherit more methods that can be used to process the event object than is the case with 
semantic events. 


4.2.3.6.5 Adapters 


Many EventListener interfaces are designed to listen to multiple event classes. For example, the 
MouseListener listens to mouse-down, mouse-up, mouse-enter , etc. The MouseListener interface 
declares a method for each of these subtypes. 

When you implement an interface, you are required to define all of the methods that are declared in the 
interface, even if you define them with empty methods. In some cases, the requirement to define all the 
methods declared in an interface can be burdensome. 

For this reason (and possibly for some other reasons as well), the AWT provides a set of abstract adapter 
classes that match up with the defined interfaces. Each adapter class implements one interface and defines 
all of the methods declared by that interface as empty methods, thus satisfying the requirement to define all 
of the methods. 

You can then define your listener classes by extending the adapter classes instead of implementing the 
listener interfaces.. This allows you the freedom to override only those methods of the interface that interest 
you. 

Again, recall that the methods declared within an interface correspond to the individual event types 
contained within a corresponding event class, and the Source object notifies your Listener object of 
the occurrence of an event of a specific type by calling your interface method. 

As of February 1997, the Adapter classes provided by the JDK 1.1 version of the AWT were as follows: 


Adapter classes 


e java.awt.event. Component Adapter 

e java.awt-.event.FocusAdapter 

e java.awt-.event.Key Adapter 

e java.awt.event.MouseAdapter 

e java.awt.event.MouseMotion Adapter 
e java.awt.event. WindowAdapter 


4.2.3.6.6 Filtering for Performance 


Since listeners are registered to handle specific event types, they are notified only of the occurrence of those 
event types and are not required to deal with event types for which they are not registered. That was not 
the case in JDK 1.0.2 where all events passed through a common set of event handler code whether those 
events were of interest or not. 
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This filtering of events should improve performance, especially with high frequency events, such as mouse- 
moves. 
According to the JDK 1.1 documentation, 
"All platforms should see some performance improvement from reduced event traffic, but the Solaris 
implementation should gain exceptional improvement since it’s a network-based window system." 


4.2.3.7 Another Sample Program 


The previous program did not terminate when the user closed the window. The following program does 
terminate when the user closes the window by executing a System.exit(0) statement in the closing 
event handler.. 

The previous program implemented an Event Source object that notified two different Listener 
objects of the occurrence of an event in the Window lass. 

The following program implements an Event Source object that notifies one Listener object of the 
occurrence of an event in the Window class and notifies another Listener object of the occurrence of 
an event in the Mouse class. 

This program implements a MouseListener interface ona Frame object, which is possible because 
the Frame class indirectly extends the Component class, and addMouseListener is defined on the 

Component. class. 
Program output 

If you compile and execute this program, whenever you click the mouse inside the Frame , you should 
see the coordinates of the mouse pointer displayed above the mouse pointer as shown in Figure 2 (p. 1473) 
below. 


+ Copyright 1997, R... MEX] 
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Figure 2 . Screen output from Event09. 


= Copyright 1997, R... |. [Cp 


Table 4.26 


4.2.3.7.1 Event09 Interesting Code Fragments 
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The first interesting code fragment is the definition of the controlling class. The main method for this 
class instantiates a GUI object where all the real work is done. Listing 10 (p. 1473) shows the class named 


Event09 including the main method. 


Listing 10 . Beginning of the class named Event09. 


public class Evento9 { 
public static void main(String[] args){ 
GUI gui = new GUI();//instantiate a GUI 
}//end main 
}//end class Event09 


Table 4.27 


The paint and repaint methods 
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Various tutorial lessons on my website discuss the relationship between the paint method and the 
repaint method. If you are unfamiliar with that relationship, you may need to go back and review it. 

In this program, we are going to override the paint method to make it possible for us to draw coordinate 
information on the screen. 

In order to override the paint method, we need to extend the Frame class. By doing so, we can define 
our own version of the Frame class where we have the ability to override the paint method. Listing 11 
(p. 1474) extends Frame into MyFrame and overrides the paint method. 


Listing 11 . The class named MyFrame. 


class MyFrame extends Frame{ 
int clickX; 
int clickY; 


public void paint (Graphics g){ 
g.drawString( 
"" + clickX + ", " + clickY, clickX, clickY); 
}//end paint () 
}//end class MyFrame 


Table 4.28 


Storing and using coordinate information 

For future reference, note that this class contains a couple of instance variables that will be used to store 
X and Y coordinate information. 

The overridden version of the paint method causes the coordinate values stored in clickX and 
clickY to be displayed in the client area of the Frame object at the location specified by the values of 
those two instance variables. 

The drawString method 

The drawString method requires three parameters. The first parameter is the string to draw on the 
screen. The next two parameters are the coordinate values in pixels where the string is to be drawn. 

As is normally the case, coordinate values are specified relative to the upper left corner of the object 
being drawn on. The above overridden version of the drawString method converts the coordinate values 
toa String , and draws that string at the location specified by the coordinate values. 

The class named GUI 

As before, the GUI class is rather long. Therefore, I will break it up and discuss it in fragments. 

The first fragment that I will discuss is the constructor that begins in Listing 12 (p. 1475) . The important 
thing to note here is that we are not instantiating an object of type Frame . Instead, we are instantiating 
an object of type MyFrame that is our extended version of Frame 

Other than that, you should be familiar with the code in Listing 12 (p. 1475) by now. 


Listing 12 . Beginning of the class named GUI. 


continued on next page 
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class GUI { 

public GUI( {//constructor 
//Create a new Frame object, set size, title, etc. 
MyFrame displayWindow = new MyFrame(); 
displayWindow. setSize (300, 300); 
displayWindow.setTitle("Copyright 1997, R.G.Baldwin") ; 
displayWindow.setVisible(true) ; 


Table 4.29 


Register two listener objects 

Listing 13 (p. 1475) uses standard syntax to instantiate and register two different Listener objects on 
the MyFrame object. The first is a WindowListener object that will terminate the program when 
the user closes the MyFrame object. 

The second isa MouseListener object that will process mouse events on the MyFrame object. 

It is typical to register listener objects as anonymous objects in those cases where a specific reference 
to the listener object is not otherwise needed. (Don’t confuse anonymous objects with anonymous classes, 
which is the topic of a future module.) 


Listing 13 . Register two listener objects. 


displayWindow.addWindowListener (new WProci()); 
displayWindow. addMouseListener ( 
new MouseProc(displayWindow) ) ; 
}//end constructor 
}//end class GUI definition 


Table 4.30 


Listing 13 (p. 1475) ends the definition of the GUI class. That brings us to the definition of Listener 

classes for the WindowListener and the MouseListener interfaces. 
The MouseListener class 

I will begin with the MouseListener class named MouseProc (p. 1476) . This class extends the 
MouseAdapter class and does not directly implement the MouseListener interface. This saves us the 
trouble of having to create empty methods for event types that we are not interested in. 

Objects of this class that are registered on the Source will be notified whenever a mousePressed() 
event occurs on the Source. This will cause the mousePressed method to be called. The mouse- 
Pressed method will display the coordinates of the mouse pointer when the mouse is pressed on the source 
object. 

The mousePressed method 

When the mousePressed method is called, it receives a reference to an object of type MouseEvent 
as a parameter. Different types of events encapsulate different types of information in the object that is 
passed as a parameter to the event handler method. This particular object contains a variety of information, 
including the coordinates of the mouse pointer when the event occurred. 

Extract and save mouse pointer coordinates 

The code in the overridden mousePressed() method extracts that coordinate information from the 

object and stores it in the instance variables named clickX and clickY of the Source object. 
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Then it calls the repaint method on the source object, causing the source object to be repainted on 
the screen. This in turn causes the overridden paint method discussed earlier to be called, which displays 
the new coordinate information on the screen in the proper location. 

The class named MouseProc 

Listing 14 (p. 1476) contain the definition of the MouseProc class, including the overridden mouse- 

Pressed method. 


Listing 14 . The class named MouseProc. 


class MouseProc extends MouseAdapter{ 
MyFrame refToWin; //save a reference to the source here 


MouseProc(MyFrame inWin){//constructor 
refToWin = inWin;//save ref to window 
}//end constructor 


public void mousePressed(MouseEvent e){ 
refToWin.clickX = e.getx(); 
refToWin.clickY = e.getY(); 


refToWin.repaint (); 
}//end mousePressed() 
}//end class MouseProc 


Table 4.31 


The class named WProcl 

Finally, we come to the class that is used to instantiate a listener object that terminates the program 
when the user closes the MyFrame object (see Listing 15 (p. 1476) ) . You will be seeing this class over 
and over as you review the sample programs in upcoming modules. 


Listing 15 . The class named WProcl. 


class WProci extends WindowAdapter{ 
public void windowClosing(WindowEvent e){ 
System. exit (0) ; 
}//end windowClosing() 
}//end class WProc1 


Table 4.32 


The WProc1 class extends the WindowAdapter class and overrides the method named window- 
Closing 

The windowClosing method is called when the user clicks the red X in the upper right corner of 
Figure 2 (p. 1473) .That causes the static exit method of the System class to be called, which in turn 
causes the program to terminate. 
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4.2.3.7.2 Event09 Program Listing 


A complete listing of the program named Event09 is provided in Listing 16 (p. 1478) . 
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Listing 16 . Complete listing of Event09. 


/*File Event09.java Copyright 1997, R.G.Baldwin 
This program is designed to be compiled under JDK 1.1 


Illustrates the use of Event Sources, Event Listeners, and 
Adapters in the Delegation Event Model. 


This program instantiates a Listener object to process 
mouse events. When a mouse press occurs in a Frame object, 
the program gets the coordinates and then displays those 
coordinates near the point of the mouse press. 


This program was tested using JDK 1.1.3 under Wing5. 

FE AG EEE EEEE EEEE E EE EEEE AI I I I I kk I A 1 2K 21 EEE E a 4 2k 2 ak ak kak / 
import java.awt.*; 

import java.awt.event.*; 


public class Evento9g { 
public static void main(String[] args){ 
GUI gui = new GUI();//instantiate a GUI 
}//end main 
3//end class Event09 


//Subclass Frame in order to override the paint method. 
class MyFrame extends Framef 

int clickX; 

int clickY; 


public void paint (Graphics g){ 
g.drawString( 
"" + clickX + ", " + clickY, clickX, clickY); 
}//end paint () 
}//end class MyFrame 


//The following class is used to instantiate a 

// graphical user interface object. 

class GUI { 

public GUI( {//constructor 

//Create a new Frame object, set size, title, etc. 
MyFrame displayWindow = new MyFrame(); 
displayWindow. setSize (300, 300) ; 
displayWindow.setTitle("Copyright 1997, R.G.Baldwin") ; 
displayWindow.setVisible(true) ; 


//Instantiate and register an anonymous Listener 

// object that will terminate the program when the 

// user closes the Frame. 

displayWindow.addWindowListener (new WProc1()); 
//Instantiate aud register an anonymous Tisteney Onen coN141/1181> 
// object that will process mouse events to determine 

// and display the coordinates when the user presses 

// the mouse button in the client area of the Frame. 
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Table 4.33 


4.2.3.8 Summary 


In the simplest case, you can handle events as defined in JDK 1.1 with the following steps. 


4.2.3.8.1 Step 1 


Define a Listener class for a specific class of events by either implementing the listener interface that 
matches that class of events, or extending the corresponding adapter class. 


4.2.3.8.2 Step 2 


Define or override the interface methods in the Listener class, for each specific event type in the event 
class, to implement the desired behavior of the program upon occurrence of an event. 

If you implement the listener interface, you must define all interface methods. If instead you extend 
the corresponding adapter class, you can override only those methods that tie to event types of interest. 


4.2.3.8.3 Step 3 


Write code that instantiates objects of the Source class andthe Listener class and registers the listener 
object on the source object for notification of events generated by the source object. 

You can use code such as the following for registration: 

displayWindow. addMouseListener (mouseProcCmd); 

In this code fragment, 


e display Window is a reference to the object that fires the event, 

e mouseProcCmd is the name of a reference to the listener object, and 

e addMouseListener is the method that registers the listener object to receive mouse events from 
the object referred to by displayWindow 


This statement will cause the object named mouseProcCmd to be notified of all events generated by 
displayWindow which are part of the class of mouse events. 

The notification takes the form of calling a method in the mouseProcCmd object where there must 
be a corresponding method for each specific event type in the class of mouse events. (Some of those 
methods can be empty shells if you have no interest in some of the event types). 


4.2.3.8.3.1 Comments 


As mentioned earlier, this is the procedure for the simplest cases. It is possible to make the situation more 
complicated. For example, a single Source object can be required to notify two or more different Listener 
objects of the occurrence of an event of the same class on a single screen object. 

The Source object can also be required to notify two or more different Listener objects of the 
occurrence of events of two different classes on a single screen object. 

A single Listener object can be registered to receive notification of the occurrence of events of a given 
class on more than one source object. In that case, it is normally necessary for the code in the Listener 
object to crack open the event object to determine which screen object was responsible for the event (if it 
matters) . 

Also, the JDK 1.1 documentation indicates that it is possible to have event-style communication between 
objects that are not screen objects. Subsequent modules will investigate a number of these possibilities. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1474 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


4.2.3.9 Review 


The original HTML version 7° of this module contains a number of review questions with answers. If 
interested, you can take a look at those review questions 7! . 


4.2.3.10 Run the program 


I encourage you to copy the code from Listing 9 (p. 1464) and Listing 16 (p. 1478) . Compile the code and 
execute it. Experiment with the code, making changes, and observing the results of your changes. Make 
certain that you can explain why your changes behave as they do. 


4.2.3.11 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 
e Module name: Java OOP: Event Handling in JDK 1.1, A First Look, Delegation Event Model 


e File: Java0080.htm 
e Published: 11/17/13 
e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


4.2.4 Java OOP: Swing and the Delegation Event Model” 
4.2.4.1 Table of Contents 
e Preface (p. 1481) 


Viewing tip (p. 1481) 
x Listings (p. 1481) 


e Introduction (p. 1481) 


°http://cnx.org/content /m45597 /latest /Java080.htm 
21 http://cnx.org/content /m45597 /latest /Java080.htm7#review 
22This content is available online at <http://cnx.org/content /m44336/1.4/>. 
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e Sample Program (p. 1482) 


Interesting Code Fragments (p. 1483) 
Program Listing (p. 1483) 


e Another Sample Program (p. 1483) 


Interesting Code Fragments (p. 1484) 
Program Listing (p. 1484) 


Summary (p. 1484) 

Run the programs (p. 1484) 
Miscellaneous (p. 1484) 
Listings (p. 1485) 


4.2.4.2 Preface 


This module is one in a collection of modules designed for teaching ITSE2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

(Editor’s note: As you read this module, you will see that it was originally written around 1997. However, 
despite many improvements in Java since then, most of what was true then is still true in 2013.) 

This module makes several references to my website, which is located at 
http://www.dickbaldwin.com/toc.htm 7? . A copy of the original html version of this module is 
available here 74 . 


4.2.4.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the listings while you are reading about them. 


4.2.4.2.1.1 Listings 


e Listing 1 (p. 1485) . Beginning of the constructor for the GUI class. 

e Listing 2 (p. 1486) . Complete listing of the program named SwingEvent08. 
e Listing 3 (p. 1487) . The class named MyFrame. 

e Listing 4 (p. 1488) . Complete listing of the program named SwingEvent09. 


4.2.4.3 Introduction 


To begin with, what is Swing? 

Swing is the name given to a new set of lightweight components developed by Sun to supplement (and 
possibly replace) the components in the AWT. (The general topic of lightweight components is covered in a 
separate module.) With the exception of top-level containers, Swing components are developed completely 
using Java and don’t depend on the peer component rendering provided by the operating system. 

Swing components have several advantages over AWT components, and probably some disadvantages as 
well. 

One of the advantages is that because the components are not rendered on the screen by the operating 
system, the look and feel of a component does not change as the application or applet is executed on different 
platforms running under different operating systems. 


°3http://www.dickbaldwin.com/toc.htm 
4http://cnx.org/content /m45597 /latest /Java081-htm 
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Furthermore, it is possible to cause Swing components to mimic the look and feel of a specific platform 
no matter what platform the program is running on. This is known as pluggable look and feel . (A 
complete module is dedicated to pluggable look and feel.) 

In any event, Swing components are here to stay, and from this point forward in these tutorial modules, 
we will attempt to incorporate Swing into the modules in a meaningful way. 

Swing components support the JDK 1.1 Delegation Event Model 7° . They do not support the JDK 1.0 
event model, so if you want to use Swing components, you must program using the Delegation Event Model. 

In some cases, conversion of an application or applet from AWT components to Swing components 
involves nothing more complex than replacing the AWT components with corresponding Swing components. 
For example, the Swing component that corresponds to the AWT Button component is the Swing 
JButton component. 

In all cases that you use Swing you will need to import, or otherwise recognize the package that contains 
the Swing classes so that the compiler and interpreter will have access to those classes. Note that the way to 
do this will probably change between JDK 1.1.x and JDK 1.2, but hopefully the change won’t be too great. 

(Rumor has it that Swing will be more tightly integrated into JDK 1.2 than is the case with JDK 1.1.) 

This module is designed as a follow-on to the earlier module titled " Event Handling in JDK 1.1, A First 
Look, Delegation Event Model 7° ." As such, material presented in that module will not be repeated here. 

The two AWT sample programs in that module were converted to Swing programs for presentation in 
this module using the simple substitution procedure described above. As you will see, the Swing version of 
one of the sample program behaves essentially the same as its AWT counterpart. The Swing version of the 
other sample program does not behave the same as its AWT counterpart. 

So, where does that leave us? Well, fortunately, from an event handling viewpoint, Swing components 
operate the same as AWT components (except that Swing provides a number of new event types) . From 
other viewpoints, Swing components may or may not behave the same as their AWT counterparts. 

In addition, many Swing components don’t have an AWT counterpart. A number of new and exciting 
components are included in the Swing library that don’t exist in the AWT (tooltips, progress bars, trees, 
etc.) 

Since this module is primarily concerned with event handling, we will pursue the Swing components from 
an event-handling viewpoint in this module and leave other considerations surrounding Swing components 
for subsequent modules. As you will see, this module will raise some interesting questions regarding the 
behavior of Swing components, but won’t provide the answers to those questions. 


4.2.4.4 Sample Program 


The sample program in this section, named SwingEvent08 (p. 1486) , was created by replacing each instance 
of Frame in the program named Event08 , with an instance of JFrame . In addition, an import 
declaration was added to cause the Swing classes to be accessible to the compiler and the interpreter. 

(Note that as of JDK 1.7.x, the import declaration must read import javax.swing.*; instead of 
import com.sun.java.swing.*; as shown in Listing 2 (p. 1486) .) 

The event handling in this program is exactly the same as in Event08 from the earlier module. If you 
haven’t reviewed that program, and the module on the Delegation Event Model, you should probably go 
back and review it now. 

This program illustrates the use of Event Sources , Event Listeners , and Adapters inthe Delegation 
Event Model for Swing components. 

Briefly, this application instantiates an object that creates a user interface consisting of a simple JFrame 
object. This object is an Event Source that notifies two different Event Listener objects of Window 
events. 

One of the Listener objects implements the WindowListener interface and defines all of the 
methods declared in that interface. 
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6http://cnx.org/content /m44340/latest /?collection=coll 1441 /latest 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1477 


The other Listener object extends the Adapter class named WindowAdapter . As explained 
in the earlier module, the purpose of Adapter classes (as used in this context) is to implement the 
Listener interfaces and to define all of the methods with empty methods. (Adapter classes are viewed in 
a broader context in the advanced modules on the Reflection API.) 

Classes that extend the Adapter classes can then selectively override only those methods of interest. 
This Listener object overrides only two of the methods. 

Note that this application does not terminate and return control to the operating system. You must 
forcefully terminate it. 

This program was tested using JDK 1.1.6 and Swing 1.0.1 under Win95. (Also, it was recently tested 
using JDK 1.7 running under Windows Vista after modifying the import directive mentioned above.) 

The output produced by running the program is presented in the comments at the beginning of the 
program listing. 


4.2.4.4.1 Interesting Code Fragments 


Listing 1 (p. 1485) provides the first and only code fragment, that I am going to show and discuss. This 
fragment shows the beginning of the constructor for the GUI class. The fragment illustrates that this 
program uses the JFrame class to instantiate a top-level container for the graphical user interface instead 
of a Frame object as in the earlier module 2” . 

If you compile and run this program, you will see that it behaves essentially the same as its AWT 
counterpart named Event08 that was discussed extensively in the earlier module 7° . 


4.2.4.4.2 Program Listing 


A complete listing of the program is provided in Listing 2 (p. 1486) . 


4.2.4.5 Another Sample Program 


This is a Swing version of the program named Event09 from the earlier module 7° . 

The purpose of this program is to illustrate that in some cases, conversion of an AWT program to a 
Swing program isn’t as simple as importing the Swing package and replacing the AWT components with 
their Swing counterparts. 

That is what was done with this program. This program is identical to the AWT program named 
Event09 except that all instances of Frame were replaced by JFrame and the Swing package was 
imported. 

The intended behavior of this program (go back and review Event09 if necessary) is to display 
the coordinates of the mouse pointer each time the mouse is clicked inside the client area of the JFrame 

Initially, this program appears to work correctly. As each new click occurs on the client area of the 
JFrame , a new pair of coordinate values is displayed. However, the previous pairs of coordinate values 
does not disappear as is the case with the program named Event09 . Thus, the behavior is significantly 
different under JDK 1.1.6 and Swing 1.0.1 under Win95. (The behavior is similarly different under JDK 
1.7x and Windows Vista.) 

Furthermore, in some cases, while this GUI is on the screen, if focus is transferred to a different applica- 
tion, all of the coordinate values except the last one that was created will disappear. 

It will be left as an exercise for the student to dig into the documentation on Swing in order to understand 
and explain this behavior. 

As explained earlier, this module is concerned with event handling in Swing and this program is adequate 
to illustrate the use of the Delegation Event Model with Swing. We will leave the subtle behavior of the 
Swing components for discussion in subsequent modules. 


27http://cnx.org/content /m44340/latest /?collection=col1 1441 /latest 
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If you compile and execute this program, whenever you click the mouse inside the JFrame , you should 
see the coordinates of the mouse pointer displayed above the mouse pointer. 


4.2.4.5.1 Interesting Code Fragments 


Listing 3 (p. 1487) shows the only code fragment that will be highlighted for this program in this module. 
This fragment illustrates how this program extends JFrame into a new class named MyFrame to make 
it possible to override the paint() method of the JFrame class. Recall that in the program named 
Event09 ,the Frame class was extended in a similar way. 


4.2.4.5.2 Program Listing 


A complete listing of this program is provided in Listing 4 (p. 1488) . 


4.2.4.6 Summary 


Swing provides a new set of lightweight components that can be programmed using the Delegation Event 
Model first introduced in JDK 1.1. 

The Swing components cannot be programmed using the event model from JDK 1.0. 

In some cases, all that is necessary to convert a program built around AWT components to a program 
built around Swing components is to import the Swing classes and replace all instances of AWT components 
with their Swing counterparts. 

In other cases, a simple substitution as described above will not produce the same behavior. 

Many of the Swing components do not have an AWT counterpart. The Swing classes contain a number 
of components that were never added to the AWT component library. 

This module has dealt exclusively with the use of the Delegation Event Model for programming Swing 
components and has left some unanswered questions regarding how the behavior of Swing components does, 
and in some cases does not, mirror that of their AWT counterparts. 


4.2.4.7 Run the programs 


I encourage you to copy the code from Listing 2 (p. 1486) and Listing 4 (p. 1488) . Compile the code and 
execute it. Experiment with the code, making changes, and observing the results of your changes. Make 
certain that you can explain why your changes behave as they do. 


4.2.4.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Swing and the Delegation Event Model 
e File: Java0081.htm 

e Published: 11/17/13 

e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.2.4.9 Listings 


Listing 1 . Beginning of the constructor for the GUI class. 


class GUI{ 

public GUIQ {//constructor 
//Create a new JFrame object 
JFrame displayWindow = new JFrame(); 
displayWindow. setSize (300, 200) ; 
displayWindow.setTitle("Copyright 1998, R.G.Baldwin") ; 


Table 4.34 
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Listing 2 . Complete listing of the program named SwingEvent08. 


/*File SwingEvent08.java Copyright 1998, R.G.Baldwin 
Rev 05/09/98 


This is a Swing version of the program named Event08. 


The purpose of this program is to illustrate that in many 
respects, programming with Swing components is no different 
from programming with AWT components. 


Conversion of this program from AWT to Swing involved 
nothing more complex than using the search and replace 
feature of an editor to replace all instances of Frame 
with JFrame and to import the swing package. 


Illustrates the use of Event Sources, Event Listeners, and 
Adapters in the Delegation Event Model for Swing 
components. 


Briefly, this application instantiates an object which; 
creates a user interface consisting of a simple JFrame; 
object. This object is an Event Source which notifies two 
different Event Listener objects of Window events. 


One of the Listener objects implements the WindowListener 
interface and overrides all of the methods declared in; 
that interface. 


The other Listener object extends the Adapter class named; 
WindowAdapter. The purpose of Adapter classes is to 
implement the Listener interfaces and to define all of 
the methods with empty methods. Classes which extend the 
Adapter classes can then selectively override only those 
methods of interest. This Listener object overrides only 
two of the methods. 


Note that this application does not terminate and return 
control to the operating system. You must forcefully 
terminate it. 


Tested using JDK 1.1.6 and Swing 1.0.1 under Win95. 


When executed, this application places a simple empty; 
JFrame object on the screen. 


Starting the program produces screen output similar to 
the following: 


WProci windowActivated test msg 
Wproci windowOpened test msg 
Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
Pressing the minimize button on the JFrame produces the; 
output similar to the following: 


WProci windowlconified test msg 
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Table 4.35 


Listing 3 . The class named MyFrame. 


class MyFrame extends JFramef{ 
int clickX; 
int clickY; 


public void paint (Graphics g){ 
g.drawString( 
"" + clickX + ", " + clickY, clickX, clickY); 
}//end paint () 
}//end class MyFrame 


Table 4.36 
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Listing 4 . Complete listing of the program named SwingEvent09. 


/*File SwingEvent09.java Copyright 1998, R.G.Baldwin 
Rev 5/9/98 by RGB 
This is a Swing version of the program named Event09. 


The purpose of this program is to illustrate that in some 
cases, conversion of an AWT program to a Swing program 

isn’t as simple as importing the Swing package and replacing 
the AWT components with Swing components. 


That is what was done with this program. In other words, 
this program is identical to the AWT program named Event09 
except that all instances of Frame were replaced by JFrame 
and the Swing package was imported. 


At the surface, the program appears to work correctly. 
However, as each new click occurs on the client area of 

the JFrame, a new pair of coordinate values is displayed, 
but the previous pairs of coordinate values don’t disappear 
as is the case with the program named Event09. 


Furthermore, in some cases, while this GUI is on the screen, 
if focus is transferred to a different application, all of 
the coordinate values except the last one created will; 
disappear. 


It will be left as an exercise for the student to dig into 
the (currently very sparse) documentation on Swing in order 
to understand and explain this behavior. 


Illustrates the use of Event Sources, Event Listeners, and; 
Adapters in the Delegation Event Model for Swing. 


This program instantiates a Listener object to process; 
mouse events. When a mouse press occurs in a JFrame object, 
the program gets the coordinates and then displays those 
coordinates near the point of the mouse press. 


Tested using JDK 1.1.6 and Swing 1.0.1 under Win95. 
FEC EEEE EEE EEEE EEEE EEE EEEE aK I I I EEE EE 21 21 EE 4 2k 2k E E EE E ak ak kak / 
import java.awt.*; 

import java.awt.event.*; 

import com.sun. java.swing.*; 


public class SwingEvento9 { 
public static void main(String[] args){ 
GUI gui = new GUI();//instantiate a GUI 
}//end main 
}//end class SwingEvent09 
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//Subclass JFrame in order to override the paint method. 
class MyFrame extends JFramef{ 

int clickX; 

int clickyY;: 
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Table 4.37 


-end- 


4.2.5 Java OOP: Member Classes” 
4.2.5.1 Table of Contents 
e Preface (p. 1489) 


Viewing tip (p. 1489) 


x Images (p. 1490) 
x Listings (p. 1490) 


e Preview (p. 1491) 


What can you include in a class definition? (p. 1491) 
What is a member class? (p. 1491) 

What about a member interface? (p. 1491) 

Why use member classes? (p. 1492) 

Smoke and mirrors (p. 1492) 


e Discussion and sample code (p. 1493) 


Class containment hierarchy (p. 1493) 
Behavior of the program (p. 1493) 
Structure of the program (p. 1494) 


Run the program (p. 1501) 
Summary (p. 1502) 

What’s next? (p. 1502) 

Complete program listing (p. 1502) 
Miscellaneous (p. 1502) 

Images (p. 1503) 

Listings (p. 1506) 


4.2.5.2 Preface 


This module is one in a collection of modules designed for teaching ITSE2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

(Editor’s note: As you read this module, you will see that it was originally written around 2003. However, 
despite many improvements in Java since then, most of what was true then is still true in 2013.) 

This module makes several references to my website, which is located at 
http://www.dickbaldwin.com/toc.htm 31 . 


4.2.5.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the Images and listings while you are reading about them. 


30This content is available online at <http://cnx.org/content /m44347/1.4/>. 
31 http://www.dickbaldwin.com/toc.htm 
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4.2.5.2.1.1 Images 


Image 1 (p. 1503 


) 
( ) 
( ) 
( ) 

Image 5 (p. 1504) . Screen output. 

( ) 
( ) 
( ) 
( ) 


. Class files produced when the program is compiled. 
. Screen output. 
. Screen output. 
. Screen output. 


Image 6 (p. 1504) . Screen output. 
Image 7 (p. 1504) . Screen output. 
Image 8 (p. 1504) . Screen output. 
Image 9 (p. 1505) . Screen output. 
Image 10 (p. 1505) . Screen output. 
Image 11 (p. 1505) . Screen output. 
Image 12 (p. 1505) . Screen output. 
Image 13 (p. 1505) . Screen output. 
Image 14 (p. 1506) . Screen output. 
Image 15 (p. 1506) . Screen output. 
Image 16 (p. 1506) . Screen output. 


4.2.5.2.1.2 Listings 


Listing 1 (p. 
Listing 2 (p 
Listing 3 (p 
Listing 4 (p 
Listing 5 (p. 
Listing 6 (p 
Listing 7 (p 
Listing 8 (p 
Listing 9 ( 

Listing 10 
Listing 11 
Listing 12 
Listing 13 
Listing 14 
Listing 15 
Listing 16 


Listing 18 
Listing 19 
Listing 20 
Listing 21 
Listing 22 
Listing 23 
Listing 24 
Listing 25 


) 
) 
) 
2 
. 1508) . Constructor for class B. 
) 
) 
) 
9 


p 
(p 
(p 
(p 
(p 
(p 
(p 
(p 
Listing 17 (p. 
(p 
(p 
(p 
(p 
(p 
(p 
(p 
(p 


1506) . The main method. 

1507) . The class named X. 

1507) . Beginning of the top-level class named A. 
1507) . Constructor for class A. 

1508) . Beginning of the member class named B. 


. Beginning of the member class named C. 
. Beginning of constructor for class C. 
. The private member class named D. 

. More constructor code for class C. 


. More cShow method code. 
. Overridden toString method in class C. 
. More cShow method code. 
. Complete program listing. 


) 
1509) . More constructor code for class C. 
1510) . The method named bShow. 
1510) . The method named aShow. 
1510) . Beginning of the cShow method. 
1510) . More cShow method code. 
1511) . Call the aShow method. 
1511) . More cShow method code. 
1511) . More cShow method code. 
1511) . More cShow method code. 
1513) . More cShow method code. 
1513) . More cShow method code. 

) 

) 

) 

) 
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4.2.5.3 Preview 
4.2.5.3.1 What can you include in a class definition ? 


There are several different kinds of items that can be contained in a class definition. As you learned in the 
early modules in this series, the list includes: 


Static variables 
Instance variables 
Static methods 
Instance methods 
Constructors 


As you can learn at http://www.dickbaldwin.com/toc.htm 3? , the list also includes: 


e Static initializer blocks 
e Instance initializers 


Can also contain other class definitions 
In this and the next two modules, you will learn that a class definition can also contain the following 
three kinds of inner classes 


e Member classes 
e Local classes 
e Anonymous classes 


A class can also contain Nested top-level classes and interfaces , which you can learn about at 
http://www.dickbaldwin.com/toc.htm °° . 


(Note that it is questionable whether a nested top-level class or interface should be referred to as 
an inner class, because an object of a nested top-level class can exist in the absence of an object 
of the enclosing class. Regardless of whether the term inner class applies, a nested top-level class 
is defined within the definition of another class, so its definition is internal to the definition of 
another class.) 


This module will be dedicated to an explanation of member classes . Subsequent modules will explain 
the other two types of inner classes in the above list (p. 1491) . 


4.2.5.3.2 What is a member class ? 


A member class is a class that is defined inside the definition of another class, (without the use of the 
static modifier as is the case with a nested top-level class). 

An object of the member class must be internally linked to an object of the enclosing class, (which is 
not the case with a nested top-level class). 

Thus, a member class is truly an inner class. (An object of the member class cannot exist in the absence 
of an object of the enclosing class.) 


4.2.5.3.3 What about a member interface ? 


Interfaces defined within classes are implicitly static. This means that they are always top-level. There is 
no such thing as a member interface, a local interface, or an anonymous interface. 


32http://www.dickbaldwin.com/toc.htm 
33http://www.dickbaldwin.com/toc.htm 
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4.2.5.3.4 Why use member classes ? 


Probably the most important benefit of member classes has to do with accessing the other members of 
enclosing classes. The methods of a member class have direct access to all the members of the enclosing 
classes, including private members. Thus the use of member classes can eliminate the requirement to connect 
objects together via constructor parameters. 

This is particularly useful in those cases where there is no reason for an object of a member class to exist 
in the absence of an object of the enclosing class, and where the methods of the object of the member class 
need access to members of the object of the enclosing class. 

Data structures and iterators 

For example, there is usually no reason for an Iterator object to exist in the absence of the data- 
structure object for which it is designed to provide iterator services. Also, the iterator object usually needs 
to have ready access to the members of the data-structure object, some or all of which may be private. Thus, 
a class from which an Iterator object can be constructed is a good candidate for inclusion as a member 
class in the class from which the associated data-structure object is instantiated. 

Listener objects 

Another common use for inner classes is in the definition of classes from which listener objects (which 
listen for events fired by other objects) are instantiated. (However, it may be more common to use 
anonymous classes than member classes for this purpose.) 

What does Flanagan have to say? 
Here is how David Flanagan, author of Java in a Nutshell, summarizes his discussion of member classes. 


"A class defined as a member (non-static) of another. Each instance has an enclosing instance, 
and can use its members. New syntax for this , new , and super . Cannot have static 
members. Cannot have same name as containing class." 


According to Flanagan, the main features of member classes are: 


e Every instance of a member class is internally associated with an instance of the class that defines or 
contains the member class. 

e The methods of a member class can implicitly refer to the fields defined within the member class, as 
well as those defined by any enclosing class, including private fields of the enclosing class. 


4.2.5.3.5 Smoke and mirrors 


Every class definition in a Java program, including nested top-level classes, member classes, local classes, 
and anonymous classes, produces a class file when the program is compiled. According to Flanagan, 


"The Java Virtual Machine knows nothing about nested top-level classes and interfaces or the 
various types of inner classes. Therefore, the Java compiler must convert these new types into 
standard non-nested class files that the Java interpreter can understand. This is done through 
source code transformations that insert $ characters into nested class names. These source code 
transformations may also insert hidden fields, methods, and constructor arguments into the 
affected classes." 


A reference to the containing object 
For example, the compiler automatically inserts a private instance variable in the member class to hold 
a reference to the containing object. It also inserts a hidden argument in all constructors for the member 
class, and passes the containing object’s reference to the constructor for the member class. The modified 
constructor saves that reference in the private instance variable of the object. of the member class. Thus 
each object instantiated from the member class contains a private reference to the containing object. 
Accessing private members 
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In those cases where it is necessary for an object of the member class to access private members of 
the containing object, the compiler automatically creates and uses accessor methods that make such access 
possible. 

Similar to your code 

The bottom line is that the code that is automatically produced by the compiler is probably very similar 
to code that you would write if you were writing the program using only of top-level classes. The good news 
is that you don’t have to write that extra code, and you don’t have to maintain it. The extra code is written 
for you, and if you modify your class structure, the extra code is automatically modified accordingly. 


4.2.5.4 Discussion and sample code 


The paragraphs that follow will explain a program named InnerClasses06_, which is designed specifically 
to illustrate various characteristics of member classes. I will discuss the program in fragments. A complete 
listing is shown in Listing 25 (p. 1515) near the end of the module. 

This program illustrates the use of member classes. The program consists of a total of six classes: 


e Top-level classes named 


InnerClasses06 
A 
X 


e Member classes named 


B 
C 
D 


When compiled, the program produces the class files shown in Image 1 (p. 1503) . 


4.2.5.4.1 Class containment hierarchy 


Once you understand the class file naming convention, you can determine from the file names in Image 1 (p. 
1503) that class B is a member class of class A. 


(The class file named A§$B.class indicates that the class named B is a member of the class named 


A.) 
Similarly, class C is a member of class B, and class D is a private member of class C. 


(However, you cannot tell from the class file names that class D is private.) 


4.2.5.4.2 Behavior of the program 


An object is instantiated from the class named A. This makes it possible to instantiate an object of the 
member class named B. The object of the class named B is internally linked to the object of the class named 


A. 
(This causes the instance variable, constructor parameter, and accessor methods discussed above 


to be automatically created to link the object of the class named B to the object of the class 
named A.) 
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The object of the class named B is used to instantiate an object of the member class named C. This object 
of the class C is linked to the object of the class named B. 

Instantiate additional objects of classes A and B, plus an object of class D 

When the object of the class named C is instantiated, the constructor for that class instantiates separate 
objects of the classes named A and B, and also instantiates an object of the private member class named 
D. 


(We will see later that the new and separate object of the class named B continues to be internally 
linked to the original object of the Class named A, and is not internally linked to the new object 
of the class named A.) 


Instantiation of the object of class D illustrates the use of private member classes. 
(Note that while top-level classes cannot be private, member classes can be private.) 


Perform a variety of operations 

A variety of operations are performed from within the methods belonging to the object of the class C to 
illustrate the attributes and behavior of objects instantiated from member classes. 

Comments in the code explain the purpose of each of those operations. 

Many of those operations produce screen output, which will be shown in conjunction with the code that 
produced the output. 


4.2.5.4.3 Structure of the program 


The main method 
The main method of the controlling class named InnerClasses06_, is shown in Listing 1 (p. 1506) . 
The code in Listing 1 (p. 1506) instantiates an object of the member class named C and calls the method 
named cShow on that object. 


(Note that it is necessary to first instantiate objects of the enclosing classes named A and B 
before the object of the member class named C can be instantiated.) 


An independent top-level class named X 

Listing 2 (p. 1507) shows the definition of an independent top-level class named X. 

This class will be extended by the class named C, which is a member of the class named B, which is 
a member of the class named A. This will illustrate that the inheritance hierarchy is independent of the 
containment hierarchy. 

As you can see in Listing 2 (p. 1507) , the class named X overrides the toString method to identify 
itself when called. 


(The toString method is automatically called whenever an object’s reference is passed as a 
parameter to the printIn method.) 


The top-level class named A 

Listing 3 (p. 1507) shows the beginning of the top-level class named A. 

Listing 3 (p. 1507) shows the declaration of two instance variables and three class variables in the class 
named A. All of the variables are private, and some are initialized when declared. The three class variables 
will be used to maintain a count of the number of objects instantiated from the classes named A, B, and C. 


(Because member classes cannot contain static members , the counter variables for the 
member classes named B and C were placed in the top-level class named A instead of placing 
them in their respective class definitions.) 
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Constructor for class A 
Listing 4 (p. 1507) shows the constructor for the top-level class named A. 
Whenever an object of the class named A is instantiated, the constructor does the following: 


e Saves the value of an incoming parameter in a private instance variable named aVar 
Increments the object counter named objCntA_ , maintaining a count of the objects instantiated 
from class A. 

e Saves the value of the object counter in an instance variable named objNumber to identify the 
specific object. 

e Displays a message showing the identification of the object being instantiated. 


The screen output 

The code in Listing 1 (p. 1506) instantiates a new object of the class named A, passing the integer value 
1 as a parameter to the constructor. As a result, the code in the constructor shown in Listing 4 (p. 1507) 
produces the screen output shown in Image 2 (p. 1503) . 

As you can see from the value of the object counter in Image 2 (p. 1503) , this is the first object 
instantiated from the class named A. 


(The value passed, as a parameter to the constructor, is not displayed by the code in the 
constructor. That value will be displayed later.) 


The method named aShow 

The class named A also defines a private method named aShow . I will defer my discussion of that 

method until later when it is called. 
The member class named B 

Listing 5 (p. 1508) shows the beginning of the member class named B. 

If you examine the complete listing of the program in Listing 25 (p. 1515) , you will see that the class 
named B is defined internal to the class named A. In other words, the beginning of the definition of the class 
named B appears before the curly brace that signals the end of the definition of the class named A. Thus, 
the class named B is a member class of the class named A. 

The code in Listing 5 (p. 1508) declares two private instance variables and initializes one of them. 

Constructor for class B 
Listing 6 (p. 1508) shows the entire constructor for the class named B. 
Whenever an object of the class named B is instantiated, the constructor does the following: 


Saves the value of an incoming parameter in a private instance variable named bVar 
Increments the object counter named objCntB_ , which is a class variable of the containing top-level 
class named A, maintaining a count of objects instantiated from class B. 

e Saves the value of the object counter in an instance variable named objNumber to identify the 
specific object. 

e Displays a message showing the identification of the object being instantiated. 


The screen output 

Listing 1 (p. 1506) shows the instantiation of a new object of class B, immediately following the instan- 
tiation of an object of class A. 

The object instantiated from the member class named B is linked to the object instantiated from the 
top-level class named A. 

The constructors for the classes named A and B produce the two lines of output shown in Image 3 (p. 
1503) , the first of which is a repeat of the output shown in Image 2 (p. 1503) . 

The method named bShow 

The class named B also defines a private method named bShow . As with the method named aShow 
mentioned earlier, I will defer a discussion of bShow until later when it is called. 

The member class named C 
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Listing 7 (p. 1508) shows the beginning of a member class named C. 

Class C is a member of the class named B. In other words, the beginning of the definition of the class 
named C begins before the curly brace that ends the definition of the class named B. 

The code in Listing 7 (p. 1508) declares several instance variables for the class named C, and initializes 
two of them. The purpose of these variables will become clear later when they are used. 


(Note also that class C extends class X, in order to illustrate that the class containment hierarchy 
is independent of the inheritance hierarchy.) 


Constructor for class C 

Listing 8 (p. 1509) shows the beginning of the constructor for the class named C. 

Whenever an object of the class named C is instantiated, the constructor code shown in Listing 8 (p. 
1509) does the following: 


Saves the value of an incoming parameter in a private instance variable named cVar 
Increments the object counter named objCntC , which is a class variable of the class named A, 
maintaining a count of objects instantiated from class C. 

e Saves the value of the object counter in an instance variable named objNumber to identify the 
specific object. 

e Displays a message showing the identification of the object being instantiated. 


Screen output 

Listing 1 (p. 1506) shows the instantiation of a new object of class C, immediately following the instan- 
tiation of an object of class B. 

The object instantiated from the member class named C is linked to the object instantiated from the 
member class named B. Similarly, the object instantiated from the member class named B is linked to the 
object instantiated from the top-level class named A. 

The constructors for the classes named A, B, and C produce the three lines of output shown in Image 4 
(p. 1503) , the first two of which are repeated from Images 2 and Image 3 (p. 1503) . 

The output shown in Image 4 (p. 1503) demonstrates that the code in Listing 1 (p. 1506) causes the 
constructors for the three classes to be executed in sequence. 

At this point, Iam going to put the discussion of the class named C on hold and discuss another member 
class named D. 

The private member class named D 

Top-level classes cannot be private. However, member classes can be private provided that the using code 
is consistent with the use of private members. To demonstrate this, the class named C contains a private 
member class named D, which is shown in its entirety in Listing 9 (p. 1509) . 

The most significant thing about the class named D is that it is declared private. 

When an object is instantiated from the class named D, it displays a couple of messages, one of which 
provides the name of the class file produced by the compiler to represent the class named D. We will see 
those messages shortly in conjunction with the instantiation of an object of the class named D. 

Returning to the constructor for class C 

Listing 10 (p. 1509) shows the next statement in the constructor for the class named C. This statement 
instantiates an object of its private member class named D. 

The code in Listing 10 (p. 1509) causes the constructor for the class named D to be executed, producing 
the screen output shown in Image 5 (p. 1504) . 

As mentioned earlier, comparing the class file name in Image 5 (p. 1504) with the class file naming 
convention for member classes, you can determine that D is a member of C, C is a member of B, and B is a 
member of A. 

Instantiate independent objects of classes A and B 

The remaining constructor code for class C is shown in Listing 11 (p. 1509) . 

The code in Listing 11 (p. 1509) instantiates new and independent objects of the classes named A and 
B, both of which are enclosing classes of the member class named C. 
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(Note that the parameter values passed to the constructors are different than was the case for 
the objects instantiated in Listing 1 (p. 1506) . We will see the result of that later.) 


I will display information about these two objects later. That information will show that the new object of 
the member class named B is linked to the original object of the enclosing class named A. 
The screen output 

In the meantime, when these two objects are instantiated, their constructors are executed, producing the 
screen output shown in Image 6 (p. 1504) . 

In each case, the value of the object counter shows that this is the second object instantiated from each 
of these two classes. 

Methods aShow, bShow, and cShow 

The classes named A, B, and C, each contain display methods named aShow , bShow , and cShow 
respectively. 

The method named cShow is rather long, and I will discuss it in detail shortly. For now, suffice it 
to say that code in cShow calls the private method named bShow in the containing object to which 
it is linked. Therefore, this will be an appropriate time to examine the method named bShow , which is 
defined in the member class named B. 

The method named bShow 

The bShow method, defined in the member class named B, is shown in Listing 12 (p. 1510) . It is 
important to note that this is a private method. 

When this method is called, it does the following: 


Displays the value of the constructor parameter passed to the object when it was constructed. 
Displays the identification of the object based on the value of the object counter when it was con- 
structed. 

e Calls the corresponding aShow method of the object of the containing class to which it is linked. 


Since the code in the bShow method calls the private aShow method of the containing object to which 
it is linked, it is also time to take a look at that method. 

The method named aShow 

The aShow method, defined in the top-level class named A, is shown in Listing 13 (p. 1510) . It is 
also important to note that this is a private method. 

When this method is called, it does the following: 


e Displays the value of the constructor parameter passed to the object when it was constructed. 
e Displays the identification of the object based on the value of the object counter when it was con- 
structed. 


Containment hierarchy is displayed 

Because cShow calls bShow , which in turn calls aShow , we should expect that the call to the 
cShow method on an object of the member class named C would display information about the containment 
hierarchy. 


(Simply as another reminder, the containment hierarchy is completely independent of the inher- 
itance hierarchy.) 


Calling cShow 
Referring once more to Listing 1 (p. 1506) , we see that the method named cShow is called on the 
object of the class named C when that object is instantiated. We will see the result of that call shortly. 
The cShow method 
Listing 14 (p. 1510) shows the beginning of the cShow method. 
The code in Listing 14 (p. 1510) 
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e Displays a string separator to help locate the specific output in the large quantity of output produced 
by the program. 
Displays the object identifier based on the object counter. 
Displays the value passed to the constructor when the object was instantiated. 


The screen output 

The code in Listing 14 (p. 1510) produces the output shown in Image 7 (p. 1504) . 

As you can see by comparing this with Listing 1 (p. 1506) , this is the first object instantiated from the 
class named C, and is the object instantiated from the statement in the main method in Listing 1 (p. 
1506) . (The constructor parameter value is 3.) 

Call the bShow method 

Continuing with the code in the cShow method, the code in Listing 15 (p. 1510) calls the private 
method named bShow on the containing object of the class B to which this object is linked. 

As you will recall from the previous discussion, the code in the bShow method will, in turn, call the 
aShow method on the containing object of the class named A to which the object of the class B is linked. 

The screen output 

The code in Listing 15 (p. 1510) produces the output shown in Image 8 (p. 1504) . 

As you can see in Image 8 (p. 1504) , the linked objects of the classes B and A are the first objects 
instantiated from those classes. In addition, the saved values of the constructor parameters show that these 
are the objects that were instantiated by the statement in the main method of Listing 1 (p. 1506) . 

Call the aShow method 

As I explained earlier, the object of the class C is linked to the containing object of the class named B. 
The code in Listing 16 (p. 1511) shows that the object of the class C is also linked to the containing object of 
the class A (even though the containing class named A is one level removed in the containment hierarchy). 

Implicit access 

The methods of a member class have implicit access to all members (including private members) of all 
containing classes. Thus, the code in the cShow method, belonging to the object of the class named C, 
can directly call the private aShow method of the containing class named A. 

The screen output 

Therefore, the code in Listing 16 (p. 1511) produces the output shown in Image 9 (p. 1505) . 

You can tell by the values displayed in Image 9 (p. 1505) that the aShow method called in Listing 16 
(p. 1511) was called on the same object on which the aShow method was called by the code in Listing 
15 (p. 1510) . However, in Listing 15 (p. 1510) , the bShow method was called first, which in turn called 
the aShow method. 

Accessing the object of the class C, and the this keyword 

The syntax used with the keyword this is somewhat different for member classes and contained objects 
than is the case for top-level classes. For example, continuing with the method named cShow , the code 
in Listing 17 (p. 1511) shows five different ways to access the object instantiated from the member class 
named C in order to get and display the name of the class file that represents the member class named C. 

The screen output 

All five statements in Listing 17 (p. 1511) display the name of the same class file, as shown in Image 10 
(p. 1505) . 

Obviously in this situation, the last three statements in Listing 17 (p. 1511) are overly complex. There 
is no particular problem writing code in the method named cShow to gain access to the object to which 
the method belongs. It isn’t even necessary to use this to refer to that object, although the use of the 
hidden reference this may make the code more readable. 

Accessing the containing object of the class B 

However, things get a little more complicated when you need to gain access to a containing object, such 
as the containing object instantiated from the class named B. 

The two statements shown in Listing 18 (p. 1511) gain access to the containing object of the class named 
B. Each statement gets and displays the name of the class file that represents the member class named B. 
(Note the use of the keyword this in these statements.) 
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The screen output 

The output produced by the code in Listing 18 (p. 1511) is shown in Image 11 (p. 1505) . Once again, 
both statements get and display the name of the same class file. 

Accessing the containing object of the class named A 

Finally, the code in Listing 19 (p. 1511) gains access to the containing object of the class named A. 
(Once again, note the use of the this keyword in the statement in Listing 19 (p. 1511) .) 

The code in Listing 19 (p. 1511) produces the output shown in Image 12 (p. 1505) . 


(Since the class named A is a top-level class, the name of the class file is the same as the name 
of the class, with no § characters inserted by the compiler.) 


Investigate independent objects of classes A and B 

Recall that when the object of the member class named C was instantiated, the constructor for the class 
instantiated independent objects of the enclosing classes named A and B, and saved those object’s references 
in instance variables of the class named C. 


(See Listing 11 (p. 1509) , noting the parameter values of 10 and 20 passed to the constructors 
for A and B. Recall that the constructors for A and B save those parameter values in private 
instance variables named aVar and bVar .) 


Display variable values and class file names 

The code in Listing 20 (p. 1513) displays the values stored in the private instance variables belonging 
to those objects. The code in Listing 20 (p. 1513) also displays the names of the class files representing the 
classes from which those objects were instantiated. 

Screen output 

The code in Listing 20 (p. 1513) produces the output shown in Image 13 (p. 1505) . 

There should be no surprises in the output shown in Image 13 (p. 1505) . The values of the instance 
variables match the parameter values passed to the constructors in Listing 11 (p. 1509) when the objects 
were instantiated. The class file names match what you already know to be true from previous discussions 
earlier in this module. 

Call the private bShow method 

The code in Listing 21 (p. 1513) is somewhat more interesting. This code calls the private bShow 
method on the separate object instantiated from the class named B in order to identify the object to which 
that object is linked. 

The screen output 

The output produced by the code in Listing 21 (p. 1513) is shown in Image 14 (p. 1506) . Even though 
this object of the member class B was instantiated from within the constructor for the member class named 
C, the object of the class named B is internally linked to the object of the class named A that was originally 
used to instantiate the object of the class named C. 


(See Listing 1 (p. 1506) where the objects of classes named A, B, and C were originally instan- 
tiated. This object of the class named B is a different object from the object of the class named 
B instantiated in Listing 1 (p. 1506) . This object of the class named B was instantiated by the 
code in Listing 11 (p. 1509) .) 


How is this determined from Image 14? 

The second line in Image 14 (p. 1506) shows that a parameter value of 20 was received by the constructor 
when the object of the class named B was instantiated. This corresponds to the instantiation of the object 
by the code in the constructor in Listing 11 (p. 1509) . 

The third line in Image 14 (p. 1506) shows that this was the second object instantiated from the class 
named B. (See the definition of the bShow method in Listing 12 (p. 1510) , which displays the value 
stored in a variable that is used to save the object number.) 

The proof of the pudding 
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Now recall that the method named bShow (belonging to an object of the class B) calls the method 
named aShow belonging to the object of the class named A to which it is internally linked. 

The fourth line in Image 14 shows the value of the parameter passed to the constructor for the object 
of class A when that object was instantiated. (See the definition of the aShow method in Listing 13 (p. 
1510) .) This value corresponds to the value that was passed to the constructor for the original object of 
class A when it was constructed in Listing 1 (p. 1506) . 


(It does not correspond to the value passed to the constructor for the class named A when the 
object of the class A was constructed in Listing 11 (p. 1509) .) 


The fifth line in Image 14 (p. 1506) shows that the object was the first object instantiated from the class 
named A. 
Both B objects link to the same A object 

Thus, both objects instantiated from the class named B in this program are internally linked to the same 
object instantiated from the class named A, which is the enclosing class for the class named B. 

(However, had I instantiated the new object of the class B using a statement such as the following, 

new A(100).new B(200).bShow(); 

the new object of the class B would have been linked to the new object of the class A rather than being 
linked to the original object of the class A. As you can see, keeping mental track of which object is linked to 
which other object could become complicated.) 

Call the aShow method on the other A object 

The code in Listing 22 (p. 1513) calls the private aShow method on the independent object of the 
class A that was instantiated in the constructor for class C, shown in Listing 11 (p. 1509) . 

The output produced by the code in Listing 22 (p. 1513) is shown in Image 15 (p. 1506) . 

It should come as no surprise that this object of the class A was instantiated with a constructor parameter 
value of 10, and that it was the second object of the class named A that was constructed. 

This is simply a matter of code in the constructor for class C instantiating an object of a top-level class, 
and is no different in concept from instantiating an object of the member class B, also shown in Listing 11 
(p. 1509) . 

Inheritance and containment hierarchies are independent 

The remaining code is designed to demonstrate that the containment hierarchy is completely independent 
of the inheritance hierarchy. 

The class named C is a member of (is contained in) the class named B. That constitutes a part of the 
containment hierarchy. 

The class named C also extends the class named X, which in turn extends the class named Object 
That constitutes the inheritance hierarchy. 

Overridden toString methods 

I’m going to put the discussion of the method named cShow on hold and return to that discussion 
shortly. 

The class named X inherits, and overrides the toString method, as shown in Listing 2 (p. 1507) . 
When this version of the toString method is called, it returns the string" toString in Class X ". 

The class named C, which extends the class named X, also overrides the toString method as shown in 
Listing 23 (p. 1513) . 

When this version of the toString method is called, it returns the string 

" toString in Class C ". 

We will see the impact of overriding these two methods later. 

Illustrate the inheritance hierarchy 

Returning to the cShow method, the code in Listing 24 (p. 1514) illustrates the inheritance hierarchy 
to which the class named C belongs by getting and displaying the value stored in the instance variables 
named className belonging to the object instantiated from the class named C. 
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(The object contains two instance variables having the name className . One of these 
instance variables was contributed to the object by the superclass named X. The other was 
contributed to the object by the class named C.) 


Two instance variables named className 

The String value X was stored in one of the instance variables named className by the initialization 
of the variable shown in Listing 2 (p. 1507) . 

The String value C was stored in the other instance variable named className by the initialization 
of the variable shown in Listing 7 (p. 1508) . 


( Note that the variable named className is protected in the class named X. A subclass 
method cannot access a private variable in a superclass. To be accessible by a subclass method, 
the superclass variable must be protected , package-private , or public .) 


Two overridden toString methods 

An object instantiated from the class named C also contains two overridden versions of the toString 
method. One version of the method was contributed to the object by the superclass named X. The other 
version was contributed to the object by the class named C. 

Call the toString methods 

The code in Listing 24 (p. 1514) also calls the two overridden toString methods belonging to the 
object instantiated from the classes named C. As explained earlier, one version of the toString method is 
overridden in the class named X and the other version is overridden in the class named C. 


(Note the use of the super keyword to access the variable named className and the method 
named toString contributed to the object by the superclass named X.) 


The code in Listing 24 (p. 1514) also signals the end of the cShow method. 

The screen output 

The output produced by the code in Listing 24 (p. 1514) is shown in Image 16 (p. 1506) . 

Image 16 (p. 1506) shows that even though the class named C is contained in the class named B, the 
superclass of C is X, and is not B. To repeat, the containment hierarchy is entirely independent of 
the inheritance hierarchy. 


(Note, however, that there is nothing to prevent you from establishing an inheritance relationship 
between a member class and one of its containing classes if such a relationship will serve your 
needs. For example, in this program, it would be technically acceptable for the class named B to 
extend the class named A provided that either: 


e A noarg constructor is provided for the class named A, or 
e The constructor for the class named B calls the parameterized constructor belonging to 
the class named A.) 


And that is probably more than you ever wanted to know about the detailed relationships involving member 
classes. However, once you start using member classes, you will need to keep these relationships in mind. 
4.2.5.5 Run the program 


I encourage you to copy the code from Listing 25 (p. 1515) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 
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4.2.5.6 Summary 


In addition to a number of other items, a class definition can contain: 


Member classes 

Local classes 

Anonymous classes 

Nested top-level classes and interfaces 


This module explains member classes. Future modules will explain local classes and anonymous classes 

A member class is a class that is defined inside the definition of another class without being declared 
static. 

An object of the member class must be internally linked to an object of the enclosing class. A member 
class is truly an inner class because an object of the member class cannot exist in the absence of an object 
of the enclosing class. 

The methods of a member class have direct access to all the members of the enclosing classes, including 
private members. Thus the use of member classes can eliminate the requirement to connect objects together 
via constructor parameters. This is particularly useful in those cases where there is no reason for an object 
of a member class to exist in the absence of an object of the enclosing class, and where the methods of the 
object of the member class need access to members of the object of the enclosing class. 

The containment hierarchy of member classes is independent of the inheritance hierarchy. However, it is 
technically possible to establish an inheritance relationship between a member class and one of its enclosing 
classes. 

Member classes may be declared private, and may be instantiated from code that would normally have 
access to a private member at that level. 


4.2.5.7 What’s next? 
The next module in this series will explain and discuss local classes. A future module will explain anonymous 
classes. 


4.2.5.8 Complete program listing 


A complete listing of the program discussed in this module is show in Listing 25 (p. 1515) . 


4.2.5.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Member Classes 
e File: Javal636.htm 

e Published: 11/18/13 

e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.2.5.10 Images 


Image 1 . Class files produced when the program is compiled. 


A$B$C$D. class 
A$B$C. class 
A$B.class 
A.class 
InnerClasses06.class 
X.class 


Table 4.38 
Image 2 . Screen output. 
In xstr for A, objCntA = 1 
Table 4.39 
Image 3 . Screen output. 
In xstr for A, objCntA = 1 
In xstr for B, objCntB = 1 
Table 4.40 


Image 4 . Screen output. 


continued on next page 
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In xstr for A, objCntA = 1 
In xstr for B, objCntB = 1 
1 


In xstr for C, objCntC = 


Table 4.41 


Image 5 . Screen output. 


Construct obj of private class D. 
Private class file name: A$B$C$D 


Table 4.42 


Image 6 . Screen output. 


In xstr for A, objCntA = 2 
In xstr for B, objCntB = 2 


Table 4.43 


Image 7 . Screen output. 


zie 
In cShow, objNumber = 1 
In cShow, cVar = 3 


Table 4.44 


Image 8 . Screen output. 


-2- 
In bShow, bVar = 2 
In bShow, objNumber 
In aShow, aVar = 1 
In aShow, objNumber 


Ul 
BE 


Il 
m 


Table 4.45 
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Image 9 . Screen output. 


ig 


In aShow, aVar = 1 
In aShow, objNumber = 1 


Table 4.46 


Image 10 


. Screen output. 


Table 4.47 


Image 11 


. Screen output. 


Table 4.48 


Image 12 


. Screen output. 


-6- 


Table 4.49 


Image 13 


. Screen output. 


continued on next page 
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age 
In cShow, bVar = 20 
A$B 

In cShow, aVar = 10 
A 


Table 4.50 


Image 14 . Screen output. 


-8- 
In bShow, bVar = 20 
In bShow, objNumber = 2 
In aShow, aVar = 1 
In aShow, objNumber = 1 


Table 4.51 


Image 15 . Screen output. 


-9- 
In aShow, aVar = 10 
In aShow, objNumber = 2 


Table 4.52 


Image 16 . Screen output. 


-10- 
className = C 
toString in Class C 
className = X 
toString in Class X 


Table 4.53 


4.2.5.11 Listings 
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Listing 1 . The main method. 


public class InnerClasses06{ 
public static void main(String[] args){ 
new A(1).new B(2).new C(3).cShow() ; 
}//end main 
}//end class InnerClasses06 


Table 4.54 


Listing 2 . The class named X. 


class X{//extends Object by default 
protected String className = "X"; 


public String toString(){ 
return "toString in Class X"; 
}//end overridden toString 
}//end class X 


Table 4.55 


Listing 3 . Beginning of the top-level class named A. 


class Af 
private int aVar; 
private int objNumber = 0; 


private static int objCntA = 0; 
private static int objCntB 
private static int objCntC 


oll 
ome) 


Table 4.56 
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Listing 4 . Constructor for class A. 


A(int val){//top-level class constructor 
aVar = val; 
objCntA++;//Increment object counter 
//Record the number of the object being 
// instantiated 
objNumber = objCntA; 
System. out .print1n( 

"In xstr for A, objCntA = " + objCntA); 

}//end constructor 


Table 4.57 


Listing 5 . Beginning of the member class named B. 


class B{//member class of A 
private int bVar; 
private int objNumber = 0; 


Table 4.58 


Listing 6 . Constructor for class B. 


B(int val){//constructor 

bVar = val; 

//Increment static variable in top-level 

// class named A 

A.objCntB++; 

//Record the number of the object being 

// instantiated 

objNumber = objCntB; 

System.out .print1n( 

"In xstr for B, objCntB = " + objCntB); 

}//end constructor 


Table 4.59 
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Listing 7 . Beginning of the member class named C. 


class C extends X{//member class of B 
private int cVar; 
private A refToA; 
private B refToB; 
private String className = "C"; 
private int objNumber = 0; 


Table 4.60 


Listing 8 . Beginning of constructor for class C. 


C(int val) {//constructor 
cVar = val; 
//Increment the object counter in the 
// top-level class named A. 
A.objCntC++; 
objNumber = A.objCntC; 
System. out. print1n( 
"In xstr for C, objCntC = " 
+ A.objCntC) ; 


Table 4.61 


Listing 9 . The private member class named D. 


private class D{//member class of C 
D(){//constructor 
System.out.print1n( 
"Construct obj of private class D."); 
System.out.print1n( 
" Private class file name: " 
+ this.getClass() .getName()) ; 
}//end constructor 
}//end class D 


Table 4.62 
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Listing 10 . More constructor code for class C. 


new DQ); 


Table 4.63 


Listing 11 . More constructor code for class C. 


refToA = new A(10); 
refToB = new B(20); 


}//end constructor 


Table 4.64 


Listing 12 . The method named bShow. 


private void bShow(){ 
System.out .print1n( 


"In bShow, bVar = " + bVar); 
System.out .print1n( 
"In bShow, objNumber = " + objNumber); 
aShow() ; 
}//end bShow 
Table 4.65 


Listing 13 . The method named aShow. 


private void aShow()f{ 
System. out. print1n( 


"In aShow, aVar = " + aVar); 
System. out. print1n( 
"In aShow, objNumber = " + objNumber); 
}//end aShow 
Table 4.66 
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Listing 14 . Beginning of the cShow method. 


public void cShow(){ 
System. out.println("-1-") ;//separator 
System. out. print1n( 


"In cShow, objNumber = " + objNumber); 
System. out. print1n( 

"In cShow, cVar = " + cVar); 

Table 4.67 


Listing 15 . More cShow method code. 


System. out.println("-2-") ;//separator 


bShow() ; 


Table 4.68 


Listing 16 . Call the aShow method. 


System. out.println("-3-") ;//separator 


aShow(); 


Table 4.69 


Listing 17 . More cShow method code. 


System. out.println("-4-") ;//separator 


System. out.println(getClass() .getName()) ; 
System. out. print1n( 
this.getClass() .getName()); 
System. out. print1n( 
C.this.getClass() .getName()) ; 
System. out. print1n( 
B.C.this.getClass() .getName()); 
System. out. print1n( 
A.B.C.this.getClass() .getName()); 


Table 4.70 
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Listing 18 . More cShow method code. 


System. out.println("-5-") ;//separator 


System. out. print1n( 
B.this.getClass() .getName()); 

System. out. print1n( 
A.B.this.getClass() .getName()); 


Table 4.71 


Listing 19 . More cShow method code. 


System. out.println("-6-") ;//separator 


System. out. print1n( 
A.this.getClass() .getName()) ; 


Table 4.72 


Listing 20 . More cShow method code. 


System.out.println("-7-"); 


System. out. print1n( 
"In cShow, bVar = " + refToB.bVar) ; 

System. out. print1n( 
refToB.getClass() .getName()) ; 


System. out. print1n( 
"In cShow, aVar = " + refToA.aVar) ; 

System. out. print1n( 
refToA.getClass() .getName()) ; 


Table 4.73 


Listing 21 . More cShow method code. 


System.out.println("-8-"); 


refToB.bShow() ; 
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Table 4.74 
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Listing 22 . More cShow method code. 


System.out.println("-9-"); 


refToA.aShow(); 


Table 4.75 


Listing 23 . Overridden toString method in class C. 


public String toString(){ 
return "toString in Class C"; 
}//end overridden toString 


Table 4.76 


Listing 24 . More cShow method code. 


System.out.printin("-10-"); 
System. out. print1n( 
"className = " + className); 
System. out.println(toString(); 


System. out. print1n( 
"className = " + super.className) ; 
System. out.println(super.toString()); 
}//end cShow method 


Table 4.77 
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Listing 25 . Complete program listing. 


/*File InnerClasses06. java 
Copyright 2003 R.G.Baldwin 


Rev 6/22/03 


Illustrates the use of member classes. Class B 
is a member class of class A. Class C isa 
member class of class B. Class D is a private 
member class of class C. An object is 
instantiated from the class named A, which makes 
it possible to instantiate an object of the 
member class named B. According to Flanagan, 
this causes the object of the Class B to be 
internally associated with the object of the 
class named A. The object of the class named B 
is used to instantiate an object of the member 
class named C. This object is internally 
associated with the object of the class B. 


When the object of the class C is instantiated, 
the constructor for that class instantiates 
separate objects of the classes named A and B and 
also instantiates an object of the private member 
class named D. The new and separate object of 
the class B continues to be internally associated 
with the original object of the Class A. 


A variety of operations are performed from within 
methods belonging to the object of the Class C to 
illustrate the various characteristics of objects 
instantiated from member classes. Comments in 
the code explain the purpose of each of those 
operations. 


The compilation of this program produces the 
following class files: 


A$B$C$D.class 

A$B$C. class 
A$B.class 

A.class 
InnerClasses06.class 
X.class 


The output from this program is shown below: 


In xstr for A, objCntA = 1 
In xstr for B, objCntB = 1 
In xstr for C, objCntC = 1 


Construct obj of private class D. . 

Private clase payailable for Treg ag Ggqynexions <http://cnx.org/content /col11441/1.181> 
In xstr for A, objCntA = 2 
In xstr for B, objCntB = 2 


sis 
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Table 4.78 


-end- 


4.2.6 Java OOP: Local Classes™ 
4.2.6.1 Table of Contents 
e Preface (p. 1516) 


Viewing tip (p. 1517) 


x Images (p. 1517) 
x Listings (p. 1517) 


e Preview (p. 1517) 


What can you include in a class definition? (p. 1517) 
What is a local class? (p. 1518) 

Why use local classes? (p. 1518) 

Local classes versus member classes (p. 1519) 

The scope of a local class (p. 1519) 

Restrictions on local classes (p. 1519) 


e Discussion and sample code (p. 1520) 


Class hierarchy (p. 1520) 
Overall program structure and behavior (p. 1520) 


x The controlling class (p. 1521) 

x The class named X (p. 1521) 

x The class named Y (p. 1521) 

x The class named A (p. 1522) 

x The local class named B (p. 1523) 


Run the program (p. 1525) 
Summary (p. 1525) 

What’s next? (p. 1526) 
Miscellaneous (p. 1526) 

Complete program listing (p. 1527) 


4.2.6.2 Preface 


This module is one in a collection of modules designed for teaching ITSE2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 


(Editor’s note: As you read this module, you will see that it was originally written around 2003. 
However, despite many improvements in Java since then, most of what was true then is still true 
in 2013.) 


This module makes several references to my website, which is located at 
http://www.dickbaldwin.com/toc.htm *° . 


34This content is available online at <http://cnx.org/content /m44346/1.4/>. 
35http://www.dickbaldwin.com/toc.htm 
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4.2.6.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the Images and listings while you are reading about them. 


4.2.6.2.1.1 Images 


e Image 1 (p. 1528) . Class files produced by the program. 
e Image 2 (p. 1528) . Screen output. 
e Image 3 (p. 1528) . Screen output. 
e Image 4 (p. 1528) . Screen output. 
e Image 5 (p. 1529) . Screen output. 
e Image 6 (p. 1529) . Screen output. 
e Image 7 (p. 1529) . Screen output. 
e Image 8 (p. 1529) . Screen output. 
e Image 9 (p. 1530) . Screen output. 


4.2.6.2.1.2 Listings 


e Listing 1 (p. 1530) . The controlling class named InnerClasses07. 
e Listing 2 (p. 1531) . The class named X. 

e Listing 3 (p. 1531) . The class named Y. 

e Listing 4 (p. 1531) . Beginning of the class named A. 

e Listing 5 (p. 1532) . The showA method in class A. 

e Listing 6 (p. 1532) . The delay method in class A. 

e Listing 7 (p. 1532) . Beginning the meth method in class A. 

e Listing 8 (p. 1532) . Set value of blank final variable. 

e Listing 9 (p. 1533) . Beginning of class definition for local class B. 
e Listing 10 (p. 1533) . Instantiate two objects of local class B. 

e Listing 11 (p. 1533) . Call showB on the first object. 

e Listing 12 (p. 1534) . Beginning of showB method in local class B. 
e Listing 13 (p. 1534) . More code from showB method. 

e Listing 14 (p. 1534) . Use of the keyword this. 

e Listing 15 (p. 1535) . Illustrate the inheritance hierarchy. 

e Listing 16 (p. 1535) . Call showB method on second object. 

e Listing 17 (p. 1536) . Complete program listing. 


4.2.6.3 Preview 
4.2.6.3.1 What can you include in a class definition ? 


There are several different kinds of items that can be included in a class definition. As you learned in the 
earlier modules in this series, the list includes: 


Static variables 
Instance variables 
Static methods 
Instance methods 
Constructors 

Static initializer blocks 
Instance initializers 
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Can also contain other class definitions 
As you learned in the previous module *° , a class definition can also contain the following three kinds of 
inner Classes: 


e Member classes 
e Local classes 
e Anonymous classes 


The previous module explained member classes. This module will explain local classes. The next module 
will explain anonymous classes. 


4.2.6.3.2 What is a local class ? 


A local class is a class that is defined within a block of Java code. While local classes are probably most 
frequently defined within methods and constructors, they can also be defined inside static initializer blocks 
and instance initializers. 

As is the case for an object of a member class (discussed in the previous module *" ), an object of a 
local class must be internally linked to an object of the enclosing class. I will often refer to that object as 
the containing object, and make comments about the containment hierarchy. 

A local class is truly an inner class, because an object of the local class cannot exist in the absence of an 
object of the enclosing class. 

What about a local interface? 

Interfaces defined within classes are implicitly static. This means that they are always top-level. There 

is no such thing as a member interface, a local interface, or an anonymous interface. 


4.2.6.3.3 Why use local classes ? 


Objects instantiated from local classes share many of the characteristics of objects instantiated from member 
classes. However, in some cases, a local class can be defined closer to its point of use than would be possible 
with a member class, leading to improved code readability. 

Probably the most important benefit of local classes has to do with accessing the members of enclosing 
classes. Just like with member classes, methods of a local class have direct access to all the members of 
the enclosing classes, including private members. Thus the use of local classes can sometimes eliminate the 
requirement to connect objects together via constructor parameters. 


(We will also see in the example program in this module that methods of a local class have direct 
access to protected members of the superclass of the enclosing class.) 


Can be particularly useful when ... 
A local class can be particularly useful in those cases where 


e There is no reason for an object of the local class to exist in the absence of an object of the enclosing 
class 
There is no reason for an object of the local class to exist outside a method of the enclosing class 
Methods of the object of the local class need access to members of the object of the enclosing class 
Methods of the object of the local class need access to final local variables and method parameters 
belonging to the method in which the local class is defined 


This module approaches local classes from a somewhat theoretical viewpoint. The next module will approach 
local classes from a more practical viewpoint, including a comparison between local classes and anonymous 
classes. 


36http://cnx.org/content /m44347 /latest /?collection=col11441 /latest 
87http://cnx.org/content /m44347 /latest /?collection=col11441 /latest 
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4.2.6.3.4 Local classes versus member classes 


A local class has approximately the same relationship to a member class that a local variable in a method 
has to an instance variable of the class containing the method. 


4.2.6.3.5 The scope of a local class 


As is the case with local variables, the name of a local class is visible and usable only within the block of 
code in which it is defined (and blocks nested within that block). Further, the name of the local class is 
visible and usable only to code following the class definition within that block. 

The methods of a local class can use any final local variables or method parameters that are visible 
from the scope in which the local class is defined. 

Similar to member classes 

As mentioned earlier, local classes have many characteristics in common with member classes. This 
includes access to private fields and methods in the containing class. The thing that separates local classes 
from member classes is the fact that local classes have access to local variables in the scope in which the 
local class is defined. 

A big restriction 

There is a big restriction, however, on the ability of methods of the local class to access local variables 
and method parameters. The methods in a local class can access local variables and method parameters 
only if they are declared final 

What does Flanagan have to say? 

According to one of my favorite authors, David Flanagan, author of Java in a Nutshell, the methods in 
a local class don’t really have access to local variables and method parameters. Rather, when an object of 
the local class is instantiated, copies of the final local variables and method parameters referred to by the 
object’s methods are stored as instance variables in the object. The methods in the object of the local class 
really access those hidden instance variables. (See the later section entitled Smoke and mirrors.) 

Thus, the local variables and method parameters accessed by the methods of the local class must be 
declared final to prevent their values from changing after the object is instantiated. 


4.2.6.3.6 Restrictions on local classes 


As with member classes, local classes cannot contain static members. 
As with local variables, local classes cannot be declared public , protected , private , or static 


A local class cannot have the same name as any of its enclosing classes. 

Smoke and mirrors 

As I mentioned in the previous module, every class definition in a Java program, including nested top- 
level classes, member classes, local classes, and anonymous classes, produces a class file when the program 
is compiled. According to Flanagan, 


"The Java Virtual Machine knows nothing about nested top-level classes and interfaces or the 
various types of inner classes. Therefore, the Java compiler must convert these new types into 
standard non-nested class files that the Java interpreter can understand. This is done through 
source code transformations that insert $ characters into nested class names. These source code 
transformations may also insert hidden fields, methods, and constructor arguments into the 
affected classes." 


A reference to the containing object 

For example, the compiler automatically inserts a private instance variable in the local class to hold a 
reference to the containing object. It also inserts a hidden argument in all constructors for the local class, and 
passes the containing object’s reference to the constructor for the local class. The modified constructor saves 
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that reference in the private instance variable of the object of the local class. Thus each object instantiated 
from the local class contains a private reference to the containing object. 

Accessing private members 

In those cases where it is necessary for an object of the local class to access private members of the 
containing object, the compiler automatically creates and uses accessor methods that make such access 
possible. 

Similar to your code 

The bottom line is that the code that is automatically produced by the compiler is probably very similar 
to code that you would write if you were writing the program using only top-level classes. The good news is 
that you don’t have to write that extra code, and you don’t have to maintain it. The extra code is written 
for you, and if you modify your class structure, the extra code is automatically modified accordingly. 


4.2.6.4 Discussion and sample code 


The paragraphs that follow will explain a program named InnerClasses0O7 . This program is designed 
specifically to illustrate various characteristics of local classes. I will discuss the program in fragments. A 
complete listing is shown in Listing 17 (p. 1536) near the end of the module. 

This program illustrates the use of local classes. The program consists of a total of five classes: 


e Four top-level classes named 


InnerClasses07 
A 
X 
Y 


e A local class named B. 


When compiled, the program produces the class files shown in Image 1 (p. 1528) . The file named A$1$B.class 
represents the local class. The remaining files in Image 1 (p. 1528) represent the four top-level classes. 


4.2.6.4.1 Class hierarchy 


In the previous module, I explained that once you understand the class file naming convention, you can 
determine from the file names how top-level classes and member classes are structured. However, the 
situation isn’t nearly so clear when it comes to local classes and anonymous classes. This will become more 
apparent in the next module, which combines local classes and anonymous classes. 


4.2.6.4.2 Overall program structure and behavior 


Containment hierarchy 

The program named InnerClasses07 defines a local class named B inside an instance method named 

meth 

The method named meth is an instance method of a top-level class named A . The method named 
meth instantiates two separate objects of the local class named B , and calls a method named showB 
on each of them. 

The method named showB displays certain data values that illustrate the characteristics of local 
classes, as well as the containment hierarchy among objects of the local class and an object of the containing 
class. 

In this case, objects of the class named B are contained within an object of the class named A 
(The class named A is an enclosing class of the class named B .) 

Inheritance hierarchy 
The top-level class named A extends the top-level class named X , (which in turn, extends Object 
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The class named B is contained in or enclosed by the top-level class named A , but extends the 
top-level class named Y , (which in turn, extends Object ). 

There is no inheritance relationship between the classes X and Y (aside from their common superclass 
named Object ). 

There is no inheritance relationship between the classes A and B 

The method named showB also displays data values that are intended to demonstrate that the 
inheritance hierarchy is independent of the containment hierarchy. 


(Note that while the containment hierarchy of local classes is independent of the inheritance 
hierarchy, it is technically possible to establish an inheritance relationship between a local class 
and one of its enclosing classes. For example, by making a couple of minor modifications, it is 
possible to cause the local class B in this program to extend the enclosing class A instead of 
the top-level class Y .) 


4.2.6.4.2.1 The controlling class 


The entire controlling class named InnerClasses07 , including the main method and a static variable 
named baseTime , is shown in Listing 1 (p. 1530) . 

The static variable named baseTime is initialized with the current date and time in milliseconds 
(relative to January 1, 1970). This static variable is used later as a base to establish the relative points in 
time that certain activities occur during the execution of the program. 

The main method 

The main method shown in Listing 1 (p. 1530) instantiates a new object of the class named A and 
calls the method named meth on that object. 

This method will sequentially instantiate two separate objects of a local class named B that is defined 
inside the method named meth . Then the method named meth will call a method named showB on 
each of those objects, causing them to display data values that illustrate the characteristics of local classes. 


4.2.6.4.2.2 The class named X 


The top-level class named X is shown in Listing 2 (p. 1531) . 

The class named A extends this class to illustrate the difference between the inheritance hierarchy and 
the containment hierarchy. Note that this class defines and initializes a protected instance variable, which 
will be accessed later to illustrate the inheritance hierarchy. 


(Somewhat surprisingly, you will also see later that this protected instance variable belonging 
to the superclass of the enclosing class A is also accessible by methods belonging to an object 
of the local class via the containment hierarchy.) 


4.2.6.4.2.3 The class named Y 


The top-level class named Y is shown in Listing 3 (p. 1531) . 

The local class named B extends this class to illustrate the difference between the inheritance hierarchy 
and the containment, hierarchy. 

Note that this class defines and initializes a protected instance variable. It also overrides the toString 
method, which is inherited from the Object class. 

The instance variable and the overridden toString method will be accessed later to illustrate the 
inheritance hierarchy. 
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4.2.6.4.2.4 The class named A 


The code in Listing 4 (p. 1531) shows the beginning of the top-level class named A . 

This code declares and initializes a private instance variable named aTime , which establishes the 
relative time that an object of class A is instantiated. 

This private instance variable will be accessed directly by code belonging to an object of the local class 
B_, which is contained by an object of the class A 

Listing 4 (p. 1531) also shows the constructor for class A , which displays the time whenever an object 
is instantiated from class A 

The screen output 

The code shown earlier in the main method of Listing 1 (p. 1530) instantiates an object of class A . 
This causes the screen output shown in Image 2 (p. 1528) . 


(Note that the relative time output value on your system may be different, depending on the 
speed of your system and the impact of other applications that may be running concurrently.) 


The private showA method 
Listing 5 (p. 1532) shows a private method named showA . This method displays the following 
information about an object instantiated from class A 


The relative time that the object was instantiated. 
The value of the instance variable named xVar , which is an instance variable of the superclass of 
class A 

e The name of the class file that represents the class named A 


Code in methods belonging to an object of the local class named B , contained in an object of class A , 
has direct access to private members of objects of the containing or enclosing class. 

The private showA method will be called by a method named showB , belonging to an object of 
the local class B , to demonstrate the truth of this statement. 

The method named delay 

Listing 6 (p. 1532) shows a utility method named delay , which is an instance method of class A 

The purpose of the delay method is simply to insert a 30-millisecond delay in the execution of the 
program. This method is used to cause certain activities in the execution of the program to be spread far 
enough apart in time to make them distinguishable, one from the other, on the basis of relative time. 

The method named meth 

The method named meth is an instance method of the class A . The beginning of this method is 
shown in Listing 7 (p. 1532) . 

The method named meth contains a local class definition for a class named B , which we will examine 
later. 

As you can see in Listing 7 (p. 1532) , it also declares a final local variable named methTime . As 
you will see later, the method named meth _ instantiates two separate objects of local class B and calls a 
method named showB on each of those objects. 

The method named showB displays various data values that illustrate the characteristics of local 
classes, including the value of the final local variable named methTime . 

Access to final local variables 

One of the characteristics of a local class is that objects of a local class have access to local variables 

within the same scope, provided that those local variables are declared final . 
Blank final variables 

The code in Listing 7 (p. 1532) declares a final local variable named methTime . Because of the 
syntax used, this variable is known as a blank final variable. A blank final variable is not initialized 
when it is declared. 

As with all local variables, the variable cannot be used until a value has been assigned to it. Because this 
variable is declared final , once a value has been assigned to it, the value cannot be changed throughout 
the remaining life of the variable. 
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Set value of blank final variable 
The code in Listing 8 (p. 1532) 


Inserts a delay 

Sets a value for the final local variable named methTime 
Displays the value that was set in methTime 

Inserts an additional delay before continuing 


The value that is set in the variable named methTime is the relative time that the statement is executed. 
The screen output 
The code in the main method of Listing 1 (p. 1530) calls meth on a new object of class A 
producing the screen output shown in Image 3 (p. 1528) . 


3 


(Once again, the actual time value displayed by your system may be different, depending on the 
speed of your system and other factors as well.) 


4.2.6.4.2.5 The local class named B 


The next block of code in the method named meth is the definition of a local class named B . The 
beginning of the class definition for local class B is shown in Listing 9 (p. 1533) . 

As with local variables, the class definition for a local class must appear before the code that attempts to 
instantiate the class. Code in the method named meth following the local class definition will instantiate 
and exercise objects of class B 

Local class B extends top-level class Y . This was done to illustrate that the inheritance hierarchy is 
independent of the containment. hierarchy. 

The constructor 

The code in Listing 9 (p. 1533) declares a private instance variable named bTime _, which is used to 
store the relative time that an object of class B is constructed. 

Listing 9 (p. 1533) also shows the constructor for local class B , which establishes, saves, and then 
displays the relative time that that an object is instantiated. 


(I will show you the screen output produced by this constructor shortly as I discuss code that 
instantiates objects of this class.) 


Instantiate two objects of class B 

At this point, I am going to temporarily set aside the discussion of local class B and discuss code in 
the method named meth that immediately follows the definition of local class B . This code is shown in 
Listing 10 (p. 1533) . 

Listing 10 (p. 1533) shows the beginning of code that is called when the method named meth is called. 
This code begins by instantiating two objects from the class named B , with a delay inserted between the 
instantiation of the two objects. 

The screen output 

The code in Listing 10 (p. 1533) , in conjunction with the constructor code in Listing 9 (p. 1533) 
produces the screen output shown in Image 4 (p. 1528) as each of the two objects of local class B are 
instantiated. 

Call showB on the first object 

Following this, the code in the method named meth calls the method named showB on each of the 
two objects. The method named showB will, in turn, call the method named showA on the containing 
object instantiated from the class named A . The third line of code in Listing 11 (p. 1533) calls the method 
named showB on the first object instantiated in Listing 10 (p. 1533) . 

The method named showB 

That brings us back to a discussion of the method named showB , which is an instance method of 

local class B . The beginning of the showB method is shown in Listing 12 (p. 1534) . This method 
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displays several private and protected variables, some of which belong to the containing object instantiated 
from the top-level class named A 


(Note that code in this method has direct access to xVar , which is a protected member 
variable of the superclass of the class named A .) 


Items that are displayed 
The code in Listing 12 (p. 1534) displays 


A visual line separator, -1- 
A private instance variable, bTime_ , belonging to the object instantiated from local class B 
A private instance variable, aTime , belonging to the containing object instantiated from the top-level 
class A 

e A final local variable, methTime , belonging to the method named meth , in which the local 
class B is defined 

e A protected instance variable, xVar_ , of the superclass of the class A , from which the containing 
object was instantiated. 
A protected instance variable, yVar_ , of the superclass of the local class B 
The name of the class file that represents the local class B 


The screen output 

The combined code in Listing 11 (p. 1533) and Listing 12 (p. 1534) produces the output shown in Image 
5 (p. 1529) for the first object instantiated from local class B 

Call private method showA 

One of the important characteristics of local classes is that the methods of objects instantiated from local 
classes have direct access to all of the members, including private members, of all the containing classes in 
the containment hierarchy. 


(In this case, an object of the local class B has only one containing class, an object instantiated 
from the top-level class A .) 


Continuing with the method named showB , in local class B , the code in Listing 13 (p. 1534) displays 
a line separator, -2-, and then calls the private method named showA on the containing object. This 
illustrates the containment hierarchy. 

The screen output 

The method named showA is shown in Listing 5 (p. 1532) . The combination of the code in Listing 
13 (p. 1534) and Listing 5 (p. 1532) produces the screen output shown in Image 6 (p. 1529) . 

Image 6 (p. 1529) displays 


e The relative time that the containing object of the class A was instantiated 

e A protected instance variable in the superclass of the class from which the containing object was 
instantiated 

e The name of the class file that represents the top-level class named A 


Use of the keyword this 

As is the case with member classes, (discussed in the previous module), objects of local classes use a 
special syntax of the keyword this to gain access to objects in the containment hierarchy. 

The code in Listing 14 (p. 1534) shows how to use regular syntax to gain access to the current object, 
and how to use special syntax to gain access to the containing object. 

Having gained access to the two objects, the code in Listing 14 (p. 1534) gets and displays the values of 
private instance variables belonging to those objects. 

The screen output 

The code in Listing 14 (p. 1534) produced the screen output shown in Image 7 (p. 1529) . 
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You saw these same two values displayed earlier in Image 4 (p. 1528) and Image 2 (p. 1528) . 

Illustrate the inheritance hierarchy 

Remember that the inheritance hierarchy is independent of the containment hierarchy. The code in 
Listing 15 (p. 1535) illustrates the inheritance hierarchy by 


e Calling the overridden toString method belonging to the local class B 
e Using the super keyword to call the overridden toString method belonging to the class Y , 
which is the superclass of the local class B 


Listing 15 (p. 1535) also defines the overridden toString method belonging to local class B . The 
overridden toString method belonging to class Y is shown in Listing 3 (p. 1531) . 

The screen output 

The combined code in Listing 15 (p. 1535) and Listing 3 (p. 1531) produces the screen output shown in 
Image 8 (p. 1529) . (Once again, you have seen these same values displayed in earlier Images.) 

That concludes the results of calling the showB method on the first object instantiated from local class 
B. 

Call showB method on second object 

The code in Listing 10 (p. 1533) instantiated two objects from local class B , and saved the object’s 
references in instance variables named obj1l and obj2 . The screen output that I have been discussing 
resulted from calling the showB method on objl in Listing 11 (p. 1533) . 

Listing 16 (p. 1535) calls the showB method on obj2 . Listing 16 (p. 1535) also signals the end of 
the method named meth , and the end of the class named A . 

The screen output The code in Listing 16 (p. 1535) produces the screen output shown in Image 9 
(p. 1530) 

Important considerations The important things to note about the output shown in Listing 16 (p. 
1535) include: 


e The second object instantiated from local class B is definitely a different object from the first object 
instantiated from local class B_, as evidenced by a different value for bTime . (Compare the value 
of bTime in Image 9 (p. 1530) with the value of bTime in Image 5 (p. 1529) .) In other words, 
the second object was instantiated after the first object was instantiated. 

e Even though the two objects instantiated from local class B are different objects, they both belong 
to the same containing object, as evidenced by the same values for aTime in Image 9 (p. 1530) and 
Image 5 (p. 1529) . 

e The two objects instantiated from local class B each access the same final local variable belonging 
to the method named meth , as evidenced by the same values for methTime in Image 9 (p. 1530) 
and Image 5 (p. 1529) . 


4.2.6.5 Run the program 


I encourage you to copy the code from Listing 17 (p. 1536) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


4.2.6.6 Summary 


In addition to a number of other items, a class definition can contain: 


Member classes 

Local classes 

Anonymous classes 

Nested top-level classes and interfaces 
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Member classes were explained in the previous module. This module explains local classes. The next module 
will explain anonymous classes. 

A local class is a class that is defined within a block of Java code. While local classes are probably most 
frequently defined within method and constructors, they can also be defined inside static initializer blocks 
and instance initializers. 

An object of the local class must be internally linked to an object of the enclosing class (which I often 
refer to as the containing object). A local class is truly an inner class because an object of the local class 
cannot exist in the absence of an object of the enclosing class. 

The methods of a local class have direct access to all the members in the hierarchy of enclosing classes, 
including private members. In addition, the methods of local classes have access to final local variables 
and final method parameters in the scope in which the local class is defined. 

The containment hierarchy of local classes is independent of the inheritance hierarchy. However, it is 
technically possible to establish an inheritance relationship between a local class and one of its enclosing 
classes. 

Local classes may not be declared public , protected , private , or static 

Local classes cannot contain static members. 

A local class has approximately the same relationship to a member class that a local variable in a method 
has to an instance variable of the class containing the method. 


4.2.6.7 What’s next? 


The next module in this series will explain and discuss anonymous classes, and will also compare anonymous 
classes to local classes. 


4.2.6.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Local Classes 
e File: Javal638.htm 

e Published: 11/19/13 

e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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4.2.6.9 Complete program listing 
A complete listing of the program is provided in Listing 17 (p. 1536) . 


4.2.6.10 Images 
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Image 1 . Class files produced by the program. 


A$1$B.class 

A.class 
InnerClasses07.class 
X.class 

Y.class 


Table 4.79 


Image 2 . Screen output. 


In xstr for A, aTime = 10 


Table 4.80 


Image 3 . Screen output. 


In meth, methTime = 40 


Table 4.81 


Image 4 . Screen output. 


Instantiate first B-object 
In xstr for B, bTime = 70 
Delay and instantiate second B-object 
In xstr for B, bTime = 100 


Table 4.82 


Image 5 . Screen output. 


continued on next page 
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Display first B-Object 

=f 

In showB, private bTime = 70 

In showB, private aTime = 10 

In showB, final methTime = 40 
In showB, protected xVar 1000 
In showB, protected yVar = 2000 
In showB, class name = A$1$B 


Table 4.83 
Image 6 . Screen output. 
Eps 
In showA, aTime = 10 
In showA, xVar = 1000 
In showA, class name = A 
Table 4.84 
Image 7 . Screen output. 
=e 
In showB, bTime = 70 
In showB, aTime = 10 
Table 4.85 
Image 8 . Screen output. 
-4- 
toString in class B, bTime = 70 
toString in class Y, yVar = 2000 
Table 4.86 
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Image 9 . Screen output. 


Display second B-Object 

=e 

In showB, private bTime = 100 

In showB, private aTime 10 

In showB, final methTime = 40 

In showB, protected xVar 1000 
In showB, protected yVar = 2000 
In showB, class name = A$1$B 

Oe 

In showA, aTime = 10 

In showA, xVar = 1000 

In showA, class name = A 

S34 

In showB, bTime = 100 

In showB, aTime 10 

Az 

toString in class B, bTime = 100 
toString in class Y, yVar = 2000 


Table 4.87 


4.2.6.11 Listings 


Listing 1 . The controlling class named InnerClasses07. 


public class InnerClasses07{ 
static long baseTime = new Date().getTime(); 


public static void main(String[] args){ 
new A().meth(); 
}//end main 
}//end class InnerClasses07 


Table 4.88 


Listing 2 . The class named X. 


class X{ 
protected int xVar = 1000; 
}//end class X 
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Listing 3 . The class named Y. 


class Y{ 
protected int yVar = 2000; 


public String toString(){ 
return "toString in class Y, yVar = " + yVar; 
}//end overridden toString 
}//end class Y 


Table 4.90 


Listing 4 . Beginning of the class named A. 


class A extends X{ 
private long aTime = new Date().getTime() - 
InnerClasses07.baseTime; 


AQ{//constructor 
System. out. print1n( 
"In xstr for A, aTime = " + aTime); 
}//end constructor 


Table 4.91 


Listing 5 . The showA method in class A. 


private void showA(){ 

System. out .print1n( 
"In showA, aTime = " + aTime); 

System. out .print1n( 
"In showA, xVar = " + xVar); 
System.out.println("In showA, class name = " 
+ getClass().getName()); 

}//end showA 


Table 4.92 
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Listing 6 . The delay method in class A. 


void delay(){ 
try{ 
Thread. currentThread() .sleep(30) ; 
}catch(InterruptedException e){ 
System.out.println(e); 
}//end catch 
}//end delay 


Table 4.93 


Listing 7 . Beginning the meth method in class A. 


void meth(){ 
final long methTime; 


Table 4.94 


Listing 8 . Set value of blank final variable. 


delay(); 
methTime = new Date().getTime() - 
InnerClasses07.baseTime; 
System. out. print1n( 
"In meth, methTime = " + methTime); 
delay(; 


Table 4.95 


Listing 9 . Beginning of class definition for local class B. 


class B extends Y{ 
private long bTime; 


B(){//constructor 
bTime = new Date().getTime() - 
InnerClasses07.baseTime; 
System. out. println( 
"In xstr for B, bTime = " + bTime); 
}//end constructor 
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Table 4.96 
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Listing 10 . Instantiate two objects of local class B. 


System. out. println("---------------------- 1 

System. out .print1n( 
"Instantiate first B-object"); 

final B obj1 = new B(); 
System. out .print1n( 

"Delay and instantiate second B-object"); 
delay(); 
final B obj2 = new B(); 


Table 4.97 


Listing 11 . Call showB on the first object. 


System. out. print1n("---------------------- wys 
System.out.println("Display first B-Object"); 
obji.showB() 


Table 4.98 


Listing 12 . Beginning of showB method in local class B. 


//Continuing with local class B definition 
void showB() { 
System. out.printin("-1-"); 
System. out. print1n( 


"In showB, private bTime = " + bTime); 
System. out. print1n( 
"In showB, private aTime = " + aTime); 


System. out. print1n( 
"In showB, final methTime = " + 
methTime) ; 

System. out. print1n( 


"In showB, protected xVar = " + xVar); 
System. out. print1n( 
"In showB, protected yVar = " + yVar); 


System. out. print1n( 
"In showB, class name = " + 
getClass () .getName()); 


Table 4.99 
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Listing 13 . More code from showB method. 


System. out.println("-2-"); 
showA() ; 


Table 4.100 
Listing 14 . Use of the keyword this. 
System. out.println("-3-"); 
System. out. print1n( 
"In showB, bTime = " + this.bTime) ; 
System. out. print1n( 
"In showB, aTime = " + A.this.aTime) 
Table 4.101 


Listing 15 . Illustrate the inheritance hierarchy. 


System. out.println("-4-") ; 
System. out.println(toString(); 
System. out.println(super.toString()); 

3//end showB 


//Overridden toString method 
public String toString(){ 
return 
"toString in class B, bTime = " + bTime; 
}//end overridden toString 
}//end local class B 


Table 4.102 
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Listing 16 . Call showB method on second object. 


System. out. print1n("---------------------- wS 
System. out .print1n( 
"Display second B-Object"); 
obj2.showB() ; 


}// end meth 
}//end class A 


Table 4.103 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1531 


Listing 17 . Complete program listing. 


/*File InnerClasses07. java 
Copyright 2003 R.G.Baldwin 


Illustrates the use of local classes. 


This program defines a local class named B inside 
an instance method named meth. The method named 
meth is an instance method of a class named A. 


The method named meth instantiates two separate 
objects of the local class named B, and calls 

on each of them a method named showB, which 
displays certain data values that illustrate the 
characteristics of local classes, a well as the 
relationships among objects of a local class and 
an object to which that object is internally 
associated. In this case, objects of the class 
named B are internally associated with an object 
of the class named A. 


This program produces the following class files 
when compiled: 


A$1$B.class 

A.class 
InnerClasses07.class 
X.class 

Y.class 


The file named A$1$B.class represents the local 
class named B. 


This program produces the following output: 


In xstr for A, aTime = 10 

In meth, methTime = 40 

Instantiate first B-object 

In xstr for B, bTime = 70 

Delay and instantiate second B-object 
In xstr for B, bTime = 100 

Display first B-Object 

=f- 

In showB, private bTime = 70 

In showB, private aTime = 10 

In showB, final methTime = 40 

In showB, protected xVar 1000 

In showB, protected yVar = 2000 

In showB, class name = A$1$B : 
tg vailable for free at Connexions <http://cnx.org/content/col11441/1.181> 
In showA, aTime = 10 

In showA, xVar = 1000 

In showA, class name = A 
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Table 4.104 


-end- 


4.2.7 Java OOP: Anonymous Classes”? 
4.2.7.1 Table of Contents 
e Preface (p. 1538) 


Purpose of this module (p. 1538) 
Viewing tip (p. 1538) 


x Images (p. 1538) 
x Listings (p. 1538) 


e Preview (p. 1539) 


What can you include in a class definition? (p. 1539) 
What is an anonymous class? (p. 1539) 

What about an anonymous interface? (p. 1539) 

Why use anonymous classes? (p. 1540) 

Anonymous classes versus local classes (p. 1540) 
Restrictions on the use of anonymous classes (p. 1540) 
Smoke and mirrors (p. 1541) 

Syntax for anonymous classes (p. 1541) 


e Discussion and sample code (p. 1542) 


Class file names (p. 1542) 
Program structure and behavior (p. 1543) 


* A local class (p. 1543) 

x Three anonymous classes (p. 1543) 

* The screen output (p. 1543) 

x The controlling class (p. 1544) 

* Local and anonymous classes inside GUI constructor (p. 1544) 
x The GUI class (p. 1544) 

x An anonymous inner class for low-level event handling (p. 1546) 
x Instantiating and registering a MouseListener object (p. 1546) 
x Extending the WindowAdapter class (p. 1548) 


The GUI remains on the screen until terminated (p. 1549) 
Simple event handlers (p. 1549) 


Run the program (p. 1549) 
Summary (p. 1549) 

Miscellaneous (p. 1550) 

Complete program listing (p. 1550) 
Images (p. 1550) 

Listings (p. 1553) 


38This content is available online at <http://cnx.org/content /m44342/1.4/>. 
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4.2.7.2 Preface 


This module is one in a collection of modules designed for teaching ITSE2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 


(Editor’s note: As you read this module, you will see that it was originally written around 2003. 
However, despite many improvements in Java since then, most of what was true then is still true 
in 2013.) 


This module makes several references to my website, which is located at 
http://www.dickbaldwin.com/toc.htm °° . 


4.2.7.2.1 Purpose of this module 


This module explains anonymous classes from a practical viewpoint, including a comparison between anony- 
mous classes and local classes. 


4.2.7.2.2 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and the listings while you are reading about them. 


4.2.7.2.2.1 Images 


e Image 1 (p. 1551) . Syntax for anonymous classes. 
e Image 2 (p. 1551) . Program GUI. 

e Image 3 (p. 1552) . Class file names. 

e Image 4 (p. 1552) . Screen output. 

e Image 5 (p. 1552) . Screen output. 

e Image 6 (p. 1552) . Screen output. 

e Image 7 (p. 1553) . Screen output. 

e Image 8 (p. 1553) . Screen output. 

e Image 9 (p. 1553) . Screen output. 


4.2.7.2.2.2 Listings 


e Listing 1 (p. 1553) . The controlling class. 

e Listing 2 (p. 1553) . Beginning of the GUI class. 

e Listing 3 (p. 1554) . Beginning of the BaldButton class. 

e Listing 4 (p. 1554) . The processMouseEvent method. 

e Listing 5 (p. 1554) . Beginning of anonymous inner class. 

e Listing 6 (p. 1555) . Overridden processMouseEvent method. 
e Listing 7 (p. 1555) . Register a MouseListener object. 

e Listing 8 (p. 1556) . Implementing the interface. 

e ( ) 

e 


Listing 9 (p. 1556) . Registering a WindowListener on the Frame . 
Listing 10 (p. 1557) . Complete program listing. 


3°http://www.dickbaldwin.com/toc.htm 
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4.2.7.3 Preview 
4.2.7.3.1 What can you include in a class definition ? 


There are several different kinds of items that can be included in a class definition. As you learned in the 
earlier modules in this series, the list includes: 


Static variables 
Instance variables 
Static methods 
Instance methods 
Constructors 

Static initializer blocks 
Instance initializers 


Can also contain other class definitions 
As you also learned in previous modules, a class definition can also contain the following kinds of inner 
classes: 


Member classes 

Local classes 

Anonymous classes 

Nested top-level classes and interfaces 


The previous two modules explained member classes and local classes. This module will explain anonymous 
classes. 


4.2.7.3.2 What is an anonymous class ? 


I’m going to begin my discussion with a quotation from one of my favorite authors, David Flanagan, author 
of Java in a Nutshell . 


"An anonymous class is essentially a local class without a name." 


If you have read the previous module, you should know quite a lot about local classes at this point in time. 
Continuing with Flanagan’s words, 


"Instead of defining a local class and then instantiating it, you can often use an anonymous Class 
to combine these two steps... an anonymous class is defined by a Java expression , not a Java 
statement . This means that an anonymous class definition can be included within a larger 
Java expression..." 


As you will see from the sample program in this module, anonymous class definitions are often included as 
arguments to method calls. 

As is the case for an object of a member class or a local class (discussed in previous modules), an object 
of an anonymous class must be internally linked to an object of the enclosing class. 

Thus, an anonymous class is truly an inner class, because an object of the anonymous class cannot exist 
in the absence of an object of the enclosing class. 


4.2.7.3.3 What about an anonymous interface ? 


Interfaces defined within classes are implicitly static. This means that they are always top-level. There is 
no such thing as a member interface, a local interface, or an anonymous interface. 
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4.2.7.3.4 Why use anonymous classes ? 


As with local classes, objects instantiated from anonymous classes share many of the characteristics of objects 
instantiated from member classes. However, in some cases, an anonymous class can be defined closer to its 
point of use than would be possible with a member class or a local class. Once you become accustomed to 
the somewhat cryptic syntax used with anonymous classes, this can often lead to improved code readability. 

Probably the most important benefit of anonymous classes has to do with accessing the members of 
enclosing classes. Just like with member classes and local classes, methods of an anonymous class have direct 
access to all the members of the enclosing classes, including private members. Thus the use of anonymous 
classes can often eliminate the requirement to connect objects together via constructor parameters. 

In addition, although not demonstrated in this module, as with local classes, objects of anonymous classes 
have access to final local variables that are declared within the scope of the anonymous class. 

Can be particularly useful when ... 

An anonymous class can be particularly useful in those cases where 


e There is no reason for an object of the anonymous class to exist in the absence of an object of the 
enclosing class. 

e There is no reason for an object of the anonymous class to exist outside a method of the enclosing 
class. 

e Methods of the object of the anonymous class need access to members of the object of the enclosing 
class. 

e Methods of the object of the anonymous class need access to final local variables and method 
parameters belonging to the method in which the anonymous class is defined. 
Only one instance of the anonymous class is needed. 
There is no need for the class to have a name that is accessible elsewhere in the program. 


4.2.7.3.5 Anonymous classes versus local classes 


Once again, according to David Flanagan, 


"an anonymous Class behaves just like a local class, and is distinguished from a local class 
merely in the syntax used to define and instantiate it." 


Unlike a local class, however, an anonymous class cannot define a constructor. However, an anonymous class 
can define an instance initializer, which can provide some of the benefits of a constructor. 


(I discussed instance initializers in detail in an earlier tutorial titled The Essence of OOP using 
Java, Instance Initializers 4° . As you may recall, a primary shortcoming of an instance initializer 
as compared to a constructor is that an instance initializer cannot accept incoming parameters.) 


4.2.7.3.6 Restrictions on the use of anonymous classes 


Because an anonymous class has no name, and the definition and instantiation of the class appear in a single 
expression, only one instance of each anonymous class can be created. If you need more than one instance 
of the class, you should probably use a local class, a member class, or a top-level class instead. 

As mentioned above, it is not possible to define constructors for anonymous classes. If you need to use 
a constructor when you instantiate the class, you should probably use a local class, a member class, or a 
top-level class instead. 

As with member classes and local classes, anonymous classes cannot contain static members. 

As with local variables and local classes, anonymous classes cannot be declared public , protected 
, private ,or static . In fact, no modifiers can be specified in the definition of an anonymous class. 


49http://cnx.org/content /m45597 /latest /Javal634.htm 
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4.2.7.3.7 Smoke and mirrors 


As I told you in my earlier modules on local classes, the methods in an anonymous class don’t really 
have access to local variables and method parameters. Rather, when an object of the anonymous class is 
instantiated, copies of the final local variables and method parameters referred to by the object’s methods 
are stored as instance variables in the object. The methods in the object of the anonymous class really access 
those hidden instance variables. 

Thus, the local variables and method parameters accessed by the methods of the local class must be 
declared final to prevent their values from changing after the object is instantiated. 

There are some additional activities involving smoke and mirrors taking place behind the scenes when 
you define and instantiate an anonymous class. Generally speaking, this involves the automatic generation 
of code to cause things to behave as they do. The good news is that you don’t have to write that extra code, 
and you don’t have to maintain it. The extra code is written for you, and if you modify your class structure, 
the extra code is automatically modified accordingly. 

You can read about the code that is automatically generated in my earlier modules on local classes and 
member classes. 


4.2.7.3.8 Syntax for anonymous classes 


Before getting into actual code in the sample program, I want to explain the syntax used to define and 
instantiate an anonymous class. 

The definition and instantiation of an anonymous class uses one or the other of the two expressions shown 
in Image 1 (p. 1551) . 

Usually, this expression is included inside a larger overall expression, such as an argument to a method 
call. 

What does the first expression mean? 

Here is how I usually explain this syntax to my students. The first expression in Image 1 (p. 1551) starts 
out fairly normal, but becomes cryptic very quickly. 

This expression instantiates a new object from an unnamed and previously undefined class. That class 
automatically extends the class named className , and cannot explicitly implement any interfaces. 

The body of the new class is given by classBody 

The result of executing this expression is that: 


e anew class that extends className is defined, 
e anew object of the new class is instantiated, and 
e the expression is replaced by a reference to the new object. 


Example usage 

If this expression appears as the right operand of an assignment operator, the new object’s reference is 
saved in the left operand of the assignment operator. 

If the expression appears as an argument in a method call, the new object’s reference is passed to the 
method. 

If the expression appears in some other form of larger overall expression, the new object’s reference is 
handed over to the surrounding expression to be used appropriately. 

What about instantiating an interface? 

The second expression in Image 1 (p. 1551) starts out very weird. To my knowledge, there is no other 
situation in Java where you apply the new operator to the name of an interface. 

From the beginning, you have been told (or should have been told) that you cannot instantiate an 
object of an interface. (An interface is implicitly abstract and it doesn’t have a constructor, not even a 
default constructor.) 

However, you can instantiate an object of a class that implements none, one, or more interfaces. 

The correct interpretation of the second expression in Image 1 (p. 1551) is as follows. This expression 
instantiates a new object from an unnamed and previously undefined class. That class automatically 
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implements the interface named interfaceName_, and it automatically extends the class named 
Object 

The class can explicitly implement one, and only one interface, and cannot extend any class other than 
Object 

Once again, the body of the new class is given by classBody 

As in the case of the first expression in Image 1 (p. 1551) , the result of executing this second expression 
is that 


e anew class that implements interfaceName is defined, 
e anew object of the new class is instantiated, and 
e the expression is replaced by a reference to the new object. 


That reference is handed over to the surrounding expression to be used appropriately. 

What about constructor parameters? 

As mentioned earlier in this module, since the new class doesn’t have a name, it isn’t possible to define 
a constructor for the new class. 

According to Flanagan (with regard to the first expression in Image 1 (p. 1551) ) , 


"Any arguments you specify between the parentheses following the superclass name in an anony- 
mous Class definition are implicitly passed to the superclass constructor." 


Thus, it is possible to define an anonymous class that extends a class whose constructor requires parameters, 
and to pass those parameters to the superclass constructor when the anonymous class is instantiated. 

The parentheses following interfaceName in the second expression in Image 1 (p. 1551) must always 
be empty. In this case, the superclass is always Object , which never expects constructor parameters. 


4.2.7.4 Discussion and sample code 


The paragraphs that follow will explain a program named InnerClasses08 . This program is designed 
specifically to illustrate anonymous classes, and to compare anonymous classes with local classes. 

I will discuss the program in fragments. A complete listing of the program is provided in Listing 10 (p. 
1557) . 

When the program is executed, it produces the GUI shown in Image 2 (p. 1551) . I will refer back to 
this image during the discussion of the program. 
4.2.7.4.1 Class file names 


This program consists of a total of six classes: 


e Two top-level classes 


InnerClasses08.class 
GUL.class 


e One local class 
GUI$1$BaldButton.class 
e Three anonymous classes 


GUI$1.class 
GUI$2.class 
GUI$3.class 


When compiled, the program produces the class files shown in Image 3 (p. 1552) . 
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(As you can see, the anonymous classes are not truly anonymous, since the files that represent 
them must have names. Generally, however, the establishment of the individual names is beyond 
the control of the programmer, and the names are not known to the program in a way that makes 
it possible to refer to them by name.) 


4.2.7.4.2 Program structure and behavior 


This program is designed to illustrate the use of local classes and anonymous classes in a very practical way. 
It illustrates one implementation of a local class and three different implementations of anonymous classes. 
The program compares the local class with an anonymous class designed to accomplish the same purpose. 
The program also illustrates the use of instance initializers as an alternative to constructors. 


4.2.7.4.2.1 A local class 


The program defines and uses a local class to instantiate an object to handle mouse clicked events on a 
button with low-level event handling. This class uses a constructor to enable mouse events on a new 
extended Button class. It also uses a constructor to display the name of the class file. 


4.2.7.4.2.2 Three anonymous classes 


An anonymous class to compare with the local class 

The program also defines and uses an anonymous class to instantiate an object to handle mouse clicked 
events on a button with low-level event handling. 

This class uses an instance initializer to enable mouse events on a new extended Button class. It also 
uses an instance initializer to display the name of the class file. 

This class and the local class described above provide a direct comparison between the use of local classes 
and anonymous classes to serve the same purpose. 

An anonymous class that implements an interface 

The program illustrates the use of an anonymous class that implements the MouseListener interface, 
to instantiate an object to handle mouse clicked events using the source-listener event model (sometimes 
referred to as the delegation event model or the JavaBeans event model). The anonymous class uses an 
instance initializer to display the name of the class file. 

An anonymous class that extends an existing class 

The program illustrates the use of an anonymous class that extends the WindowAdapter class, to 
instantiate an object to handle window events fired by the close button in the upper-right corner of the 
Frame object shown in Image 2 (p. 1551) . This class also uses the source-listener event model, and uses 
an instance initializer to display the name of the class file. 


4.2.7.4.2.3 The screen output 
The program produces the screen output shown in Image 4 (p. 1552) when 
e The program is started 


e Each button shown in Image 2 (p. 1551) is clicked once in succession, going from left to right 
e The close button in the upper-right corner of the Frame object in Image 2 (p. 1551) is clicked 


When the close button is clicked, the program produces the last line of text in Image 4 (p. 1552) and 
terminates. I will identify the code that produces each line of output text in the discussion of the program 
that follows. 
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4.2.7.4.2.4 The controlling class 


The controlling class for the program is shown in Listing 1 (p. 1553) . 
As you can see, the controlling class is very simple, with the main method instantiating an object of 
the GUI class. This results in the GUI that is pictured in Image 2 (p. 1551) . 


4.2.7.4.2.5 Local and anonymous classes inside GUI constructor 


The local class and the three anonymous classes are defined inside the constructor for the GUI class. 


(Recall that local classes and anonymous classes are defined inside code blocks, which often place 
them inside methods and constructors, but you can also place them inside static initializer blocks 
and instance initializers.) 


The first four lines of the output text in Image 4 (p. 1552) are produced by constructors and instance 
initializers in the local and anonymous classes. Therefore, those four lines of text are produced when the 
new object of the GUI class is instantiated. 


4.2.7.4.2.6 The GUI class 


As is often the case, the GUI class used to create the visual GUI shown in Image 2 (p. 1551) consists 
solely of a constructor. Basically, this constructor 


e places three buttons in the frame and 
e registers event handlers on the buttons and on the frame. 


Once the GUI object is constructed and appears on the screen, all further activity in the program occurs 
under control of the event handlers associated with the buttons and the frame. 


(You can learn more about event handling here *! .) 


The GUI constructor 

The GUI class, and the constructor for that class begin in Listing 2 (p. 1553) . 

As you can see, the GUI class extends Frame , so that an object of the class is a frame. 

The constructor code shown in Listing 2 (p. 1553) simply sets values for the layout, size, and title 
properties of the frame. 

The BaldButton class 

The definition of the BaldButton class begins in Listing 3 (p. 1554) . This is a local class that extends 
Button 

Extending the Button class makes it possible to override the processMouseEvent method in order 
to handle mouse events that are fired by the button. 

This is a form of low-level event handling that will be contrasted with source-listener event handling later 
in the program. 

Listing 3 (p. 1554) shows the constructor for the BaldButton class. 

Enable mouse events 

The most important code in the constructor is the statement that enables mouse events on the button. 

If you are unfamiliar with the enableEvents method, you should look it up in the Sun documentation. 
Briefly, this method must be called on the button to cause the overridden processMouseEvent method 
to be called later when the button fires a mouse event. 

The remaining constructor code 

The remaining code in the constructor 


e Sets the text value on the face of the button 


“1 http://cnx.org/content /m47842/latest /?collection=col11441 /latest 
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e Gets and displays the name of the class file that represents this local class 


The screen output 

Construction of the button by the code in Listing 3 (p. 1554) causes the text shown in Image 5 (p. 1552) 
to appear on the screen. This is how I was able to identify the name of the class file that represents the local 
class in my earlier discussion of class file names. 

We will see later that this button will be added as the leftmost button in the GUI shown in Image 2 (p. 
1551) . 

The processMouseEvent method 

Continuing with the constructor for the GUI class, Listing 4 (p. 1554) shows the overridden process- 
MouseEvent method for an object of the BaldButton class. 

This method is called each time an object instantiated from this class fires a mouse event. That is why 
I refer to the method as an event handler for the button. 

Different kinds of mouse events A button can fire a variety of different kinds or subcategories of 
mouse events : 


MOUSE_ CLICKED 
MOUSE_ DRAGGED 
MOUSE_ ENTERED 
MOUSE_ EXITED 
MOUSE_ MOVED 
MOUSE PRESSED 
MOUSE _ RELEASED 


In this case, I elected to ignore all but MOUSE _CLICKED . This subcategory of mouse event occurs 
when a mouse button is pressed and then released. 

The code in the event handler of Listing 4 (p. 1554) first confirms that the event was of the 
MOUSE_ CLICKED variety. If so, it displays a message that matches the fifth line of text in the out- 
put shown in Image 4 (p. 1552) . 

Call processMouseEvent on the superclass 

Without getting into the details of why this is required, I’m simply going to tell you that when you use 
this low-level event model to handle events, your overridden processMouseEvent method must call the 
same method in the superclass, passing the incoming parameter of type MouseEvent as a parameter to 
the superclass version of the method. 

Add a button to the frame 

The last statement in Listing 4 (p. 1554) instantiates a new BaldButton object, setting the text on 
the face of the button to A , and adds that new object to the frame. 

Because the layout property of the frame has been set to FlowLayout 4? , and because this is the first 
component added to the frame, this button appears as the leftmost button in the GUI shown in Image 2 (p. 
1551) . 

Could instantiate multiple buttons of this type 

Although I instantiated the button object as an anonymous object in this case, that wasn’t necessary. 
Using this local class, I could instantiate more than one object of this type, saving the object’s references in 
reference variables of the appropriate type. Later we will see that this is not possible for anonymous classes. 

It is interesting to note, however, that with this event handling model, if I were to instantiate multiple 
buttons of this type, the same processMouseEvent method would be called no matter which of the 
buttons fired a mouse event. If I wanted different behavior as a result of the different buttons firing mouse 
events, I would have to write code inside the processMouseEvent method to deal with that issue. 

The source-listener event model that I will illustrate later doesn’t suffer from that restriction. 


42http://cnx.org/content /m45597 /latest /Javal16.htm 
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4.2.7.4.2.7 An anonymous inner class for low-level event handling 


Listing 5 (p. 1554) shows the beginning of an anonymous class to perform low-level event handling similar 
to that shown in Listing 4 (p. 1554) . 

This code defines an anonymous inner class that implicitly extends Button and has mouse events 
enabled. I provided this class primarily for comparison with the local class named BaldButton . This 
class is an anonymous alternative to the local BaldButton class. 

An argument to the add method 

Note that the definition of this anonymous class appears as an argument to the add method for the 
frame. Thus, the anonymous object instantiated from the anonymous class is added as the second (middle) 
button in Image 2 (p. 1551) . 

Extends the Button class 

Note also that this form of anonymous class implicitly extends the Button class. Once again, this 

makes it possible to override the processMouseEvent method belonging to the Button class. 
An instance initializer 

As I mentioned earlier in this module, it is not possible to define a constructor for an anonymous class. 

However, it is possible to define an instance initializer. 


(In Listing 5 (p. 1554) , the instance initializer consists of two statements enclosed by matching 
curly brackets. ) 


This class defines an instance initializer that 


e Enables mouse events on an anonymous object instantiated from the anonymous class. 
e Gets and displays the name of the class file that represents the anonymous class. 


The screen output 

Therefore, the instantiation of this anonymous object causes the text shown in Image 6 (p. 1552) to 
appear on the screen. About all you can tell by looking at this class name is that it is the name of a file that 
represents an anonymous class. 

Overridden processMouseEvent method 

The remaining code in the anonymous class definition is shown in Listing 6 (p. 1555) . The code in 
Listing 6 (p. 1555) consists of 


e an overridden processMouseEvent method, plus 
e the curly brackets, parentheses, and semicolon necessary to complete the expression and the statement. 


Same code as before 

The code in this overridden processMouseEvent method is essentially the same as that shown for 
the local class in Listing 4 (p. 1554) , except that it produces a different message on the screen when the 
user clicks the button. 

Clicking the middle button in Image 2 produces the screen output shown by the sixth line in Image 4 (p. 
1552) . 


4.2.7.4.2.8 Instantiating and registering a MouseListener object 


Implementing a listener interface 

Now I’m going to switch from low-level event handling to source-listener event handling. The 
code to accomplish this begins in Listing 7 (p. 1555) . 

With this event handling model: 


e A listener object is instantiated from a class that implements a specific listener interface. In this case, 
that interface will be the MouseListener interface. 
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e The listener object is registered on an object that knows how to fire events of a type that is associated 
with the listener interface. In this case, that will be events of type MouseEvent 

e When the source object fires an event of the specified type, one of the methods belonging to the 
registered listener object will be called to handle the event. The different methods belonging to the 
listener object are declared in the implemented listener interface. 


Listing 7 (p. 1555) begins by instantiating a new Button object. 


(Note that with this event model, it is not necessary to extend the Button class, because it 
is not necessary to override methods belonging to the Button object.) 


Register a MouseListener object 

After instantiating the Button object, the code in Listing 7 (p. 1555) calls the addMouseListener 
method to register a MouseListener object on that button. The argument to the addMouseListener 
method must be a reference to an object instantiated from a class that implements the MouseListener 
interface. 

Instantiate the listener object 

In this case, that listener object is created by 


e writing an expression to instantiate an anonymous object from an anonymous class and 
e placing that expression as an argument to the addMouseListener method. 


Implement the MouseListener interface 
The definition of the anonymous class in this example uses the syntax that implements an interface. 
An instance initializer 

As before, an instance initializer is used to get and display the name of the class file that represents the 
anonymous class. Thus, when the new anonymous object of the anonymous class is instantiated, the text 
shown in Image 7 (p. 1553) appears on the screen. 

Note the similarity of this class file name to that shown earlier in Image 6 (p. 1552). (You can also 
compare them in Image 4 (p. 1552) .) The names of the two class files differ only with respect to a number 
that is provided by the compiler to guarantee that each class file name is unique. 

Implementing the interface 

Whenever a class implements an interface, it must provide a concrete definition for each of the methods 
declared in the interface, even if some of those methods are empty. 

Continuing with the definition of the anonymous class, Listing 8 (p. 1556) provides definitions for all five 
of the methods declared in the MouseListener interface. Four of those methods are defined as empty 
methods. 

Separation of event subcategories 

One of the major differences between the low-level event model discussed earlier and the source- 

listener model being discussed here has to do with where the separation between the different subcategories 
(mouseClicked, mousePressed, mouseReleased, etc.) of a given event type is accomplished. 

In the low-level model, the separation must be accomplished by code in the overridden event handler 
method, such as with the if statement in the processMouseEvent method defined in Listing 6 (p. 
1555) . 

In the source-listener model, the separation is accomplished before the event handler method is called, 
and a specific event handler method, such as the mouseClicked method is called on the listener object. 

When the button fires a mouse event ... 

In this case, whenever the button fires a MouseEvent of the MOUSE CLICKED subcategory 
(p. 1545) , the mouseClicked method defined in Listing 8 (p. 1556) will be called automatically, causing 
the seventh line of text in Image 4 (p. 1552) to appear on the screen. 

Whenever the button fires a MouseEvent of one of the other subcategories (p. 1545) , one of the 
empty methods defined in Listing 8 (p. 1556) will be called. This method will return immediately, doing 
nothing but wasting a little computer time. 
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(In case you are wondering what happened to the mouseMoved and mouseDragged meth- 
ods, they are defined in the MouseMotionListener interface instead of the MouseListener 
interface. ) 


Add the button to the frame 

Finally, the last statement in Listing 8 (p. 1556) adds the new button to the Frame as the rightmost 
button in Image 2 (p. 1551) . 

A disclaimer 

I wrote this code the way that I did in Listing 8 (p. 1556) to illustrate an anonymous class that implements 
an interface. In real life, I would probably cause the anonymous class to extend the MouseAdapter class 
and override the mouseClicked method instead of implementing the MouseListener interface. That 
would eliminate the requirement for me to define the four empty methods in Listing 8 (p. 1556) . 


4.2.7.4.2.9 Extending the WindowAdapter class 


The above disclaimer provides a perfect lead-in to the definition of the anonymous class shown in Listing 9 
(p. 1556) . 

Registering a WindowListener on the Frame 

The code in Listing 9 (p. 1556) instantiates an anonymous object of an anonymous class that extends 
the WindowAdapter class. 

That anonymous object is registered as a WindowListener onthe Frame by passing the object’s 
reference to the addWindowListener method belonging to the Frame 


(The addWindowListener method requires an incoming parameter of type WindowLis- 

tener . This is satisfied by the fact that the WindowAdapter class implements the 
WindowListener interface. Thus, an object instantiated from a class that extends Win- 
dowAdapter can also be treated as type WindowListener .) 


The screen output 

This anonymous class definition uses an instance initializer to get and display the name of the class that 
represents the anonymous class. Thus, when the anonymous object of the anonymous class is instantiated, 
the text shown in Image 8 (p. 1553) appears on the screen. 


(In an earlier module explaining member classes, I told you that it is possible to examine the 
names of the class files that represent the member classes and to determine quite a lot about the 
structure of the program in terms of which classes are members of which other classes. However, 
in the case of local classes and anonymous classes, about all that you can determine from the 
name of the class file is that the file either represents a local class or represents an anonymous 
class (see the summary of class names in Image 3 (p. 1552) ).) 


The windowClosing method 

The code in Listing 9 (p. 1556) overrides the windowClosing method inherited from the Win- 
dowAdapter class. 

Clicking the close button with the X in the upper right hand corner of Image 2 (p. 1551) causes the 
windowClosing method to be called on any WindowListener objects that have been registered on the 
frame. 

In this case, the overridden windowClosing method in Listing 9 (p. 1556) causes the last line of text 
in Image 4 (p. 1552) to be displayed on the screen. 

Following that, the overridden windowClosing method calls the System.exit method to terminate 
the program. 

The remaining code 
The remaining code in Listing 9 (p. 1556) 


e Causes the frame to become visible 
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e Signals the end of the constructor 
e Signals the end of the GUI class 


4.2.7.4.3 The GUI remains on the screen until terminated 


Once the constructor is executed, the GUI simply remains on the screen waiting for someone to click one 
of the buttons or to click the close button in the upper right corner of the frame. When these buttons are 
clicked, the event handlers are called, causing text such as that shown in Image 9 (p. 1553) to appear on 
the screen. 


4.2.7.4.4 Simple event handlers 


In this demo program, the event handlers simply display messages on the screen, and in the case of the 
close button, terminate the program. In a real world program, the behavior of the event handlers would 
likely be much more substantive, but the overall skeleton of the program need not be any different from that 
illustrated here. 


4.2.7.5 Run the program 


I encourage you to copy the code from Listing 10 (p. 1557) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


4.2.7.6 Summary 


In addition to a number of other items, a class definition can contain: 


Member classes 

Local classes 

Anonymous classes 

Nested top-level classes and interfaces 


Member classes and local classes were explained in previous modules. This module explains anonymous 
classes. 

Although there are some differences, an anonymous class is very similar to a local class without a name. 
Instead of defining a local class and then instantiating it, you can often use an anonymous class to combine 
these two steps. 

An anonymous class is defined by a Java expression, not a statement. Therefore, an anonymous class 
definition can be included within a larger overall Java expression. 

Anonymous class definitions are often included as arguments to method calls, or as the right operand of 
assignment operators. 

An object of an anonymous class must be internally linked to an object of the enclosing class. 

There is no such thing as an anonymous interface, a local interface, or a member interface. 

An anonymous class can often be defined very close to its point of use. Once you become accustomed to 
the somewhat cryptic syntax used with anonymous classes, this can lead to improved code readability. 

Probably the most important benefit of anonymous classes has to do with accessing the members of 
enclosing classes. As with member classes and local classes, methods of an anonymous class have direct 
access to all the members of the enclosing classes, including private members. Thus the use of anonymous 
classes can sometimes eliminate the requirement to connect objects together via constructor parameters. In 
addition, objects of anonymous classes have access to final local variables that are declared within the 
scope of the anonymous class. 

An anonymous class can be particularly useful in those cases where 
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e There is no reason for an object of the anonymous class to exist in the absence of an object of the 
enclosing class. 

e There is no reason for an object of the anonymous class to exist outside a method of the enclosing 
class. 

e Methods of the object of the anonymous class need access to members of the object of the enclosing 
class. 

e Methods of the object of the anonymous class need access to final local variables and method 
parameters belonging to the method in which the anonymous class is defined. 
Only one instance of the anonymous class is needed. 
There is no need for the class to have a name that is accessible elsewhere in the program. 


An anonymous class cannot define a constructor. However, it can define an instance initializer. 

Any arguments that you specify between the parentheses following the superclass name in an anonymous 
class definition are implicitly passed to the superclass constructor. 

Only one instance of an anonymous class can be created. 

As with member classes and local classes, anonymous classes cannot contain static members. 

As with local variables and local classes, anonymous classes cannot be declared public , protected 
, private , or static 


4.2.7.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Anonymous Classes 
e File: Java1640.htm 

e Published: 11/20/13 

e Revised 08/14/15 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.2.7.8 Complete program listing 


A complete listing of the program discussed in this module is show in Listing 10 (p. 1557) . 


4.2.7.9 Images 
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Image 1 . Syntax for anonymous classes. 


new className(optional argument list) {classBody} 


new interfaceName(){classBody} 


Table 4.105 


EA 


E Copyright 2003 R-G.Baldwin P j=] fps 


Image 2 . Program GUI. 


f Copyright 2003 R.G.Baldwin |) 


Table 4.106 
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Image 3 . Class file names. 


GUI$1$BaldButton.class 
GUI$1.class 
GUI$2.class 
GUI$3.class 
GUI.class 
InnerClasses08.class 


Table 4.107 


Image 4 . Screen output. 


Local class name: GUI$1$BaldButton 
Anonymous class B name: GUI$1 
Anonymous class C name: GUI$2 
Anonymous window listener class name: GUI$3 
buttonA clicked 
buttonB clicked 
button clicked 
Close button clicked 


Table 4.108 


Image 5 . Screen output. 


Local class name: GUI$1$BaldButton 


Table 4.109 


Image 6 . Screen output. 


Anonymous class B name: GUI$1 


Table 4.110 
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Image 7 . Screen output. 


Anonymous class C name: GUI$2 


Table 4.111 


Image 8 . Screen output. 


Anonymous window listener class name: GUI$3 


Table 4.112 
Image 9 . Screen output. 
buttonA clicked 
buttonB clicked 
buttonC clicked 
Close button clicked 
Table 4.113 


4.2.7.10 Listings 


Listing 1 . The controlling class. 


public class InnerClasses08 { 
public static void main(String[] args){ 
new GUI(); 
}//end main 
}//end class InnerClasses08 


Table 4.114 


Listing 2 . Beginning of the GUI class. 


continued on next page 
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class GUI extends Frame{ 
public GUI( {//constructor 
setLayout(new FlowLayout()); 
setSize (250,75); 
setTitle("Copyright 2003 R.G.Baldwin") ; 


Table 4.115 


Listing 3 . Beginning of the BaldButton class. 


class BaldButton extends Button{ 
BaldButton(String text) {//constructor 
enableEvents (AWTEvent .MOUSE_EVENT_MASK) ; 
setLabel (text); 
System.out.println("Local class name: " + 
getClass () .getName()); 
}//end constructor 


Table 4.116 


Listing 4 . The processMouseEvent method. 


public void processMouseEvent (MouseEvent e){ 
if (e.getIDQ) == MouseEvent .MOUSE_CLICKED) { 
System.out.println("buttonA clicked"); 
}//end if 


//The following is required of overridden 
// processMouseEvent method. 
super. processMouseEvent (e); 
}//end processMouseEvent 
}//end class BaldButton 


//Add button to Frame 
add(new BaldButton("A")); 


Table 4.117 
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Listing 5 . Beginning of anonymous inner class. 


add(new Button("B") 
{//Begin class definition 
{//Instance initializer 
enableEvents( 
AWTEvent .MOUSE_EVENT_MASK) ; 
System.out.print1n( 
"Anonymous class B name: " + 
getClass () .getName()); 
}//end instance initializer 


Table 4.118 


Listing 6 . Overridden processMouseEvent method. 


public void processMouseEvent ( 
MouseEvent e){ 
MouseEvent .MOUSE_CLICKED) { 
System.out.println("buttonB clicked"); 
}//end if 


if (e.getIDQ 


//Required of overridden 
// processMouseEvent method. 
super . processMouseEvent (e) ; 
}//end processMouseEvent 
}//end class definition 
);//end add method call 


Table 4.119 


Listing 7 . Register a MouseListener object. 


Button buttonC = new Button("C"); 


buttonC.addMouseListener (new MouseListener() 
{//begin class definition 
//Instance initializer 
{System.out.println( 
"Anonymous class C name: " + 
getClass () .getName()) ;} 


Table 4.120 
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Listing 8 . Implementing the interface. 


public void mouseClicked(MouseEvent e){ 
System.out.println("buttonC clicked"); 
3//end mouseClicked 


//A11 interface methods must be defined 
public void mousePressed(MouseEvent e){} 
public void mouseReleased(MouseEvent e){} 
public void mouseEntered(MouseEvent e){} 
public void mouseExited(MouseEvent e){} 


}//end class definition 
);//end addMouseListener call 


add(buttonC) ;//add button to frame 


Table 4.121 


Listing 9 . Registering a WindowListener on the Frame . 


addWindowListener(new WindowAdapter () 
{//begin class definition 
//Instance initializer 
{System.out.println( 
"Anonymous window listener class " + 
"name: " + getClass().getName()) ;} 


public void windowClosing(WindowEvent e){ 
System.out.print1n( 
"Close button clicked"); 
System.exit (0); 
}//end windowClosing 
}//end class definition 
);//end addWindowListener 


setVisible(true) ; 


}//end constructor 
}//end GUI class 


Table 4.122 
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Listing 10 . Complete program listing. 


/*File InnerClasses08. java 
Copyright 2003 R.G.Baldwin 


This program is designed to illustrate the use 
of local classes, and anonymous classes. It 
illustrates three different implementations of 
anonymous classes. It also illustrates the use 
of instance initializers as an alternative to 
constructors. 


Illustrates use of local class to instantiate 
object to handle mouse clicked event with 
low-level event handling. This class uses 
constructor to enable mouse events on a new 
extended Button class. Also uses constructor 
to display the class file name. 


Illustrates use of anonymous class to instantiate 
object to handle mouse clicked event with 
low-level event handling. This class uses an 
instance initializer to enable mouse events on a 
new extended Button class. Also uses instance 
initializer to display name of class file. 


Illustrates use of anonymous class, which 
implements MouseListener interface, to 
instantiate object to handle mouse clicked event 
using source-listener event model. Uses instance 
initializer to display name of class file. 


Illustrates use of anonymous class, which extends 
WindowAdapter class, to instantiate object to 
handle window events fired by the close button in 
the upper-right corner of a Frame object, using 
source-listener event model. Uses instance 
initializer to display name of class file. 


This program produces the following class files 
when compiled: 


GUI$1$BaldButton.class 
GUI$1.class 
GUI$2.class 
GUI$3.class 

GUI.class 
InnerClasses08.class 


The program produces the following output when 

the program is started, each button is clicked 

Once in BATERE a OR. able {or hpe at Cogneriong © http: / /enx.org/content /coll1441/1.181> 
in the upper-right corner o fhe Frame is P s 


clicked: 


Local class name: GUI$1$BaldButton 


1553 


Table 4.123 


-end- 


4.3 Generics 


4.3 


.1 Java4210: Getting Started with Generics” 


4.3.1.1 Table of Contents 


Preface (p. 1558) 


Viewing tip (p. 1559) 


x Images (p. 1559) 
x Listings (p. 1559) 


Preview (p. 1561) 
General background information (p. 1559) 
Discussion and sample code (p. 1561) 


Collection behavior prior to Java version 1.5 (p. 1561) 

An incorrect cast in code that doesn’t use generics (p. 1563) 

Dealing with angle brackets in cnxml body text (p. 1564) 

Avoiding the requirement to cast through the use of generics (p. 1565) 
Compile-time type safety provided by the use of generics (p. 1566) 
Generic iterator syntax and the enhanced for loop (p. 1567) 


Run the programs (p. 1570) 
Summary (p. 1570) 

What’s next? (p. 1571) 
Miscellaneous (p. 1571) 

Complete program listings (p. 1572) 


4.3.1.2 Preface 


This module is one in a collection of modules on Java Generics designed for teaching ITSE2317 - Java 
Programming (Intermediate) at Austin Community College in Austin, TX. 


Many new features in Java version 1.5 


When Java version 1.5 was released, it contained many new language features, including: 


Generics 

Enhanced for Loop 
Autoboxing/ Unboxing 
Typesafe Enums 
Varargs 

Static Import 
Metadata 


In addition to the new language features, Java version 1.5 also contained other new features such as new 
Look and Feel capabilities for Swing GUIs. 


First in a series 


43This content is available online at <http://cnx.org/content /m47554/1.2/>. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1554 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


This is the first module in a series of modules designed to teach you about Generics in Java version 1.5. 
This module will teach you some of the rudimentary aspects of the generics capability . This module will 
also teach you how to use the enhanced for loop with collections. 

Future modules will teach you how to use other aspects of generics 


4.3.1.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the Images and the listings while you are reading about them. 


4.3.1.2.1.1 Images 


e Image 1 (p. 1559) . Typical v1.5 compiler warning. 
e Image 2 (p ) . Warning with -Xlint:unchecked. 
e Image 3 (p. 1563) . A ClassCastException. 
e Image 4 (p. 1567) . A compiler error. 
e (p ) 


Image 5 . Iterator output. 


4.3.1.2.1.2 Listings 


e Listing 1 (p. 1568) . Beginning of the program named Generics05. 
e Listing 2 (p. 1568) . Beginning of the runIt method. 

e Listing 3 (p. 1569) . An iterator. 

e Listing 4 (p. 1570) . Enhanced for loop. 

e Listing 5 (p. 1573) . The program named Generics01. 

e Listing 6 (p. 1575) . The program named Generics02. 

e Listing 7 (p. 1576) . The program named Generics03. 

e Listing 8 (p. 1577) . The program named Generics04. 

e Listing 9 (p. 1579) . The program named Generics05. 


4.3.1.3 General background information 


A new compiler warning 
Have you recently tried to recompile a legacy program that has compiled and executed properly for many 
years only to get a compiler message similar to that shown in Image 1 (p. 1559) ? 


Image 1 . Typical v1.5 compiler warning. 


Note: Generics0O1.java uses unchecked or unsafe operations. 
Note: Recompile with -Xlint:unchecked for details. 


Table 4.124 


If you followed up and recompiled as directed, you probably got a message from the compiler that looked 
something like the one shown in Image 2 (p. 1560) . 
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Image 2 . Warning with -Xlint:unchecked. 


Generics01.java:34: warning: [unchecked] unchecked call to add(E) as a member of 
the raw type ArrayList 
vari.add(new Date()); 
where E is a type-variable: 
E extends Object declared in class ArrayList 
1 warning 


Table 4.125 


If that has happened to you, you have had your first encounter with a new feature in Java version 1.5 
known as generics. 

What are generics? 

Oracle has this to say about generics (boldface added for emphasis): 


"This long-awaited enhancement to the type system allows a type or method to operate on 
objects of various types while providing compile-time type safety . It adds compile-time 
type safety to the Collections Framework and eliminates the drudgery of casting." 


In addition to the Collections Framework, generics impacts several other areas of Java programming as well. 
Generics are not particularly easy 

Don’t be lulled into a false sense of security by what you will find in this module. Although the intro- 
ductory material presented in this module is rather straightforward, a full understanding of generics can be 
fairly difficult. The tentacles of generics reach into many different areas of Java in very complex ways. 

The truth of this is borne out by the fact that the excellent book entitled Java How to Program, Sixth 
Edition (Deitel) 44 dedicates an entire chapter consisting of more than 30 pages to generics. Furthermore, 
the chapter on generics doesn’t even include many additional pages that the book dedicates to a discussion 
of the impact of generics on the Java Collections Framework. The book covers several topics in the chapter 
on generics, including the following: 


Generic methods 
Generic classes 

Raw types 

Wildcards 

Generics and inheritance 


The impact of generics on the Java Collections Framework is covered in a different chapter. Hopefully, the 
benefits provided by generics will outweigh the additional complexity. Only time will tell. 

The Java Collections Framework 

Even though the material that will be presented in this module will be relatively straightforward, you 
will need to know something about the Java Collections Framework for it to make much sense. If you need to 
learn more about the Java Collections Framework, see the modules beginning with Java4010: Getting Started 
with Java Collections *° at Object-Oriented Programming (OOP) with Java *° . Be aware, however, that 
those modules were originally published long before generics existed in Java. If you compile the programs in 
those modules using Java version 1.5 or a later version, you will get the warning messages from the compiler 
shown in Image 1 (p. 1559) . 


44http://www.amazon.com/exec/obidos/ASIN/0131483986/qid=1110389658/sr=11-1/ref=sr_11_ 1/102-4105266-9447324 
45http://cnx.org/content /m46135/latest /?collection=col11441 /latest 
46http://cnx.org/content /col11441/latest:/ 
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4.3.1.4 Preview 


I will present and explain several very simple programs in this module. Those programs are intended to 
illustrate the following concepts: 


How the Java Collections Framework behaved prior to the release of Java version 1.5. 

The effect of an incorrect cast in code that doesn’t use generics. 

Avoiding the requirement to cast through the use of generics. This program also includes an illustration 
of some of the required syntax for generics. 

Compile-time type safety provided by the use of generics. 

Syntax requirements for the use of iterators with generics. This program also illustrates the use of the 
enhanced for loop with collections, which is another new feature in Java version 1.5. 


4.3.1.5 Discussion and sample code 


Listings of the programs 
Complete listings of all the programs discussed in this module are provided in Listing 5 (p. 1573) through 
Listing 9 (p. 1579) near the end of the module. 


4.3.1.5.1 Collection behavior prior to Java version 1.5 


The main purpose of the program named Generics01 is to establish a baseline against which to compare 
the other programs. A secondary purpose is to illustrate the warnings produced by the Java version 1.5 (or 
later) compiler when the syntax of the source code doesn’t take generics into account. 

A complete listing of the program named Generics01 is shown in Listing 5 (p. 1573) near the end of 
the module. 

As you will see later, this program was written using the program syntax and style that was common 
prior to the release of Java version 1.5. In particular, this program does not include the syntax necessary to 
take generics into account. 

Notes at compile time 

When this program is compiled using the Java version 1.5 or later compiler, the text shown in Image 1 
(p. 1559) appears on the screen. 

Note that the text in Image 1 (p. 1559) is not identified as either an error or a warning. Rather, the text 
is identified simply as notes. These notes provide instructions on how to recompile and get more information 
regarding a potential problem. 

Recompiling with the Xlint switch 

When the program is recompiled using the Xlint switch shown in Image 1 (p. 1559) , the compiler 

produces the text shown in Image 2 (p. 1560) . Note that this text is identified as a warning. 


(Later when we examine the code from the program named Generics01_ , you can compare it 
with this text to see just what the compiler is complaining about.) 


Get used to it 

The text in Image 1 (p. 1559) and Image 2 (p. 1560) is similar to what you can expect to see any time 
that you use the Java version 1.5 or later compiler to compile a program that includes the Java Collections 
Framework and doesn’t use the required syntax to take generics into account. This probably includes many 
of the programs that you wrote, compiled, and executed successfully prior to the release of Java version 1.5. 

The program code 

The code for the program named Generics01 is shown in its entirety in Listing 5 (p. 1573) . 

The main method 

As you can see in Listing 5 (p. 1573) , the main method instantiates a new object of the class named 
Generics01 , and calls the method named runIt on that object. It is the behavior of the runIt method 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1557 


that interests us. More particularly, it is the expression contained in the argument list for the println 
method that interests us the most. 

A baseline program 

As mentioned earlier, the main purpose of this program is to establish a baseline against which we can 
compare the other programs to be discussed later. This program was written exactly as it would have been 
written prior to the release of generics in Java version 1.5. 

An ArrayList object 

The program declares and initializes an instance variable named varl with a reference to an object 
instantiated from the class named ArrayList . ArrayList is one of the concrete implementations of 
the interfaces provided in the Java Collections Framework. Briefly, an object of the ArrayList class is an 
object that implements the List interface, providing a convenient place to store references to other objects. 

One of the methods of an ArrayList object is the method named add . This method is used to add 
new elements to the end of the list. 

Adding a Date object’s reference to the list 

Listing 5 (p. 1573) calls the add method to add anew Date object’s reference to the list. 


(This is the method call that the compiler was complaining about in the warning in Image 2 (p. 
1560) .) 


When an object’s reference is added to an ArrayList object (without the use of generic syntax), that 
reference is automatically converted to and stored as type Object 


(As you will see later, that is probably also true even with the use of generic syntax. I will have 
more to say about this later.) 


What can you do with a reference of type Object? 

I often tell my students that there are only twelve things that you can do with an object’s reference that 
has been converted to type Object . The first eleven of those twelve things is to call any one of the eleven 
methods that are defined in the Object class and inherited into all subclasses of Object . The twelfth 
thing is to attempt to cast the reference to some other type in an attempt to call some other method on the 
reference after casting. 

Invoking getTime on the reference 

The objective of the code in this program is to call the method named getTime onthe Date object’s 
reference. The getTime method is not one of the eleven methods that are defined in the Object. class. 
Rather, the getTime method is defined in the Date class. 

Change the type of the reference 

Therefore, in order to callthe getTime method on the reference after it is retrieved from the ArrayList 
object, the type of the reference must be converted from type Object totype Date . This is accomplished 
by the cast operation in the expression contained in the argument list for the println method in Listing 
5 (p. 1573) . 

That expression calls the get method on the reference to the ArrayList object to retrieve the element 
stored at index 0 of the collection. The get method returns the reference as type Object (at least that 
was true prior to the introduction of generics). Then the expression casts the reference to type Date , 
converting its type back to type Date 

Invoking the get Time method 
Finally, the expression successfully calls the getTime method on the reference of type Date 
The program produces an output similar to that shown below: 

1377991758665 
This is the number of milliseconds since January 1, 1970, 00:00:00 GMT represented by the Date object. 
Casting was a necessity prior to Java version 1.5 

Prior to the release of Java version 1.5, it was always necessary to cast references retrieved from collection 
objects in order to call any methods on them other than the eleven methods defined in the Object. class. 
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Some authors refer to this casting requirement as "the drudgery of casting," and indicate that casting 
may be eliminated through generics. 


(In my opinion, from this viewpoint alone, the cure is worse than the disease. Casting syntax is 
much simpler and more straightforward than generics syntax.) 


May eliminate runtime errors and exceptions 

However, it is possible for the programmer to perform an incorrect cast at this point in the program, 
which will usually result in a ClassCastException being thrown at runtime. 

The great promise of generics is that it can sometimes cause programming errors to be recognized at 
compile time instead of encountering them at runtime. 

Obviously, the best approach is to avoid writing programs containing programming errors in the first 
place. However, if you are going to write programs containing errors, it is usually better to catch them 
at compile time than to have them occur at runtime. This is the thing that may make the complexity of 
generics worthwhile. 


4.3.1.5.2 An incorrect cast in code that doesn’t use generics 


The program named Generics02 (shown later in Listing 6 (p. 1575) ) illustrates the application of an 
incorrect cast to an element that is retrieved from an ArrayList object, along with the runtime error that 
is produced by that incorrect cast. 

No compiler error 

This program does not produce a compiler error. 


(However, the Java version 1.5 compiler does produce a warning having to do with the failure to 
apply the new generics syntax that was released in Java version 1.5. Note that earlier compilers 
would not have produced such a warning.) 


The point here is that the compiler does not check to confirm that the correct cast is applied. This results 
in a successful compilation, but the program throws an exception at runtime. 

A ClassCastException 

The runtime exception that is thrown by this program is shown in Image 3 (p. 1563) . You can compare 
the details of this exception with the program code later. The reference to line 46 in Image 3 (p. 1563) is 
a reference to the statement in Listing 6 (p. 1575) that attempts to cast the reference to type Date 
(That reference was originally a reference to an object of type String .) 


Image 3 . A ClassCastException. 


Exception in thread "main" java.lang.ClassCastException: java.lang.String cannot 
be cast to java.util.Date 

at Generics02.runIt(Generics02. java:46) 

at Generics02.main(Generics02.java:53) 


Table 4.126 


The program code 

The program is shown in its entirety in Listing 6 (p. 1575) . As before, the main method instantiates 
an object of the Generics02 class and calls the runIt method on that object. Also as in the previous 
program, this program instantiates anew ArrayList object and saves the object’s reference in the instance 
variable named varl 
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The runIt method 

The runIt method begins by populating the ArrayList object with references to two different objects 

of different types. One of the objects is type Date . The other object is type String 
A questionable programming style 

While this is probably not a very good programming style, it is a style that was commonly used by Java 
programmers prior to the advent of generics. It was common to populate collection objects with references 
to a mixture of objects of different types. 

References are stored as type Object 

As you already know, when these object’s references are put into the collection, the types of all the 
references are automatically converted to type Object . As you also already know, when the references 
are retrieved from the collection, if the purpose is to call any method on a reference other than one of the 
eleven methods defined in the Object class, it is necessary to cast the reference to a type that is consistent 
with the method. 

Casting errors are likely 

This is a scenario where the programmer is likely to make a casting error when casting elements retrieved 
from the collection. Unless the programmer uses the imstanceof operator to determine the type of a 
retrieved reference prior to performing the cast, the programmer is depending on his memory to know the 
type of each reference in the population on the basis of the index of the element. If the programmer loses 
track of the types of the different references with respect to the element’s indices, a casting error is a strong 
possibility. 

The error scenario 

This is the error scenario depicted by the first call to the println method in Listing 6 (p. 1575) . In 
this case, the element at index 0 is a reference toa Date object, and the element at index 1 is a reference 
toa String object. However, the programmer mistakenly retrieves the element at index 1 and attempts to 
cast it to type Date , which is the type of the reference at index 0. This results in the runtime exception 
shown in Image 3 (p. 1563) . 

Of course, it has always been possible to use the instanceof operator to confirm the type of a reference 
before performing a cast as a way to avoid this type of programming error. Good programming practice 
would dictate the use of that construct when working with references to objects of mixed types in a single 
collection. 


4.3.1.5.3 Dealing with angle brackets in cnxml body text 


You are reading this module at cnx.org. Documents published at cnx.org are maintained in a special flavor 
of xml know as cnxml. Without getting into the details, I will tell you that creating cnxml is not an easy 
task. In order to avoid having to write these modules in raw cnxml code, I originally write them using a 
WYSIWYG xhtml editor and then run the xhtml files through a program of my own design that transforms 
the xhtml document into cnxml. 

Unfortunately, my transform program is incapable of handling angle brackets in the body text of the 
document. Therefore, whenever the body text in this document needs a left angle bracket, I will indicate 
the existence of a left or right angle bracket using a text description of the angle bracket. The code in the 
listings, however, will show the left and right angle brackets intact as required. 


4.3.1.5.4 Avoiding the requirement to cast through the use of generics 


The program named Generics03 shown in Listing 7 (p. 1576) illustrates how generics can be used to 
avoid the requirement to cast references when they are retrieved from a collection. 


(While casting is not difficult, avoiding the requirement to cast can also avoid the possibility of 
casting incorrectly.) 


As in the previous programs, the main method in this program instantiates an object of the class named 
Generics03 and calls the method named runIt on the object. 
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Instantiate an ArrayList object 

Also, as in the previous programs, this program declares an instance variable named var1 and initializes 
that variable with a reference to a new object of type ArrayList . However, the syntax that is used for this 
purpose in this program is significantly different from the syntax used for the same purpose in the previous 
two programs. 


(Note the code in Listing 7 (p. 1576) that shows the type Date enclosed in matching angle 
brackets. This is the primary syntax change required to use generics.) 


What does this syntax mean? 
One way to think of this syntax is that the expression on the right of the assignment operator instantiates 
anew ArrayList object that is capable of containing only references to objects of type Date 


(Those references are probably still stored as type Object . We will see how this apparent 
discrepancy is reconciled later through automatic casting.) 


Similarly, the expression on the left of the assignment operator is the declaration of an instance variable 
capable of holding a reference to an ArrayList object, which in turn is capable of containing only references 
to objects of type Date 

Must qualify both expressions 

Additional changes to generics were made in the release of Java version 1.7. Prior to the release of Java 
version 1.7, it was necessary to qualify the expressions on both sides of the assignment operator by use of 
the angle-bracket syntax. If the qualifier was included in the expression on the right, but was omitted from 
the variable declaration on the left, the compilation would fail later. That is still true following the release 
of Java version 1.7. 

If the angle-bracket qualifier was included with the variable declaration on the left and omitted from the 
instantiation of the new object on the right, the program would compile and run successfully. However, the 
compiler would issue an unchecked conversion warning indicating the possibility of a runtime error under 
certain conditions. 

Following the release of Java version 1.7, it is not necessary to qualify the expression on the right side of 
the assignment operator. You will learn more about this in a future module. 

What does Oracle have to say? 
According to Oracle (boldface added for emphasis), 


"Generics provides a way for you to communicate the type of a collection to the compiler, so 
that it can be checked. Once the compiler knows the element type of the collection, the compiler 
can check that you have used the collection consistently and can insert the correct casts on 
values being taken out of the collection." 


Note the boldface text in the above quotation indicating that the compiler modifies your code by inserting 
casts where appropriate. 

Compile-time type safety 

In discussing code similar to the code in Listing 7 (p. 1576) , Oracle states, 


"... so the compiler can verify at compile time that the type constraints are not violated at run 


time. Because the program compiles without warnings, we can state with certainty that it will 
not throw a ClassCastException at run time. The net effect of using generics, especially in 
large programs, is improved readability and robustness." 


In order to achieve compile-time type safety, it is necessary that the program compiles without warnings. 
Otherwise, the program may execute, but may throw a ClassCastException at runtime. 

More on generics with collections 

In further explaining generics as used with collections, Oracle goes on to say (boldface added for em- 
phasis): 
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"... when we declare c to be of type Collection (String in angle brackets), this tells us something 


about the variable c that holds true wherever and whenever it is used, and the compiler guarantees 
it (assuming the program compiles without warnings ). A cast, on the other hand, tells 
us something the programmer thinks is true at a single point in the code, and the VM checks 
whether the programmer is right only at run time." 


The bottom line 

The bottom line on generics (when used with collections) seems to be that references to objects are 
still stored in the collection as type Object . However, when we notify the compiler of the type of data 
to be stored in the collection using angle-bracket syntax, and the program compiles without warnings, the 
compiler will do at least the following: 


e Ensure that only references to objects of the specified type are stored in the collection, and used 
consistently throughout the program, thus eliminating the possibility of a ClassCastException at 
runtime. 

e Automatically cast the reference to the specified type when it is later retrieved by program code. 


No explicit cast is required 

That brings us back to a discussion of the code in Listing 7 (p. 1576) . Note that unlike the code in 
Listing 5 (p. 1573) , the print statement in Listing 7 (p. 1576) does not contain an explicit cast to type 
Date , (at least not in the code that I wrote). 

As described above, having been notified that the collection can contain only references to objects of 
type Date , the compiler automatically inserted a cast to type Date at the appropriate place in the 
code, thereby guaranteeing that the reference is converted from type Object to type Date before the 
getTime method is called on the reference. 

There is still a cast involved. However, the cast is automatically inserted by the compiler. This eliminates 
the requirement for me (the programmer ) to insert the cast, and also eliminates the possibility of me 
inserting an incorrect cast. 

Once again, all of this assumes that the program compiles without warnings. 

Program output 

The program in Listing 7 (p. 1576) compiles and executes correctly, producing the following output for 

one particular run. 
1377995720768 


4.3.1.5.5 Compile-time type safety provided by the use of generics 


The program named Generics04 shown in Listing 8 (p. 1577) illustrates the ability of generics to prevent 
the storing of the wrong type of references in a collection. This in turn can prevent runtime errors. 

A new ArrayList object 

Listing 8 (p. 1577) instantiates a new object of type ArrayList capable of storing only references to 
objects of type Date . This object’s reference is stored in the instance variable named var1 

Other types cannot be stored in the collection 

Once the ArrayList has been constrained to contain only references to objects of type Date , the 
compiler will not allow a reference to an object of any other type (other than types that are assignment 
compatible with Date , such as subclasses of Date ) to be stored in the collection. 

A compiler error rather than a runtime error 

The first statement inthe runIt method in Listing 8 (p. 1577) attempts to add a new element to the 
ArrayList object. The new element is a reference to a literal String object that encapsulates the string 
"abcd". This results in the compiler error shown in Image 4 (p. 1567) . 
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Image 4 . A compiler error. 


Generics04.java:34: error: no suitable method found for add(String) 
vari.add("abcd") ; 
method ArrayList.add(int,Date) is not applicable 
(actual and formal argument lists differ in length) 
method ArrayList.add(Date) is not applicable 
(actual argument String cannot be converted to Date by method invocation 
conversion) 
1 error 


Table 4.127 


Without the use of generics, a reference to an object of any type could be added to the collection. This 
could result in a runtime error later if the programmer expected an object of type Date when in fact the 
object is of type String . If you are going to write programs containing errors, compiler errors are almost 
always preferable to runtime errors. 


4.3.1.5.6 Generic iterator syntax and the enhanced for loop 


Iterators 

Listing 7 (p. 1576) and Listing 8 (p. 1577) showed the syntax that you must use to cause a collection 
object to be treated as a generic collection. You must also use a special syntax when working with generic 
iterators and the Java Collections Framework. 

The enhanced for loop 

Another new feature of Java version 1.5, referred to by Oracle as an enhanced for loop, can be used 
in certain situations to provide most of the benefits of an iterator with a somewhat simpler syntax. 


(The enhanced for loop is also sometimes referred to as a for-each loop.) 


The program named Generics05_, which begins in Listing 1 (p. 1568) , illustrates both of these concepts. 
A complete listing of the program is provided in Listing 9 (p. 1579) . 


Listing 1 . Beginning of the program named Generics05. 


import java.util.*; 


public class Generics05{ 
//Create an ArrayList object suitable for 
// storing references to Date objects. 
ArrayList <Date> vari = new ArrayList<Date>(); 


continued on next page 
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Table 4.128 


The main method 

As in the previous programs, the main method instantiates an object of the Generics05 class and 
calls the runIt method on that object. You can view the main method in Listing 9 (p. 1579) near the 
end of the module. 

Instantiate a generic ArrayList object 

This program is a little longer than the previous programs, so I will break it down and explain it in 
fragments. 

Listing 1 (p. 1568) shows the beginning of the Generics05 class. The code in Listing 1 (p. 1568) 
instantiates a new ArrayList object capable of storing references to objects of type Date only. The 
code in Listing 1 (p. 1568) also saves that object’s reference in a generic instance variable named var1 
This is the same syntax that you have seen in previous listings. 

Populate the collection 

Listing 2 (p. 1568) shows the beginning of the runIt method. This code populates the ArrayList 
object with references to three Date objects. The first object encapsulates the current date and time. The 
second object encapsulates the date and time one day later than the first. The third object encapsulates the 
date and time two days later than the first object. 


Listing 2 . Beginning of the runIt method. 


void runiIt(){ 
//Get current date and time in milliseconds. 
long now = new Date().getTime(); 
//Get length of one day in milliseconds 
long oneDay = 24 * 60 * 60 * 1000; 


//Populate the ArrayList object 
vari.add(new Date(now)); 

vari.add(new Date(now + oneDay)); 
vari.add(new Date(now + 2 * oneDay)); 


Table 4.129 


The code in Listing 2 (p. 1568) is straightforward and shouldn’t require further explanation. 

Get and use an iterator 

An iterator is an object instantiated from a specially designed class that implements the Iterator 
interface. The design of the class makes it possible for client code to gain sequential access to each element 
encapsulated in an associated collection object without a requirement to know anything about how the 
collection is structured. 

Required syntax 

The first statement in Listing 3 (p. 1569) shows the syntax required to get and save a reference to a 
generic iterator for the ArrayList object instantiated earlier in Listing 1 (p. 1568) . 
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Listing 3 . An iterator. 


//Get an iterator 
Iterator <Date> iter = vari.iterator(); 


//Perform the iteration 
while(iter.hasNext())f{ 
System.out.println(iter.next().getTime()); 


}//end while loop 


System. out .println();//blank line 


Table 4.130 


Note the requirement to qualify the declaration of the local variable named iter with the type of data 
stored in the collection using angle-bracket notation similar to that used earlier.. You might think of this as 
a variable capable of holding a reference to an iterator object, which is capable of iterating on an ArrayList 
object, which in turn is capable of storing references to objects of type Date only. 

Perform the iteration 

The remaining code in Listing 3 (p. 1569) uses the iterator to sequentially access and display information 
encapsulated in each of the three Date objects whose references are stored in the ArrayList object. This 
is standard code for the use of an iterator and should not require further explanation. This code produces 
the first three lines of text (plus the blank line) shown in Image 5 (p. 1569) . 


Image 5 . Iterator output. 


1378070280877 
1378156680877 
1378243080877 


1378070280877 
1378156680877 
1378243080877 


Table 4.131 


The program output 

The output produced by this program depends on when you run it. The output produced for one 
particular run is shown in Image 5 (p. 1569) . 

The output will be different each time you run the program depending on the current date and time. 

The enhanced for loop 

The code in Listing 4 (p. 1570) performs the same iteration using the new enhanced for loop that was 
released in Java version 1.5. 
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Listing 4 . Enhanced for loop. 


//Now perform the same iteration using 

// the new for-each construct. 

for(Date element : var1){ 
System.out.println(element.getTime()); 

}//end for-each 


}//end runIt 


Table 4.132 
You might think of this syntax as meaning: 


For each element of type Date contained in the collection referred to by varl , get the value 
of the element and save it in the variable named element . Then use the contents of that 
variable to perform the operations specified within the body of the loop. 


More compact syntax 

As you can see, this approach does not require you to get an iterator and to explicitly use that iterator 
to sequentially access the elements in the collection. Thus, the syntax is more compact than the syntax 
shown in Listing 3 (p. 1569) . Further, by eliminating the requirement to get the iterator, this construct also 
eliminates the requirement for you to qualify the code using the angle-bracket syntax. All of those details 
are handled automatically behind the scenes. 

Not quite as powerful as an iterator 

Although not shown in Listing 3 (p. 1569) , the use of an iterator allows you to remove the most recently 
accessed element from a collection. As near as I can tell, the enhanced for loop does not provide that 
capability. Therefore, the enhanced for loop is not quite as powerful as an iterator. However, if you don’t 
need to remove elements from the collection, the enhanced for loop appears to be a good and somewhat 
simpler alternative to an iterator. 

The output 

The code in Listing 4 (p. 1570) produced the last three lines of text in the output shown in Image 5 (p. 
1569) . Obviously the last three lines match the first three lines since they simply represent different ways 
to produce a text representation of the same three Date objects. 


4.3.1.6 Run the programs 


I encourage you to copy the code from Listing 5 (p. 1573) through Listing 9 (p. 1579) Compile the code and 
execute it. Experiment with the code, making changes, and observing the results of your changes. Make 
certain that you can explain why your changes behave as they do. 


4.3.1.7 Summary 
In this module, I explained: 


How the Java Collections Framework behaved prior to the release of Java version 1.5. 

The effect of an incorrect cast in code that doesn’t use generics. 

How to avoid the requirement to cast through the use of generics, including an illustration of some of 
the required syntax for generics. 

The compile-time type safety provided by the use of generics. 

The syntax requirements for the use of iterators with generics. 

The use of the enhanced for loop with collections. 
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4.3.1.8 What’s next? 


Future modules in this series will be based on the Generics (Updated) 47 section of The Java Tutorials 48 
from Oracle. (In the event that these links become broken, you should have no difficulty finding the Oracle 
material with an online search.) 

Those modules will teach you about other aspects of generics including: 


Generic methods 

Generic classes 

Raw types in generics 

Wildcards and bounded wildcards in generics 
The impact of inheritance on generics 


4.3.1.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Getting Started with Generics 
e File: Java4210.htm 

e Published: 09/01/2013 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.3.1.10 Complete program listings 


Complete listings of the programs discussed in this module are provided below. 


47http://docs.oracle.com/javase/tutorial/java/generics/ 
48http://docs.oracle.com/javase/tutorial/index.html 
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Listing 5 . The program named Generics01. 


/*File Generics01.java 
Copyright 2005, R.G.Baldwin 


Illustrates requirement to cast without the use 
of generics. 


V1.5 compiler produces following warning: 


Note: Generics0O1.java uses unchecked or unsafe 
operations. 

Note: Recompile with -Xlint:unchecked for 
details. 


Recompilation with -Xlint:unchecked produces 
the following output: 


Generics01.java:34: warning: [unchecked] unchecked 
call to add(E) as a member of 
the raw type ArrayList 
vari.add(new Date()); 
where E is a type-variable: 
E extends Object declared in class ArrayList 
1 warning 


Tested using JDK 1.7 under Win 7. 
FEC I AG IO I IGA EEEE EEEE EEEE EEEE EE 2k 2k ak ak ak // 


import java.util.*; 
public class Generics01f{ 
ArrayList vari = new ArrayList(); 


void runiIt(){ 
vari.add(new Date(); 
//Note the required cast in the following 
// statement. 
System. out .print1n( 
((Date) var1.get(0)).getTime()) ; 
}//runiIt 


public static void main(String[] args){ 
new Generics01().runIt(); 


}//end main 


}//end class Generics01 
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Table 4.133 
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Listing 6 . The program named Generics02. 


/*File Generics02.java 
Copyright 2005, R.G.Baldwin 


Illustrates the application of an incorrect cast 
to an element that is fetched from an ArrayList 
object and the runtime error produced by that 
incorrect cast. 


This program does not produce a compiler error, 
although the v1.5 compiler does produce a 
general warning having to do with the failure 

to apply the new generics syntax released in 
vi.5. (Earlier compilers would not have produced 
such a warning.) 


However, the compiler does not check to confirm 
that the correct cast is applied. This results 
in the following runtime error when an incorrect 
cast is applied: 


Exception in thread "main" java.lang.ClassCastException: java.lang.String cannot 
be cast to java.util.Date 

at Generics02.runIt(Generics02. java:46) 

at Generics02.main(Generics02.java:53) 


Tested using JDK 1.7 under Win 7. 
FEA AG IA I IOI I IOI AI I I IK I EE EEEE E 2k 2k ak af ak / 


import java.util.*; 
public class Generics02{ 
ArrayList vari = new ArrayList(Q); 


void runIt(){ 
vari.add(new Date(); 
vari.add("abcd") ; 
//Note that the (Date) cast is applied to 
// an element of type String in the following 
// statement, producing a runtime error. The 
// problem is that the wrong index was used 
// in fetching the element. Thus, the wrong 
// element was fetched. 
System. out .print1n( 
((Date)vari.get(1)).getTime()) ; 
System. out. print1n( 
((String) var1.get(1)).length()); 
}//end runIt 
Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
public static void main(String[] args){ 
new Generics02() .runIt(); 
}//end main 


Table 4.134 
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Listing 7 . The program named Generics03. 


/*File Generics03. java 
Copyright 2005, R.G.Baldwin 


Illustrates use of generics to avoid requirement 
to cast. Requires v1.5 or later. 


Program output for one run was: 
1377995720768 


Tested using JDK 1.7 under Win 7. 
FE AIG IA I IOI EEEE EEEE EEEE 1 21 21 EE 2 2k ak af ak / 


import java.util.*; 


public class Generics03{ 


ArrayList <Date> vari = new ArrayList<Date>(); 


void runIt(){ 

vari.add(new Date()); 

//Note that no cast is required in the 

// following statement. 

System. out.println(vari1.get(0).getTime()); 
}//end runIt 


public static void main(String[] args){ 
new Generics03().runIt(); 


}//end main 


}//end class Generics03 


Table 4.135 


Listing 8 . The program named Generics04. 


continued on next page 
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/*File Generics04. java 
Copyright 2005, R.G.Baldwin 


Illustrates ability of generics to prevent 
storing of wrong type in a collection. 
Requires v1.5 or later. 


Compilation produces following error message: 


Generics04. java:34: error: no suitable method 
found for add(String) 
vari.add("abcd") ; 
method ArrayList.add(int,Date) is not 
applicable (actual and formal argument lists 
differ in length) 
method ArrayList.add(Date) is not applicable 
(actual argument String cannot be converted 
to Date by method invocation conversion) 
1 error 


Once the ArrayList has been declared to be of 
type Date, it is not possible to add an element 
of type String. An attempt to do so produces 
a compiler error. 


Tested using JDK 1.7 under Win 7. 
FE IG IG EE EEE EE EEEE EEE EEEE EEE EE 2 2k ak af ak // 


import java.util.*; 
public class Generics04{ 
ArrayList <Date> vari = new ArrayList<Date>(); 
void runIt(){ 
vari.add("abcd") ; 
System. out.println(vari1.get(0).getTime()); 
}//end runIt 
public static void main(String[] args){ 
new Generics04() .runIt(); 


}//end main 


}//end class Generics04 


Table 4.136 
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Listing 9 . The program named Generics05. 


/*File Generics05.java 
Copyright 2005, R.G.Baldwin 


Illustrates required syntax for using an iterator 
with generics. Also illustrates the new for-each 
construct in Java 5.0 


Output for one particular run is shown below. 


1378070280877 
1378156680877 
1378243080877 


1378070280877 
1378156680877 
1378243080877 


Output will be different each time the program 
is run depending on the current date and time. 


Tested using JDK 1.7 under Win 7. 
FE AG IIA I IGA EE EEEE EEE EEEE EEE EE 2 2k ak af ak // 


import java.util.*; 


public class Generics05{ 
//Create an ArrayList object suitable for 
// storing references to Date objects. 
ArrayList <Date> vari = new ArrayList<Date>(); 


void runIt({ 
//Get current date and time in milliseconds. 
long now = new Date().getTime(); 
//Get length of one day in milliseconds 
long oneDay = 24 * 60 * 60 * 1000; 


//Populate the ArrayList object 
vari.add(new Date(now)); 

vari.add(new Date(now + oneDay)); 
vari.add(new Date(now + 2 * oneDay)); 


//Get an iterator 
Iterator <Date> iter = vari.iterator(); 


//Perform the iteration 
while (iter.hasNext())f{ 
System.out.println(iter.next().getTime()); 


}//end while loop 
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System.out.println();//blank line 


//Now perform the same iteration using 
// the new for-each construct. 
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Table 4.137 


-end- 
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4.3.2 Java4210r: Review of Getting Started” 
4.3.2.1 Table of Contents 


e Preface (p. 1581) 
e Questions (p. 1581) 


1 (p. 1581) , 2 (p. 1581) , 3 (p. 1582) , 4 (p. 1582) , 5 (p. 1583) , 6 (p. 1583) , 7 (p. 1583) , 8 
(p. 1584) , 9 (p. 1584) , 10 (p. 1586) , 11 (p. 1587) , 12 (p. 1588) , 13 (p. 1588) 


Images (p. 1590) 
Listings (p. 1590) 
Answers (p. 1592) 
Miscellaneous (p. 1597) 


4.3.2.2 Preface 


This module contains review questions and answers keyed to the module titled Java4210: Getting Started 
with Generics °° . 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back again. 


4.3.2.3 Questions 
4.3.2.3.1 Question 1 


True or False: When Java version 1.5 was released, it contained many new language features, including: 


Generics 

Enhanced for Loop 
Autoboxing/ Unboxing 
Collections 

Typesafe Enums 
Varargs 

Static Import 
Metadata 


Answer 1 (p. 1597) 


4.3.2.3.2 Question 2 


True or False: Using Java version1.7, the code shown in Listing 1 (p. 1582) will compile without warnings, 
errors, or other messages being generated by the compiler. 


49This content is available online at <http://cnx.org/content /m47555/1.6/>. 
°“°http://cnx.org/content /m47554/latest /?collection=col1 1441 /latest 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1576 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Listing 1 . Question 2 


/*File Q02.java 
AOAC IIRC CII I I II I I a A ak EEE EEEN 


import java.util.*; 
public class Q02{ 
ArrayList vari = new ArrayList(); 


void runiIt(){ 
vari.add(new Date(); 
//Note the required cast in the following 
// statement. 
System. out .print1n( 
((Date)var1.get(0)).getTime()) ; 


}//runiIt 
public static void main(String[] args){ 
new Q02().runIt(Q); 


}//end main 


}//end class Q02 


Table 4.138 


Answer 2 (p. 1597) 


4.3.2.3.3 Question 3 


Generics was introduced in Java v1.5 to provide which of the following: 


A. Code simplicity 

B. Compile-time type safety 

C. A clear and straightforward code syntax. 
D. None of the above. 


Answer 3 (p. 1597) 


4.3.2.3.4 Question 4 


True or False: The use of generics is limited to the Java Collections framework. 
Answer 4 (p. 1597) 
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4.3.2.3.5 Question 5 


True or False: The Java v1.7 compiler produces an error message when an attempt is made to compile the 
code shown in Listing 1 (p. 1582) . 

Answer 5 (p. 1596) 
4.3.2.3.6 Question 6 


True or False: When the code in Listing 1 (p. 1582) is compiled using the -Xlint:unchecked switch with 
Java v1.7, the compiler produces: 


e A. An error message 
e B. A warning 
e C. None of the above 


Answer 6 (p. 1596) 


4.3.2.3.7 Question 7 


True or False: The program code shown in Listing 2 (p. 1583) will compile and execute successfully to 
produce an output similar to that shown in Image 1 (p. 1584) . 


Listing 2 . Question 7. 


/*File QO7.java 
AOA O SSO OCIS GI ISIS II II II a A I A I Rk ak ka 4 / 


import java.util.*; 
public class QO7{ 
ArrayList vari = new ArrayList(Q); 
void runItQ{ 
vari.add(new Date(); 
System. out .print1n( 
(var1.get(0)).getTime()); 
3//runiIt 
public static void main(String[] args){ 
new Q07().runIt(Q); 


}//end main 


}//end class Q07 


Table 4.139 
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Image 1 . Question 7. 


1378054267172 


Table 4.140 


Answer 7 (p. 1596) 


4.3.2.3.8 Question 8 


What modification must be made to the code shown in Listing 2 (p. 1583) to cause it to compile and execute 
successfully? 
Answer 8 (p. 1595) 


4.3.2.3.9 Question 9 


True or False: The program code shown in Listing 3 (p. 1584) will compile and execute successfully to 
produce an output similar to that shown in Image 2 (p. 1586) . 


Listing 3 . Question 9. 


/*File Q09.java 
AOS OGG IOI IOI IRI CI CII II II a I a A ak ak ak ak EEEN 


import java.util.*; 
public class Q09{ 
ArrayList vari = new ArrayList(Q); 


void runIt({ 
vari.add(new Date(); 
vari.add("abcd") ; 
System. out .print1n( 
((Date)var1.get(1)).getTime()) ; 
System. out. print1n( 
((String) var1.get(1)).length()); 
}//end runIt 


public static void main(String[] args){ 
new Q09().runIt(); 
}//end main 


}//end class Q09 


Table 4.141 
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Image 2 . Question 9. 


1378056276557 
4 


Table 4.142 


Answer 9 (p. 1594) 


4.3.2.3.10 Question 10 


The code shown in Listing 4 (p. 1586) will not compile and run successfully. Without using a cast operator, 
what changes can you make to the class named Q10 to cause the program to compile and run successfully 


and to produce the current time in milliseconds? 


Listing 4 . Question 10. 


/*File Q10.java 
AOAC IOC IOI ORI II IDI I I a Kk kk ak ka / 


import java.util.*; 
public class Q10{ 
ArrayList vari = new ArrayList(); 


void runIt({ 
vari.add(new Date(); 
//Note the required cast in the following 
// statement. 
System. out. print1n( 
(varl.get(0)).getTime()); 


}//runiIt 
public static void main(String[] args){ 
new Q10().runItQ); 


}//end main 


}//end class Q10 


Table 4.143 


Answer 10 (p. 1593) 
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4.3.2.3.11 Question 11 


True or False: Using Java v1.7, even with the empty angle brackets shown in the instantiation of the 
ArrayList object in Listing 5 (p. 1587) , the program in Listing 5 (p. 1587) will compile and run successfully 
with no notes, warnings, errors, or other complaints from the compiler. The program will produce an output 
similar to that shown in Image 3 (p. 1587) . 


Listing 5 . Question 11. 


/*File Q11.java 
FOSS SOOO IORI IASI ARI ISI I II II I I a kk kk ak kak / 


import java.util.*; 
public class Q11{ 
ArrayList <Date> vari = new ArrayList<>(); 
void runIt(){ 
vari.add(new Date(); 
//Note the required cast in the following 
// statement. 


System. out .print1n( 
(var1.get(0)).getTime()); 


}//runiIt 

public static void main(String[] args){ 
new Q11Q.runItQ; 

}//end main 


}//end class Q11 


Table 4.144 


Image 3 . Question 11. 


1378059224125 


Table 4.145 


Answer 11 (p. 1593) 
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4.3.2.3.12 Question 12 


True or False: The program shown in Listing 6 (p. 1588) will compile and run successfully producing an 
output similar to that shown in Image 4 (p. 1588) . 


Listing 6 . Question 12. 


/*File Q12.java 
FESSOR OOO IOI SGI IOI IOI CI GI I I I Kk a ak ak / 


import java.util.*; 
public class Q12f{ 
ArrayList <Date> vari = new ArrayList<Date>(); 


void runIt(){ 
vari.add("abcd") ; 


System.out.printin(var1.get(0).getTime()); 
}//end runIt 


public static void main(String[] args){ 
new Q12().runItQ); 
}//end main 


}//end class Q12 


Table 4.146 


Image 4 . Question 12. 


1378060513651 


Table 4.147 


Answer 12 (p. 1593) 


4.3.2.3.13 Question 13 


True or False: The code shown in Listing 7 (p. 1589) will compile and run successfully and produce the 
output shown in Image 5 (p. 1589) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1583 


Listing 7 . Question 13. 


/*File Q13.java 
FOSS IORI IASI ORI II II II I I a Kk kk ak EEEN 


import java.util.*; 


public class Q13{ 
ArrayList <Integer> vari = new ArrayList<Integer>(); 


void runiIt(){ 


vari.add(new Integer(1)); 
vari.add(new Integer (2)); 
vari.add(new Integer (3)); 


//Get an iterator 
Iterator iter = vari.iterator(); 


//Perform the iteration 

while (iter.hasNext())f{ 
System.out.println(iter.next().intValue()); 

}//end while loop 


}//end runIt 
public static void main(String[] args){ 
new Q13().runItQ); 


}//end main 


}//end class Q13 


Table 4.148 


Image 5 . Question 13. 


N 


Table 4.149 


Answer 13 (p. 1592) 
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4.3.2.4 Images 


e Image 1 (p. 1584) . Question 7 

e Image 2 (p. 1586) . Question 9. 

e Image 3 (p. 1587) . Question 11. 
e Image 4 (p. 1588) . Question 12. 
e Image 5 (p. 1589) . Question 13. 
e Image 6 (p. 1593) . Answer 13. 

e Image 7 (p. 1593) . Answer 12. 

e Image 8 (p. 1594) . Answer 10. 

e Image 9 (p. 1595) . Answer 9. 

e Image 10 (p. 1596) . Answer 7. 

e Image 11 (p. 1596) . Answer 6. 

e Image 12 (p. 1597) . Answer 2. 


4.3.2.5 Listings 


e Listing 1 (p. 1582) . Question 2. 
e Listing 2 (p. 1583) . Question 7. 
e Listing 3 (p. 1584) . Question 9. 
e Listing 4 (p. 1586) . Question 10. 
e Listing 5 (p. 1587) . Question 11. 
e Listing 6 (p. 1588) . Question 12. 
e Listing 7 (p. 1589) . Question 13. 
e Listing 8 (p. 1592) . Answer 13. 
e Listing 9 (p. 1594) . Answer 10. 
e Listing 10 (p. 1595) . Answer 8. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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4.3.2.6 Answers 
4.3.2.6.1 Answer 13 


False. This program produces the error shown in Image 6 (p. 1593) below. You must qualify the iterator as 
shown in Listing 8 (p. 1592) to correct the error. If you don’t qualify the iterator, the reference is retrieved 
from the list as type Object. The Object class neither defines nor inherits a method named int Value. 


Listing 8 . Answer 13. 


/*File A13.java 
FESO SOA IOI GI IIRC II II II I I a kak kk ak ka 4 / 


import java.util.*; 


public class A13{ 
ArrayList <Integer> vari = new ArrayList<Integer>(); 


void runiIt(){ 


vari.add(new Integer(1)); 
vari.add(new Integer (2)); 
vari.add(new Integer (3)); 


//Get an iterator 
Iterator <Integer> iter = varl.iterator(); 


//Perform the iteration 

while (iter.hasNext())f{ 
System.out.println(iter.next().intValue()); 

}//end while loop 


}//end runIt 
public static void main(String[] args){ 
new Q13().runItQ; 


}//end main 


3//end class A13 


Table 4.150 
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Image 6 . Answer 13. 


Q13.java:22: error: cannot find symbol 
System.out.println(iter.next() .intValue()); 
symbol: method intValue() 
location: class Object 
1 error 


Table 4.151 


Back to Question 13 (p. 1588) 


4.3.2.6.2 Answer 12 


False. This program produces the compiler error shown in Image 7 (p. 1593) below. This is the result of 
attempting to store an object’s reference of type String in a collection reserved exclusively for references to 
objects of type Date. 


Image 7 . Answer 12. 


Q12.java:13: error: no suitable method found for add(String) 
vari.add("abcd") ; 
method ArrayList.add(int,Date) is not applicable 
(actual and formal argument lists differ in length) 
method ArrayList.add(Date) is not applicable 
(actual argument String cannot be converted to Date by method invocation 
conversion) 
1 error 


Table 4.152 


Back to Question 12 (p. 1588) 


4.3.2.6.3 Answer 11 


True. Updates made in Java v1.7 eliminated the requirement to insert the name of a type in those angle 
brackets in order to make the compiler happy. 
Back to Question 11 (p. 1587) 


4.3.2.6.4 Answer 10 


One solution is to add the generic syntax shown in the class named A10 in Listing 9 (p. 1594) below. This 
will cause the program to compile and execute successfully producing an output similar to that shown in 
Image 8 (p. 1594) below. 
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Listing 9 . Answer 10. 


/*File A10.java 
FESO SOS IOI GI ISIS II II II I I a A ak Rk ak EEEN 


import java.util.*; 
public class A10{ 
ArrayList <Date> vari = new ArrayList<Date>(); 
void runIt(){ 
vari.add(new Date(); 
//Note the required cast in the following 
// statement. 


System. out .print1n( 
(varl.get(0)).getTime()); 


}//runiIt 

public static void main(String[] args){ 
new A10().runItQ); 

}//end main 


3//end class A10 


Table 4.153 


Image 8 . Answer 10. 


1378058466149 


Table 4.154 


Back to Question 10 (p. 1586) 


4.3.2.6.5 Answer 9 


False: The program produces the runtime error shown in Image 9 (p. 1595) below. The (Date) cast is 
applied to the contents of the element at index 1. However, that element contains a reference to an object 
of type String. 
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Image 9 . Answer 9. 


Exception in thread "main" java.lang.ClassCastException: java.lang.String cannot 
be cast to java.util.Date 

at Q09.runIt (Q09. java:15) 

at Q09.main(Q09. java: 22) 


Table 4.155 


Back to Question 9 (p. 1584) 


4.3.2.6.6 Answer 8 


The program must be updated to include the cast operator (Date) shown in Listing 10 (p. 1595) below. 


Listing 10 . Answer 8. 


/*File Q08.java 
JOGO SOAS IOI GIO IORI II II II II a A a A ak ak ak ak ka 4 / 


import java.util.*; 
public class Q08{ 
ArrayList vari = new ArrayList(); 


void runit(){ 
vari.add(new Date(); 
//Note the required cast in the following 
// statement. 
System. out .print1n( 
((Date) var1.get(0)).getTime()) ; 


}//runiIt 

public static void main(String[] args){ 
new Q08().runIt(Q); 

}//end main 


}//end class Q08 


Table 4.156 


Back to Question 8 (p. 1584) 
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4.3.2.6.7 Answer 7 


False: This program produces the compiler error shown in Image 10 (p. 1596) below. 


Image 10 . Answer 7. 


QO7.java:17: error: cannot find symbol 
(var1.get(0)).getTime()); 


symbol: method getTime() 

location: class Object 
Note: QO7.java uses unchecked or unsafe operations. 
Note: Recompile with -Xlint:unchecked for details. 
1 error 


Table 4.157 
Back to Question 7 (p. 1583) 


4.3.2.6.8 Answer 6 


B. A warning 
The compiler output is shown in Image 11 (p. 1596) below: 


Image 11 . Answer 6. 


Q02.java:13: warning: [unchecked] unchecked call to add(E) as a member of the raw 
type ArrayList 
vari.add(new Date()); 
where E is a type-variable: 
E extends Object declared in class ArrayList 
1 warning 


Table 4.158 


Back to Question 6 (p. 1583) 


4.3.2.6.9 Answer 5 


False. Two notes are displayed. However, the messages produced by the Java v1.7 compiler in this cases are 
neither error messages nor warnings. Instead they are simply notes. The notes provide instructions on how 
to recompile and get more information regarding a potential problem. 

Back to Question 5 (p. 1583) 
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4.3.2.6.10 Answer 4 


False. The tentacles of generics reach into many different areas of Java in very complex ways including: 


Generic methods 
Generic classes 

Raw types 

Wildcards 

Generics and inheritance 


Back to Question 4 (p. 1582) 


4.3.2.6.11 Answer 3 

B. Compile-time type safety 
Back to Question 3 (p. 1582) 

4.3.2.6.12 Answer 2 


False: An attempt to compile the program using the Java v1.7 compiler produces an output similar to that 
shown in Image 12 (p. 1597) below. 


Image 12 . Answer 2. 


Note: Q02.java uses unchecked or unsafe operations. 
Note: Recompile with -Xlint:unchecked for details. 


Table 4.159 


Back to Question 2 (p. 1581) 


4.3.2.6.13 Answer 1 


False. The Collections framework was not new in Java v1.5. It was available long before version 1.5 was 
released. 

Back to Question 1 (p. 1581) 
4.3.2.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4210r Review 
e File: Java4210r.htm 

e Published: 09/01/13 

e Revised 08/17/15 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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4.3.3 Java4220r: Review of Generic Types” 
4.3.3.1 Table of Contents 


Preface (p. 1599) 
Questions (p. 1599) 


1 (p. 1599) , 2 (p. 1599) , 3 (p. 1600) , 4 (p. 1600) , 5 (p. 1600) , 6 (p. 1600) , 7 (p. 1601) , 8 
(p. 1602) , 9 (p. 1603) , 10 (p. 1604) , 11 (p. 1605) , 12 (p. 1606) , 13 (p. 1607) 


Images (p. 1608) 
Listings (p. 1608) 
Answers (p. 1610) 
Miscellaneous (p. 1613) 


4.3.3.2 Preface 


This module is one in a collection of modules on Java Generics designed for teaching ITSE2317 - Java 
Programming (Intermediate) at Austin Community College in Austin, TX. 

This and future modules in this series will be based on the Generics (Updated) 5? section of The Java 
Tutorials °? from Oracle. (In the event that these links become broken, you should have no difficulty finding 
the Oracle material with an online search.) 

You will find the learning resources for this module on the Oracle site at: 


e Generics (Updated) 54 
e Why Use Generics 55 
e Generic Types 56 


Raw Types 57 


This module contains review questions and answers keyed to the material in the above list. 

Once you study that material, you should be able to answer the review questions in this module. 

Once you complete your study of all the material on generics 58 , you should be able to answer the review 
questions at Questions and Exercises 5° on the Oracle site. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


4.3.3.3 Questions 
4.3.3.3.1 Question 1 


True or False: Generics add stability to your code by making more of your bugs detectable at runtime. 
Answer 1 (p. 1613) 


4.3.3.3.2 Question 2 


True or False: Generics enable types (classes and interfaces) to be parameters when defining classes, 
interfaces and methods. 
Answer 2 (p. 1613) 


51This content is available online at <http://cnx.org/content /m47562/1.4/>. 
>2http://docs.oracle.com/javase/tutorial/java/generics/ 
53http://docs.oracle.com/javase/tutorial/index.html 

4http://docs.oracle.com/javase /tutorial/java/generics/index.html 
'5http://docs.oracle.com/javase/tutorial/java/generics/why.html 
*6http://docs.oracle.com/javase/tutorial/java/generics/types.html 
57http://docs.oracle.com/javase/tutorial/java/generics/rawTypes.html 
*Shttp://docs.oracle.com/javase/tutorial/java/generics/index-html 
**http://docs.oracle.com/javase/tutorial/java/generics/QandE/generics-questions.html 
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4.3.3.3.3 Question 3 


True or False: Type parameters provide a way for you to re-use the same code with different inputs. The 
inputs to type parameters are values. 
Answer 3 (p. 1613) 


4.3.3.3.4 Question 4 


True or False: Code that uses generics provides the following benefits over non-generic code: 


e Stronger type checks at compile time. 
e Elimination of casts. 
e Enabling programmers to implement generic algorithms. 


Answer 4 (p. 1613) 


4.3.3.3.5 Question 5 


True or False: A generic type is a generic class or interface that is parameterized over types. 
Answer 5 (p. 1612) 


4.3.3.3.6 Question 6 


True or False: The code shown in Listing 1 (p. 1601) will compile and run successfully producing the output 
shown in Image 1 (p. 1601) . 
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Listing 1 . Question 6. 


/*File Q06.java 
FOS OOOO IORI IOI IOI ICI I II II II I I a kk kk ak ka 4 / 
public class Q06{ 


public static void main(String[] args){ 
Box box = new Box(); 
box.set (new Integer (5)); 
System. out .print1n( 
((Integer) (box. get())).intValue()); 
}//end main 
3//end class Q06 


class Boxf{ 
private Object object; 


public void set(Object object){ 
this.object = object; 
3//end set 


public Object get(){ 
return object; 


}//end get 
}//end Box 
/ /============================================= / / 
Table 4.160 
Image 1 . Question 6.. 
5 
Table 4.161 


Answer 6 (p. 1612) 


4.3.3.3.7 Question 7 


True or False: The code shown in Listing 2 (p. 1602) will compile and run successfully producing the output 
shown in Image 2 (p. 1602) . 
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Listing 2 . Question 7. 


/*File QO7.java 
FOSS OO IOI SIORISCI I I I I II I I a A ak Ak ak EEEN 
public class QO7{ 


public static void main(String[] args){ 
Box <Integer> box = new Box <Integer>(); 
box.set (new Integer (5)); 
System. out.println(box.get() .intValue()); 
}//end main 
3//end class Q07 


class Box{ 
private Object object; 


public void set(Object object){ 
this.object = object; 
}//end set 


public Object get(){ 
return object; 


}//end get 
}//end Box 
ff Seal eee mca a eer eee ee eee ne eS 2 
Table 4.162 
Image 2 . Question 7. 
5 
Table 4.163 


Answer 7 (p. 1612) 


4.3.3.3.8 Question 8 


Design and write a class named AO8Box which, when combined with the class defined in Listing 3 (p. 1603) 
will compile, run, and produce the output shown in Image 3 (p. 1603) . 
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Listing 3 . Question 8. 


/*File Q08.java 
FOCI O SIGIR OCI CII II II I I a A I A ak ak ka 4 / 
public class Q08{ 


public static void main(String[] args){ 
AO8Box <Integer> box = new AQ8Box <Integer>(); 
box.set (new Integer (5)); 
System. out.println(box.get() .intValue()); 
}//end main 
3//end class Q08 


Table 4.164 


Image 3 . Question 8. 


Table 4.165 


Answer 8 (p. 1611) 


4.3.3.3.9 Question 9 


True or False: The program with the "diamond" syntax shown in Listing 4 (p. 1604) will compile and run 
with no compiler complaints under Java v1.7, producing the output shown in Image 4 (p. 1604) . 
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Listing 4 . Question 9. 


/*File Q09.java 
FOSS OOS SIO SGI IORI CII II II I I a A ak Rk ak ka 4 / 
public class Q09{ 


public static void main(String[] args){ 
Box <> box = new Box <Integer>(); 
box.set (new Integer (5)); 
System. out.println(box.get() .intValue()); 
}//end main 
3//end class Q09 


class Box<T>{ 
private T t; 


public void set(T t){ 
this.t = t; 
}//end set 


public T get(){ 


return t; 
}//end get 
}//end Box 
/ [============================================= / / 
Table 4.166 
Image 4 . Question 9. 
5 
Table 4.167 


Answer 9 (p. 1611) 


4.3.3.3.10 Question 10 


True or False: The program with the "diamond" syntax shown in Listing 5 (p. 1605) will compile and run 
with no compiler complaints under Java v1.7, producing the output shown in Image 5 (p. 1605) . 
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Listing 5 . Question 10. 


/*File Q10.java 
FOSS IOC IIRC I II II I I a kk Rk ak ka 4 / 
public class Q10{ 


public static void main(String[] args){ 
Box <Integer> box = new Box <>(); 
box.set (new Integer (5)); 
System. out.println(box.get() .intValue()); 
}//end main 
3//end class Q10 


class Box<T>{ 
private T t; 


public void set(T t){ 
this.t = t; 
}//end set 


public T get(){ 


return t; 
}//end get 
}//end Box 
/ [============================================ / / 
Table 4.168 
Image 5 . Question 10. 
5 
Table 4.169 


Answer 10 (p. 1611) 


4.3.3.3.11 Question 11 


Design and write a class named A11Box which, when used in conjunction with the code shown in Listing 6 
(p. 1606) , will compile and run successfully producing the output shown in Image 6 (p. 1606) . 
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Listing 6 . Question 11. 


/*File Q11.java 
LEETEEEEEEEEEEEEE EE EEEEEEEEEEEEE I II II I I a A ak kk ak ka 4 / 
public class Q11{ 


public static void main(String[] args){ 
A1l1Box <Integer> box = 
new Al1Box <>(new Integer (5)); 
System. out.println(box.get() .intValue()); 
}//end main 
3//end class Q11 


Table 4.170 


Image 6 . Question 11. 


Table 4.171 


Answer 11 (p. 1610) 


4.3.3.3.12 Question 12 


Design and write a class named A12Box which, when used in conjunction with the code shown in Listing 7 
(p. 1607) , will compile and run successfully producing the output shown in Image 7 (p. 1607) . 
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Listing 7 . Question 12. 


/*File Q12.java 
ASCO SOG IOS EEEE EEEE EEEE EEEE EEEREN 
public class Q12{ 


public static void main(String[] args){ 
A12Box <String,Integer> boxA = 
new A12Box <>("abcde",new Integer(500)); 
System. out.println(boxA.get1()); 
System. out .println(boxA. get2()); 


A12Box <Integer,String> boxB = 
new A12Box <>(new Integer(900) ,"fghijkl"); 
System. out .print1n(boxB. get1()); 
System. out .print1n(boxB. get2()); 
}//end main 
3//end class Q12 


Table 4.172 


Image 7 . Question 12. 


abcde 
500 

900 
fghijkl 


Table 4.173 
Answer 12 (p. 1610) 


4.3.3.3.13 Question 13 


Given: When mixing legacy code with generic code, you may encounter messages similar to those shown in 
Image 8 (p. 1607) . 


Image 8 . Question 13. 


continued on next page 
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Note: Example.java uses unchecked or unsafe operations. 
Note: Recompile with -Xlint:unchecked for details. 


Table 4.174 


True or False: In such cases, the term "unchecked" means that the compiler does not have enough type 
information to perform all type checks necessary to ensure type safety. 
Answer 13 (p. 1610) 


4.3.3.4 Images 


. Question 13. 
Image 9 (p. 1611) . Answer 9. 
Image 10 (p. 1612) . Answer 7. 


e Image 1 (p. 1601) . Question 6. 
e Image 2 (p. 1602) . Question 7. 
e Image 3 (p. 1603) . Question 8. 
e Image 4 (p. 1604) . Question 9. 
e Image 5 (p. 1605) . Question 10. 
e Image 6 (p. 1606) . Question 11. 
e Image 7 (p. 1607) . Question 12. 
. (p. 1607) 

. (p. 1611) 

° 2 


4.3.3.5 Listings 


Listing 1 (p. 1601) . Question 6. 
Listing 2 (p. 1602) . Question 7. 
Listing 3 (p. 1603) . Question 8. 
Listing 4 (p. 1604) . Question 9. 


Listing 6 (p. 1606) . Question 11. 
Listing 7 (p. 1607) . Question 12. 
Listing 8 (p. 1610) . Answer 12. 
Listing 9 (p. 1611) . Answer 11. 
Listing 10 (p. 1612) . Answer 8. 


) 
( ) 
( ) 
( ) 

Listing 5 (p. 1605) . Question 10. 

( ) 
( ) 
( ) 
( ) 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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4.3.3.6 Answers 
4.3.3.6.1 Answer 13 
True. 
Back to Question 13 (p. 1607) 
4.3.3.6.2 Answer 12 


One possible solution is provided in Listing 8 (p. 1610) below. 


Listing 8 . Answer 12. 


/*File A12Box.java 
FOSSA IOI AAS Ia I II II EEEE EEE EEEE EEEE EE EEE ak ak EEEN 
public class A12Box<T1,T2>{ 

private T1 t1; 

private T2 t2; 


public A12Box(T1 t1,T2 t2){ 
this.ti = t1; 
this.t2 = t2; 

}//end constructor 


public T1 get1(){ 
return t1; 
}//end get1 


public T2 get2(){ 
return t2; 
}//end get2 
}//end A12Box 


Table 4.175 


Back to Question 12 (p. 1606) 


4.3.3.6.3 Answer 11 


One possible solution is provided in Listing 9 (p. 1611) below. 


Listing 9 . Answer 11. 


continued on next page 
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/*File A11Box.java 
FSCS SOS G IIIS I II II I I a A ak kk ak kak / 
public class A11Box<T>{ 

private T t; 


public A11Box(T t){ 
this.t = t; 
}//end constructor 


public T get(){ 
return t; 
}//end get 
}//end A11Box 


Table 4.176 
Back to Question 11 (p. 1605) 


4.3.3.6.4 Answer 10 


True. 
Back to Question 10 (p. 1604) 


4.3.3.6.5 Answer 9 


False. This program produces the error message shown in Image 9 (p. 1611) below. 


Image 9 . Answer 9. 


QO9.java:8: error: illegal start of type 
Box <> box = new Box <Integer>(); 


1 error 


Table 4.177 


Back to Question 9 (p. 1603) 


4.3.3.6.6 Answer 8 


One possible solution is shown in Listing 10 (p. 1612) below. 
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Listing 10 . Answer 8. 


/*File A08Box. java 
AOA O SS IOS CIO III CI CII II II I I a A ak Rk ak ka 4 / 
public class AO8Box<T>{ 

private T t; 


public void set(T t){ 
this.t = t; 
}//end set 


public T get(){ 
return t; 
}//end get 
}//end AO8Box 


Table 4.178 


Back to Question 8 (p. 1602) 


4.3.3.6.7 Answer 7 


False. This program produces the compiler errors shown in Image 10 (p. 1612) below. 


Image 10 . Answer 7. 


QO7.java:8: error: type Box does not take parameters 
Box <Integer> box = new Box <Integer>(); 

QO7.java:8: error: type Box does not take parameters 
Box <Integer> box = new Box <Integer>(); 


2 errors 


Table 4.179 


Back to Question 7 (p. 1601) 


4.3.3.6.8 Answer 6 
True. 
Back to Question 6 (p. 1600) 
4.3.3.6.9 Answer 5 
True. 
Back to Question 5 (p. 1600) 
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4.3.3.6.10 Answer 4 
True. 

Back to Question 4 (p. 1600) 
4.3.3.6.11 Answer 3 


False. The correct statement is: 

"Type parameters provide a way for you to re-use the same code with different inputs. The inputs to 
type parameters are types ." 

Back to Question 3 (p. 1600) 


4.3.3.6.12 Answer 2 
True, 
Back to Question 2 (p. 1599) 


4.3.3.6.13 Answer 1 


False. The correct statement is 
"Generics add stability to your code by making more of your bugs detectable at compile time 
Back to Question 1 (p. 1599) 


" 


4.3.3.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4220r: Review of Generic Types 
e File: Java4220r-htm 

e Published: 09/02/13 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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4.3.4 Java4230r: Review of Generic Methods” 
4.3.4.1 Table of Contents 


Preface (p. 1614) 
Questions (p. 1614) 


1 (p. 1614) , 2 (p. 1614) , 3 (p. 1614) , 4 (p. 1615) , 5 (p. 1615) , 6 (p. 1615) , 7 (p. 1616) , 8 
(p. 1617) 


Images (p. 1617) 
Listings (p. 1618) 
Answers (p. 1619) 
Miscellaneous (p. 1622) 


4.3.4.2 Preface 


This module is one in a collection of modules on Java Generics designed for teaching ITSE2317 - Java 
Programming (Intermediate) at Austin Community College in Austin, TX. 

This and future modules in this series will be based on the Generics (Updated) ® section of The Java 
Tutorials ©? from Oracle. (In the event that these links become broken, you should have no difficulty finding 
the Oracle material with an online search.) 

You will find the learning resources for this module on the Oracle site at: 


e Generic Methods ® 


This module contains review questions and answers keyed to the material in the above document. 

Once you study that material, you should be able to answer the review questions in this module. 

Once you complete your study of all the material on generics ® , you should be able to answer the review 
questions at Questions and Exercises ® on the Oracle site. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


4.3.4.3 Questions 

4.3.4.3.1 Question 1 

True or False: Generic methods are methods that introduce their own type parameters. 
Answer 1 (p. 1622) 

4.3.4.3.2 Question 2 


True or False: Defining a generic method is similar to declaring a generic type. The type parameter’s scope 
is limited to the class in which it is declared. 
Answer 2 (p. 1622) 


4.3.4.3.3 Question 3 


True or False: Generic methods may be either static or non-static. 
Answer 3 (p. 1622) 


6°This content is available online at <http://cnx.org/content /m47563/1.3/>. 
6Thttp://docs.oracle.com/javase/tutorial/java/generics/ 
§2http://docs.oracle.com/javase/tutorial/index.html 
§3http://docs.oracle.com/javase/tutorial/java/generics/methods.html 
§4http://docs.oracle.com/javase /tutorial/java/generics/index.html 
®5http://docs.oracle.com/javase/tutorial/java/generics/QandE/generics-questions.html 
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4.3.4.3.4 Question 4 


True or False: Generic class constructors are not allowed. 
Answer 4 (p. 1622) 


4.3.4.3.5 Question 5 


Design and write a class named A05Foo which, when combined with the class defined in Listing 1 (p. 1615) 
will compile, run, and produce the output shown in Image 1 (p. 1615) . 


Listing 1 . Question 5. 


/*File Q05.java 
FOGGIA IOC IIIS II II II I A I A ak kk ak ka 4 / 
public class QO5{ 


public static void main(String[] args){ 
AO5Foo fooA = new AO5Foo(); 
System.out.println(fooA.cat("abcd ","efgh")); 
System. out .print1n( 
fooA.cat("abcd ",new Integer(500))); 
System. out .print1n( 
fooA.cat(new Integer(500)," abcd")); 
}//end main 
3//end class Q05 


Table 4.180 


Image 1 . Question 5. 


abcd efgh 
abcd 500 
500 abcd 


Table 4.181 


Answer 5 (p. 1621) 


4.3.4.3.6 Question 6 


Design and write a class named AQ6Foo which, when combined with the class defined in Listing 2 (p. 1616) 
will compile, run, and produce the output shown in Image 2 (p. 1616) . 
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Listing 2 . Question 6. 


/*File QO06.java 
FSCO SOIC GI IORI CI CII II II I I I A ak Ak ak ka 4 / 
public class Q06{ 


public static void main(String[] args){ 
AO6Foo <String>fooA = new A06Foo<>(); 
fooA.set("_ijklm") ; 
System.out.println(fooA.cat("abcd ","efgh")); 
System. out .print1n( 
fooA.cat("abcd ",new Integer(500))); 
System. out .print1n( 
fooA.cat(new Integer(500)," abcd")); 
}//end main 
3//end class Q06 


Table 4.182 


Image 2 . Question 6. 


abcd efgh_ijklm 
abcd 500_ijk1m 
500 abcd_ijklim 


Table 4.183 


Answer 6 (p. 1620) 


4.3.4.3.7 Question 7 


Design and write a class named A07Foo which, when combined with the class defined in Listing 3 (p. 1617) 
will compile, run, and produce the output shown in Image 3 (p. 1617) . 
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Listing 3 . Question 7. 


/*File QO7.java 
LEETEEEEEEEEEEEEE EEEE GI IGRI OIC II II I I a A ak kk ak ka 4 / 
public class QO7{ 


public static void main(String[] args){ 
AO7Foo <Integer,String>fooA = 
new AO7Foo<>(" ijkl"); 
fooA.set (new Integer (-300)); 
System. out. print1n( 
fooA.cat("abcd "," efgh ")); 
System. out .print1n( 
fooA.cat("abcd ",new Integer(500))); 
System. out .print1n( 
fooA.cat(new Integer(500)," abcd ")); 
}//end main 
3//end class Q07 


Table 4.184 


Image 3 . Question 7. 


abcd efgh -300 ijkl 
abcd 500-300 ijkl 
500 abcd -300 ijkl 


Table 4.185 


Answer 7 (p. 1619) 


4.3.4.3.8 Question 8 


True or False: The syntax for a generic method includes a type parameter, inside angle brackets, and appears 
after the method’s return type 
Answer 8 (p. 1619) 


4.3.4.4 Images 


e Image 1 (p. 1615) . Question 5. 
e Image 2 (p. 1616) . Question 6. 
e Image 3 (p. 1617) . Question 7. 
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4.3.4.5 Listings 


Listing 1 (p. 1615) . Question 5. 
Listing 2 (p. 1616) . Question 6. 
Listing 3 (p. 1617) . Question 7. 


Listing 5 (p. 1621) . Answer 6. 
Listing 6 (p. 1621) . Answer 5. 


) 
( ) 
( ) 
Listing 4 (p. 1620) . Answer 7. 
( ) 
( ) 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None KEX) 


Display your namei 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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| Prob05a.jpg 


Put your name here 


4.3.4.6 Answers 
4.3.4.6.1 Answer 8 


False. The statement should read: 

"The syntax for a generic method includes a type parameter, inside angle brackets, and appears before 
the method’s return type" 

Back to Question 8 (p. 1617) 
4.3.4.6.2 Answer 7 


One possible solution is provided in Listing 4 (p. 1620) below. 
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Listing 4 . Answer 7. 


/*File A07Foo. java 
EEEE E EE EEEE EEE EE EEE EE EEE EEE EEEE EEEE EEE EE EEE ak ak EEE NA 
//A generic class 
public class A07Foo<T3,T4>{ 
private T3 tC; 
private T4 tD; 


//constructor 

public AO7Foo(T4 tD){ 
this.tD = tD; 

}//end constructor 


//A set method 

public void set(T3 tC){ 
this.tC = tC; 

}//end cat 


//A generic concatenation method 
public <T1,T2> String cat(T1 tA,T2 tB){ 
return tA.toString() + tB.toString() 
+ tC.toString() + tD.toString(); 
3//end cat 


}//end AO7Foo 


Table 4.186 


Back to Question 7 (p. 1616) 


4.3.4.6.3 Answer 6 


One possible solution is provided in Listing 5 (p. 1621) below. 
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Listing 5 . Answer 6. 


/*File A06Foo. java 
LEETEEEEEEEEEEEEEEEEEEEEEEEEEEEE EE EEEEEEEEEEE ETEN 
public class A06Foo<T3>{ 

private T3 tC; 


//A set method 

public void set(T3 tC){ 
this.tC = tC; 

}//end cat 


//A generic concatenation method 
public <T1,T2> String cat(T1 tA,T2 tB){ 
return tA.toString() + tB.toString() 
+ tC.toString() ; 
3//end cat 


}//end AO6Foo 


Table 4.187 


Back to Question 6 (p. 1615) 


4.3.4.6.4 Answer 5 


One possible solution is provided in Listing 6 (p. 1621) below. 


Listing 6 . Answer 5. 


/*File A05Foo. java 
LEETEEEEEEEEEEEEEEEEEEEEE EEEE EEE EE EE EEEEETEEE EEEN 
public class AO5Foo{ 

//A generic concatenation method 

public <T1,T2> String cat(T1 tA,T2 tB){ 

return tA.toString() + tB.toString(; 

3//end cat 

}//end AO5Foo 


Table 4.188 


Back to Question 5 (p. 1615) 
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4.3.4.6.5 Answer 4 


False. Generic class constructors are allowed. 
Back to Question 4 (p. 1615) 


4.3.4.6.6 Answer 3 


True. 
Back to Question 3 (p. 1614) 


4.3.4.6.7 Answer 2 


False. The statement should read as follows: 

"Defining a generic method is similar to declaring a generic type, but the type parameter’s scope is 
limited to the method where it is declared." 

Back to Question 2 (p. 1614) 


4.3.4.6.8 Answer 1 


True. 
Back to Question 1 (p. 1614) 


4.3.4.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4230r: Review of Generic Methods 
e File: Java4230r.htm 

e Published: 09/02/13 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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4.3.5 Java4240r: Review of Bounded Type Parameters” 
4.3.5.1 Table of Contents 


Preface (p. 1623) 
Questions (p. 1623) 


1 (p. 1623) , 2 (p. 1623) , 3 (p. 1624) , 4 (p. 1624) , 5 (p. 1625) , 6 (p. 1626) , 7 (p. 1626) , 8 
(p. 1628) , 9 (p. 1629) , 10 (p. 1630) 


Images (p. 1631) 
Listings (p. 1631) 
Answers (p. 1633) 
Miscellaneous (p. 1637) 


4.3.5.2 Preface 


This module is one in a collection of modules on Java Generics designed for teaching ITSE2317 - Java 
Programming (Intermediate) at Austin Community College in Austin, TX. 

This and future modules in this series will be based on the Generics (Updated) ® section of The Java 
Tutorials 8 from Oracle. (In the event that these links become broken, you should have no difficulty finding 
the Oracle material with an online search.) 

You will find the learning resources for this module on the Oracle site at: 


e Bounded Type Parameters °° 


Generic Methods and Bounded Type Parameters ° 


This module contains review questions and answers keyed to the material in the above listed documents. 

Once you study that material, you should be able to answer the review questions in this module. 

Once you complete your study of all the material on generics 7! , you should be able to answer the review 
questions at Questions and Exercises 7? on the Oracle site. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


4.3.5.3 Questions 


4.3.5.3.1 Question 1 


True or False: Bounded type parameters are used to restrict the types that can be used as arguments in a 
parameterized type. 
Answer 1 (p. 1636) 


4.3.5.3.2 Question 2 


True or False: To declare a bounded type parameter, list the type parameter’s name, followed by the 
extends or implements keyword, followed by its upper bound class or interface. 
Answer 2 (p. 1636) 


66This content is available online at <http://cnx.org/content /m47819/1.3/>. 
®7http://docs.oracle.com/javase/tutorial/java/generics/ 
68http://docs.oracle.com/javase/tutorial/index.html 
6®http://docs.oracle.com/javase/tutorial/java/generics/bounded.html 
“Ohttp://docs.oracle.com/javase/tutorial/java/generics/boundedTypeParams.html 
“\http://docs.oracle.com/javase /tutorial/java/generics/index.html 
“2http://docs.oracle.com/javase/tutorial/java/generics/QandE/generics-questions.html 
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4.3.5.3.3 Question 3 


True or False: A type parameter can have multiple bounds as shown in Image 1 (p. 1624) . 


Image 1 . Question 3. 


<T extends B1 & B2 & B3> 


Table 4.189 
Answer 3 (p. 1636) 


4.3.5.3.4 Question 4 


True or False: The code shown in Listing 1 (p. 1624) will compile and run successfully producing the output 
shown in Image 2 (p. 1625) . 


Listing 1 . Question 4. 


/*File Q04.java 
FE IG II I IOI EE EEEE EEE EEEE EEEE E EEE EE 
import java.awt.*; 
/*Note the following inheritance hierarchy 
java.lang.Object 
java.awt .Component 
java.awt.Container 
java.awt .Window 
java.awt.Frame 
*/ 
public class Q04{ 


public static void main(String[] args){ 
Foo <Window> aFoo = new Foo <>(); 
aFoo.runIt(); 
}//end main 
3//end class Q04 


class Foo<T extends Frame>{ 
public void runIt(){ 
System.out.println("Object instantiated."); 
}//end runIt 
}//end Foo 


Table 4.190 
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Image 2 . Question 4. 


Object instantiated. 


Table 4.191 
Answer 4 (p. 1636) 


4.3.5.3.5 Question 5 


Define and write a class named AQ5Foo which, when combined with the code shown in Listing 2 (p. 1625) 
will produce the output shown in Image 3 (p. 1625) . 


Listing 2 . Question 5. 


/*File Q05.java 
FE AI AG II I EE EEE EE EEEE EE EEEE EEEE EE a 2k EE 
import java.awt.*; 
/*Note the following inheritance hierarchy 
java.lang.Object 
java.awt .Component 
java.awt.Container 
java.awt .Window 
java.awt.Frame 
*/ 
public class Q05{ 


public static void main(String[] args){ 
AO5Foo <Window> aA05Foo = new AO5Foo <>(); 
aAO5Foo.runIt(); 
}//end main 
3//end class Q05 


Table 4.192 


Image 3 . Question 5. 


Object instantiated. 


Table 4.193 


Answer 5 (p. 1635) 
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4.3.5.3.6 Question 6 


Define and write a class named AQ6Foo which, when combined with the code shown in Listing 3 (p. 1626) 
will produce the output shown in Image 4 (p. 1626) . 


Listing 3 . Question 6. 


/*File Q06.java 
FE AI AG IA E EEEE EE EEEE EEE EEEE 21 21 EE 2k 2k ak kak // 
import java.awt.*; 
/*Note the following inheritance hierarchy 
java.lang.Object 
java.awt .Component 
java.awt.Container 
java.awt.Window 
java.awt.Frame 
*/ 
public class Q06{ 


public static void main(String[] args){ 
AO6Foo <Window> aAQ6Foo = 
new AO6Foo <Window>(new Frame()) ; 
aAOQ6Foo.runIt(); 
}//end main 
3//end class Q06 


Table 4.194 


Image 4 . Question 6. 


Object instantiated. 
class java.awt.Frame 


Table 4.195 


Answer 6 (p. 1634) 


4.3.5.3.7 Question 7 


True or False: The code shown in Listing 4 (p. 1627) will compile and run successfully producing the output 
shown in Image 5 (p. 1627) . 
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Listing 4 . Question 7. 


/*File QO7.java 
FE I AG IO I IOI I IOI I EEEE EEEE 21 21 1 4 E 2k 2k ak af ak // 
import java.awt.*; 
import javax.swing.*; 
/*Note the following inheritance hierarchy 
java.lang.Object 
java.awt .Component 
java.awt.Container 
java.awt .Window 
java.awt.Frame 
javax.swing. JFrame 
*/ 
public class QO7{ 
public static void main(String[] args){ 
JFrame aFrame = new JFrame("This is a title"); 
System. out.println(aFrame.getTitle()); 


Foo aFoo = new Foo(); 
aFoo.runIt (aFrame) ; 
}//end main 
3//end class Q07 


class Foof 
public <T extends Frame> void runIt(T ref){ 
System.out.println("Running runIt"); 
System. out.println(ref.getTitle()); 
}//end runIt 


3//end Foo 

/ [================================== )ť / 
Table 4.196 

Image 5 . Question 7. 

This is a title 

Running runIt 

This is a title 
Table 4.197 


Answer 7 (p. 1634) 
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4.3.5.3.8 Question 8 


True or False: The code shown in Listing 5 (p. 1628) will compile and run successfully producing the output 
shown in Image 6 (p. 1628) . 


Listing 5 . Question 8. 


/*File Q08.java 
FE I AG IAA I IOI EE EEEE A KK EEEE EEEE E 2k 2k ak af ak // 
import java.awt.*; 
import javax.swing.*; 
/*Note the following inheritance hierarchy 
java.lang.Object 
java.awt .Component 
java.awt.Container 
java.awt .Window 
java.awt.Frame 
javax.swing. JFrame 
*/ 
public class Q08{ 
public static void main(String[] args){ 
Frame aFrame = new Frame("This is a title"); 
System. out.println(aFrame.getTitle()); 


Foo aFoo = new Foo(); 
aFoo.runIt (aFrame) ; 
}//end main 
3//end class Q08 


class Foo{ 
public <T extends JFrame> void runIt(T ref){ 
System.out.println("Running runIt"); 
System. out.println(ref.getTitle()); 
}//end runIt 
3//end Foo 


Table 4.198 


Image 6 . Question 8. 


continued on next page 
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This is a title 


Table 4.199 


Answer 8 (p. 1634) 


4.3.5.3.9 Question 9 


True or False: The code shown in Listing 6 (p. 1629) will compile and run successfully producing the output 


shown in Image 7 (p. 1629) . 


Listing 6 . Question 9. 


/*File Q09.java 
FA IG IAG I IOI EE EEEE EEE EEEE 2k 21 EE 2 2k ak af ak / 
import java.awt.*; 
import javax.swing.*; 
/*Note the following inheritance hierarchy 
java.lang.Object 
java.awt .Component 
java.awt.Container 
java.awt .Window 
java.awt.Frame 
javax.swing. JFrame 
*/ 
public class Q09{ 
public static void main(String[] args){ 
JFrame aFrame = new JFrame("This is a title"); 
System. out.println(aFrame.getTitle()); 


Foo aFoo = new Foo(); 
aFoo.runIt (aFrame) ; 
}//end main 
3//end class Q09 


class Foof 
public <T> void runIt(T ref){ 
System.out.println("Running runIt"); 
System. out.println(ref.getTitle()); 
}//end runIt 
3//end Foo 


Table 4.200 
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Image 7 . Question 9. 


This is a title 


Answer 9 (p. 1633) 


4.3.5.3.10 Question 10 


Table 4.201 


True or False: The code shown in Listing 7 (p. 1630) will compile and run successfully producing the output 


shown in Image 8 (p. 1631) . 


Listing 7 . Question 10. 


/*File Q10.java 


import java.awt.*; 
import javax.swing.*; 


java.lang.Object 
java.awt .Component 
java.awt.Container 
java.awt .Window 
java.awt.Frame 


*/ 
public class Q10{ 


aFoo.runIt (aFrame) ; 
3//end main 
3//end class Q10 


class Foo{ 


}//end runIt 
3//end Foo 


Foo aFoo = new Foo(); 


kak A k A A I k ak ak 2k ak ak ak ak ək 2 2k əkək 2k k ək 2k 3k k ək 3k ək ək ək 3k ək ək ək 2K 2k ek 2K ÞK 2k KK ake // 


/*Note the following inheritance hierarchy 


javax.swing.JFrame 


public static void main(String[] args){ 
JFrame aFrame = new JFrame("This is a title"); 
System. out .println(aFrame.getTitle()); 


public <T extends Object> void runIt(T ref){ 
System. out .println("Running runIt"); 
System. out .println(ref.getTitle()); 
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Table 4.202 


Image 8 . Question 10. 


This is a title 


Table 4.203 


Answer 10 (p. 1633) 


4.3.5.4 Images 


e Image 1 (p. 1624) . Question 3. 
e Image 2 (p. 1625) . Question 4. 
e Image 3 (p. 1625) . Question 5. 
e Image 4 (p. 1626) . Question 6. 
e Image 5 (p. 1627) . Question 7. 
e Image 6 (p. 1628) . Question 8. 
e Image 7 (p. 1629) . Question 9. 
e Image 8 (p. 1631) . Question 10. 
e Image 9 (p. 1633) . Answer 10. 
e Image 10 (p. 1633) . Answer 9. 
e Image 11 (p. 1634) . Answer 8. 
e Image 12 (p. 1636) . Answer 4. 


4.3.5.5 Listings 


e Listing 1 (p. 1624) . Question 4. 

e Listing 2 (p. 1625) . Question 5. 

e Listing 3 (p. 1626) . Question 6. 

e Listing 4 (p. 1627) . Question 7. 

e Listing 5 (p. 1628) . Question 8. 

e Listing 6 (p. 1629) . Question 9. 

e Listing 7 (p. 1630) . Question 10. 
e Listing 8 (p. 1635) . Answer 6. 

e Listing 9 (p. 1635) . Answer 5. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 
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None KEX] 


Display your namet 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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4.3.5.6 Answers 
4.3.5.6.1 Answer 10 


False. This is an unsuccessful call to generic method with specified upper- bound of Object. The incoming 
reference is received as type Object and must be downcast to at least Frame to call the method named 
getTitle. The incoming parameter is received as the type of the specified upper-bound. This results in the 
compiler error shown in Image 9 (p. 1633) . 


Image 9 . Answer 10. 


Q10.java:36: error: cannot find symbol 
System. out.println(ref.getTitle()); 


symbol: method getTitle() 
location: variable ref of type T 
where T is a type-variable: 
T extends Object declared in method <T>runIt(T) 


1 error 


Table 4.204 


Back to Question 10 (p. 1630) 


4.3.5.6.2 Answer 9 


False. This is an unsuccessful call to generic method with default upper- bound of Object. The incoming 
reference is received as type Object and must be downcast to at least Frame to call the method named 
get Title. The incoming parameter is received as the type of the specified upper-bound which is Object by 
default. This results in the compiler error shown in Image 10 (p. 1633) . 


Image 10 . Answer 9. 


QO9.java:36: error: cannot find symbol 
System. out.println(ref.getTitle()); 
symbol: method getTitle() 
location: variable ref of type T 
where T is a type-variable: 
T extends Object declared in method <T>runIt(T) 


1 error 


Table 4.205 


Back to Question 9 (p. 1629) 
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4.3.5.6.3 Answer 8 


False. This is an unsuccessful call to a generic method where the type of the object passed to the method is 
above the upper bound on the specified generic type for the method. An attempt to compile the program 
results in the error shown in Image 11 (p. 1634) below. 


Image 11 . Answer 8. 


Q08.java:25: error: method runIt in class Foo 
cannot be applied to given types; 
aFoo.runIt (aFrame) ; 
required: T 
found: Frame 
reason: inferred type does not conform to declared bound(s) 
inferred: Frame 
bound(s): JFrame 
where T is a type-variable: 
T extends JFrame declared in method <T>runIt(T) 
1 error 


Table 4.206 
Back to Question 8 (p. 1628) 


4.3.5.6.4 Answer 7 


True. This is a successful call to a generic method where the generic type for the method is above (in the 
inheritance hierarchy) the type of object passed as a parameter. 
Back to Question 7 (p. 1626) 


4.3.5.6.5 Answer 6 


One possible solution is shown in Listing 8 (p. 1635) below. 
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Listing 8 . Answer 6. 


/*File AO6Foo. java 
FE I AG IIA EEEE EEE EE EEE EEEE EEEE EEE EE 2k 2k ak ak ak // 
import java.awt.*; 


public class AO6Foo<T extends Component>{ 
private T param; 


public AO6Foo(T param) { 
this.param = param; 
}//end constructor 


public void runIt(){ 
System.out.println("Object instantiated."); 
System. out.println(param.getClass()); 
}//end runIt 
}//end AQ6Foo 


Table 4.207 


Back to Question 6 (p. 1626) 


4.3.5.6.6 Answer 5 


One possible solution is shown in Listing 9 (p. 1635) below where T extends Component . However, 
causing T to extend Window, Container, Component, or Object would all be valid solutions. The upper 
bound for T must be at or above the type being passed as a type parameter in the inheritance hierarchy. 


Listing 9 . Answer 5. 


/*File A05Foo. java 
FE I AG EEEE EEE EEEE EE EEEE EE EEEE EEEE EE 2k 2k 2k af ak // 
import java.awt.*; 


public class AO5Foo<T extends Component>{ 
public void runIt(){ 
System.out.println("Object instantiated."); 
}//end runIt 
}//end AO5Foo 


Table 4.208 


Back to Question 5 (p. 1625) 
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4.3.5.6.7 Answer 4 


False. This program produces the compiler error shown in Image 12 (p. 1636) below. The problem is that 
the upper bound for the type parameter in the class named Foo (Frame) is below the type passed as a 
parameter (Window) in the attempt to instantiate an object of the class named Foo. 


Image 12 . Answer 4. 


Q04.java:20: error: type argument Window is not within bounds 
of type-variable T 
Foo <Window> aFoo = new Foo <>(); 
where T is a type-variable: 
T extends Frame declared in class Foo 
Q04.java:20: error: cannot infer type arguments for Foo<>; 
Foo <Window> aFoo = new Foo <>(); 
reason: no instance(s) of type variable(s) T exist so that 
Foo<T> conforms to 
Foo<Window> 
where T is a type-variable: 
T extends Frame declared in class Foo 
2 errors 


Table 4.209 


Back to Question 4 (p. 1624) 


4.3.5.6.8 Answer 3 


True. A type variable with multiple bounds is a subtype of all the types listed in the bound. If one of the 
bounds is a class, it must be specified first. 
Back to Question 3 (p. 1624) 


4.3.5.6.9 Answer 2 


False. The correct statement is: 

"To declare a bounded type parameter, list the type parameter’s name, followed by the extends key- 
word, followed by its upper bound. Note that, in this context, extends is used in a general sense to mean 
either "extends" (as in classes) or "implements" (as in interfaces)." 

Back to Question 2 (p. 1623) 


4.3.5.6.10 Answer 1 


True. There may be times when you want to restrict the types that can be used as type arguments in a 
parameterized type. For example, a method that operates on numbers might only want to accept instances 
of Number or its subclasses. This is what bounded type parameters are for. 

Back to Question 1 (p. 1623) 
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4.3.5.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4240r: Review of Bounded Type Parameters 
e File: Java4240r-htm 

e Published: 10/19/13 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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4.3.6 Java4250r: Review of Generics, Inheritance, and Subtypes” 
4.3.6.1 Table of Contents 


Preface (p. 1638) 
Questions (p. 1638) 


1 (p. 1638) , 2 (p. 1640) , 3 (p. 1641) , 4 (p. 1643) , 5 (p. 1645) , 6 (p. 1647) 


Images (p. 1649) 
Listings (p. 1649) 
Answers (p. 1651) 
Miscellaneous (p. 1652) 


4.3.6.2 Preface 


This module is one in a collection of modules on Java Generics designed for teaching ITSE2317 - Java 
Programming (Intermediate) at Austin Community College in Austin, TX. 

This and future modules in this series will be based on the Generics (Updated) ™ section of The Java 
Tutorials 7 from Oracle. (In the event that these links become broken, you should have no difficulty finding 
the Oracle material with an online search.) 

You will find the learning resources for this module on the Oracle site at Generics, Inheritance, and 
Subtypes 76 . 

This module contains review questions and answers keyed to the material in that document. 

Once you study that material, you should be able to answer the review questions in this module. 

Once you complete your study of all the material on generics “ , you should be able to answer the review 
questions at Questions and Exercises 78 on the Oracle site. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


4.3.6.3 Questions 


4.3.6.3.1 Question 1 


True or False: The code shown in Listing 1 (p. 1639) will compile and run successfully producing the output 
shown in Image 1 (p. 1639) . 


“3This content is available online at <http://cnx.org/content /m47822/1.4/>. 
“4http://docs.oracle.com/javase/tutorial/java/generics/ 
“5http://docs.oracle.com/javase/ tutorial /index.html 

“6http://docs.oracle.com/javase /tutorial/java/generics/inheritance.html 
“Thttp://docs.oracle.com/javase /tutorial/java/generics/index.html 
“8http://docs.oracle.com/javase/tutorial/java/generics/QandE/generics-questions.html 
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Listing 1 . Question 1. 


/*File QO1.java 

KKK 3K 3K 3K 3K 3K ak I I ICI 3K 3K 3K IOI OI OI OI I I a 3K 3K 3K K 3K 3K 3K ÞK ÞK ÞK ÞK ÞK FFF Fak K / 
/* 

Integer and Double are both subclasses of 

Number. Both classes define a method named 
doubleValue that returns the encapsulated 
numeric value as type double. 

*/ 

public class Q01{ 


public static void main(String[] args){ 
Foo <Integer> iFoo = new Foo <Integer>(15); 
System. out.println(iFoo.get() .doubleValue()); 


Foo <Double> dFoo = new Foo <Double>(1.0/3); 
System. out.println(dFoo.get() .doubleValue()) ; 


}//end main 
}//end class Q01 


class Foo<T extends Number>{ 
private T obj; 


public Foo(T obj) f{ 
this.obj = obj; 
}//end constructor 


public T get(){ 
return obj; 


}//end get 

}//end Foo 

/ /============================================= / / 
Table 4.210 

Image 1 . Question 1. 

15.0 

0. 3333333333333333 
Table 4.211 


Answer 1 (p. 1652) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1634 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


4.3.6.3.2 Question 2 


True or False: The code shown in Listing 2 (p. 1640) will compile and run successfully producing the output 


shown in Image 2 (p. 1641) . 


Listing 2 . Question 2. 


/*File Q02.java 

KKK 3K 3K 3K 3K GC I I aK 3K 3K 3K 3K 3K OI OI OI OI OI I I 3K 3K K 3K 3K 3K ÞK ÞK ÞK ÞK ÞK FFF Fk K / 
import java.awt.Frame; 

import javax.swing.JInternalFrame; 

import java.awt.Container; 

/* 

Frame and JInternalFrame are both subclasses of 
Container. Both classes define a constructor 
that accepts a String as a title. Both classes 
define a method named getTitle that returns the 
title string. 

*/ 

public class Q02{ 


public static void main(String[] args){ 
Foo <Frame> fFoo = 
new Foo <Frame>( 
new Frame("Frame title")); 
System. out.println(fFoo.get().getTitle()); 


Foo <JInternalFrame> jFoo = 
new Foo <JInternalFrame> ( 
new JInternalFrame( 
"JInternalFrame title")); 
System. out.println(jFoo.get().getTitle()); 


}//end main 
}//end class Q02 


class Foo<T extends Container>{ 
private T obj; 


public Foo(T obj) f 
this.obj = obj; 
}//end constructor 


public T get(){ 
return obj; 
}//end get 
3//end Foo 
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Table 4.212 
Image 2 . Question 2. 
Frame title 
JInternalFrame title 

Table 4.213 


Answer 2 (p. 1652) 


4.3.6.3.3 Question 3 


True or False: The code shown in Listing 3 (p. 1642) will compile and run successfully producing the output 
shown in Image 3 (p. 1643) . 
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Listing 3 . Question 3. 


/*File Q03.java 
KK aK 3K 3K 3K 3K 3K ak ak ak ak ak I ak I 3K 3K 3K 3K GI OI OI OI OI I I a a 3 3K K 3K 3K K ÞK ÞK ÞK ÞK ÞK FFF Fk K / 
public class Q03{ 
/* 
Integer and Double are both subclasses of 
Number. Both classes define a method named 
doubleValue that returns the encapsulated 
numeric value as type double. 
*/ 
public static void main(String[] args){ 
Foo <Integer> iFoo = new Foo <Integer>(15); 
System. out .println(iFoo.get().doubleValue()); 


Foo <Double> dFoo = new Foo <Double> (1.0/3); 
System. out .println(dFoo.get().doubleValue()); 


displayClassI(iFoo); 
displayClassD(dFoo) ; 
}//end main 


static void displayClassI(Foo<Integer> obj){ 
System. out.println(obj.getClass()); 
}//end displayClassI 


static void displayClassD(Foo<Double> obj){ 
System. out.println(obj.getClass()); 
}//end displayClassD 
3//end class Q03 


class Foo<T extends Number>{ 
private T obj; 


public Foo(T obj) f{ 
this.obj = obj; 
}//end constructor 


public T get(){ 
return obj; 
}//end get 
}//end Foo 


Table 4.214 
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Image 3 . Question 3. 


15.0 

0. 3333333333333333 
class Foo 

class Foo 


Table 4.215 


Answer 3 (p. 1652) 


4.3.6.3.4 Question 4 


True or False: The code shown in Listing 4 (p. 1644) will compile and run successfully producing the output 
shown in Image 4 (p. 1645) . 
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Listing 4 . Question 4. 


/*File Q04.java 

KKK 3K 3K 3K 3K 3K ak I I aK 3K 3K 3K 3K 3K OI OI OI OI OI I I I 3K 3K K 3K 3K K ÞK ÞK ÞK ÞK ÞK FFF Fk K / 
import java.awt.Frame; 

import javax.swing.JInternalFrame; 

import java.awt.Container; 

/* 

Frame and JInternalFrame are both subclasses of 
Container. Both classes define a constructor 
that accepts a String as a title. Both classes 
define a method named getTitle that returns the 
title string. 

*/ 

public class Q04{ 


public static void main(String[] args){ 
Foo <Frame> fFoo = 
new Foo <Frame>( 
new Frame("Frame title")); 
System. out.println(fFoo.get().getTitle()); 


Foo <JInternalFrame> jFoo = 
new Foo <JInternalFrame>( 
new JInternalFrame( 
"JInternalFrame title")); 
System. out.println(jFoo.get() .getTitle()); 


displayClassF (fFoo) ; 
displayClassJ(jFoo) ; 
}//end main 


static void displayClassF(Foo<Frame> obj) { 
System. out.println(obj.getClass()); 
}//end displayClassF 


static void displayClassJ( 
Foo<JInternalFrame> obj) { 
System. out.println(obj.getClass()); 
}//end displayClassJ 
3//end class Q04 


class Foo<T extends Container>{ 
private T obj; 


public Foo(T obj) f{ 

this.obj = obj; 
}//end constructor 
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return obj; 
}//end get 

}//end Foo 
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Table 4.216 
Image 4 . Question 4. 
Frame title 
JInternalFrame title 
class Foo 
class Foo 
Table 4.217 


Answer 4 (p. 1652) 


4.3.6.3.5 Question 5 


True or False: The code shown in Listing 5 (p. 1646) will compile and run successfully producing the output 
shown in Image 5 (p. 1647) . 
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Listing 5 . Question 5. 


/*File Q05.java 

KK aK K 3K 3K 3K 3K ak ak ak ak I I aK 3K 3K 3K 3K 3K OI OI OI OI OI I I 3K 3K 3K K 3K 3K 3K ÞK ÞK ÞK ÞK ÞK FFF Fk K / 
/* 

Integer and Double are both subclasses of 
Number. Both classes define a method named 
doubleValue that returns the encapsulated 
numeric value as type double. Both classes 
also contain a method named intValue that 
returns the encapsulated numeric value as 
type int. 

*/ 

public class Q05{ 


public static void main(String[] args){ 
Foo <Integer> iFoo = new Foo <Integer>(15); 
System. out.println(iFoo.get().intValue()); 


displayClass(iFoo) ; 
}//end main 


static void displayClass(Foo<Number> obj) { 
System. out.println(obj.getClass()); 
}//end displayClass 
}//end class Q05 


class Foo<T extends Number>{ 
private T obj; 


public Foo(T obj) f{ 
this.obj = obj; 
}//end constructor 


public T get(){ 
return obj; 
}//end get 
3//end Foo 


Table 4.218 
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Image 5 . Question 5. 


15 
class Foo 


Table 4.219 


Answer 5 (p. 1651) 


4.3.6.3.6 Question 6 


True or False: The code shown in Listing 6 (p. 1648) will compile and run successfully producing the output 
shown in Image 6 (p. 1649) . 
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Listing 6 . Question 6. 


/*File Q06.java 

KKK 3K 3K 3K 3K 3K ak I I 3K 3K 3K 3K 3K 3K OI OI OI OI OI I a a 3K 3K K 3K 3K 3K ÞK ÞK ÞK ÞK ÞK FF FF ak K / 
import java.awt.Frame; 

import javax.swing.JInternalFrame; 

import java.awt.Container; 

/* 

Frame and JInternalFrame are both subclasses of 
Container. Both classes define a constructor 
that accepts a String as a title. Both classes 
define a method named getTitle that returns the 
title string. 

*/ 

public class Q06{ 


public static void main(String[] args){ 
Foo <Frame> fFoo = 
new Foo <Frame>( 
new Frame("Frame title")); 
System. out.println(fFoo.get().getTitle()); 


displayClass(fFoo) ; 
}//end main 


static void displayClass(Foo<Container> obj){ 
System. out.println(obj.getClass()); 
}//end displayClass 


}//end class Q06 


class Foo<T extends Container>{ 
private T obj; 


public Foo(T obj) f{ 
this.obj = obj; 
}//end constructor 


public T get(){ 
return obj; 
}//end get 
3//end Foo 


Table 4.220 
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Image 6 . Question 6. 


Frame title 
class Foo 


Table 4.221 


Answer 6 (p. 1651) 


4.3.6.4 Images 


Image 1 (p. 1639) . Question 1. 
( ) . Question 2. 
( ) . Question 3. 
( ) . Question 4. 

Image 5 (p. 1647) . Question 5. 
( ) . Question 6. 
( ) . Answer 6. 
( ) 


. Answer 5. 


4.3.6.5 Listings 


Listing 1 (p. 1639) . Question 1. 
Listing 2 (p ) . Question 2. 
Listing 3 (p. 1642) . Question 3. 
Listing 4 (p. 1644) . Question 4. 
Listing 5 (p. 1646) . Question 5. 

( ) 


Listing 6 (p. 1648) . Question 6. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 
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None KEX] 


Display your namet 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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4.3.6.6 Answers 
4.3.6.6.1 Answer 6 


False. This program illustrates that you cannot pass an object of a parameterized class to a method that is 
designed to accept an incoming parameter of that class with a specific type of parameter that is a superclass 
of the actual type of parameter. An attempt to compile the program results in the error shown in Image 7 
(p. 1651) . 


Image 7 . Answer 6. 


Q06.java:29: error: method displayClass in class Q06 cannot be 
applied to given types; 
displayClass(fFoo) ; 


required: Foo<Container> 
found: Foo<Frame> 
reason: actual argument Foo<Frame> cannot be converted to 
Foo<Container> by method invocation conversion 
1 error 


Table 4.222 


Back to Question 6 (p. 1647) 


4.3.6.6.2 Answer 5 


False. This program illustrates that you cannot pass an object of a parameterized class to a method that is 
designed to accept an incoming parameter of that class with a specific type of parameter that is a superclass 
of the actual type of parameter. An attempt to compile the program results in the error shown in Image 8 
(p. 1651) . 


Image 8 . Answer 5. 


QO05.java:23: error: method displayClass in class Q05 cannot be 
applied to given types; 
displayClass(iFoo) ; 


required: Foo<Number> 
found: Foo<Integer> 
reason: actual argument Foo<Integer> cannot be converted to 
Foo<Number> by method invocation conversion 
1 error 


Table 4.223 


Back to Question 5 (p. 1645) 
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4.3.6.6.3 Answer 4 


True. This program illustrates passing an object of a parameterized class to a method that is designed to 
accept an incoming parameter of that class with a specific type of parameter. 
Back to Question 4 (p. 1643) 


4.3.6.6.4 Answer 3 


True. This program illustrates passing an object of a parameterized class to a method that is designed to 
accept an incoming parameter of that class with a specific type of parameter. 
Back to Question 3 (p. 1641) 


4.3.6.6.5 Answer 2 


True. This program illustrates the successful use of bounded type parameters. 
Back to Question 2 (p. 1640) 


4.3.6.6.6 Answer 1 


True. This program illustrates the successful use of bounded type parameters. It also illustrates the use of 
autoboxing to encapsulate primitive types int and double into objects of the wrapper classes Integer and 
Double. 

Back to Question 1 (p. 1638) 


4.3.6.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4250r: Review of Generics, Inheritance, and Subtypes 
e File: Java4250r-htm 

e Published: 10/20/13 

e Revised 08/21/15 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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4.3.7 Java4260r: Review of Type Inference” 
4.3.7.1 Table of Contents 


Preface (p. 1653) 
Questions (p. 1653) 


1 (p. 1653) , 2 (p. 1654) , 3 (p. 1655) , 4 (p. 1656) , 5 (p. 1658) , 6 (p. 1660) 


Images (p. 1662) 
Listings (p. 1662) 
Answers (p. 1664) 
Miscellaneous (p. 1665) 


4.3.7.2 Preface 


This module is one in a collection of modules on Java Generics designed for teaching ITSE2317 - Java 
Programming (Intermediate) at Austin Community College in Austin, TX. 

This and future modules in this series will be based on the Generics (Updated) 8° section of The Java 
Tutorials 8! from Oracle. (In the event that these links become broken, you should have no difficulty finding 
the Oracle material with an online search.) 

You will find the learning resources for this module on the Oracle site at Type Inference 8? . This module 
contains review questions and answers keyed to the material in that document. 

Once you study that material, you should be able to answer the review questions in this module. 

Once you complete your study of all the material on generics 8? , you should be able to answer the review 
questions at Questions and Exercises 4 on the Oracle site. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 

Note that much of the type inference material discussed in this module requires the use of Java SE 7 or 
a later version. 


4.3.7.3 Questions 


4.3.7.3.1 Question 1 


True or False: The code shown in Listing 1 (p. 1654) will compile and run successfully producing the output 
shown in Image 1 (p. 1654) . 


79This content is available online at <http://cnx.org/content /m47828/1.4/>. 
8°http://docs.oracle.com/javase/tutorial/java/generics/ 
8Thttp://docs.oracle.com/javase/tutorial/index.html 
82http://docs.oracle.com/javase/tutorial/java/generics/genTypeInference.html 
83http://docs.oracle.com/javase/tutorial/java/generics/index.html 
54http://docs.oracle.com/javase/tutorial/java/generics/QandE/generics-questions.html 
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Listing 1 . Question 1. 


/*File QO1.java 
FE I GC IIA I IOI EE EEEE EEE EEEE 21 21 EE 2 2k ak ak ak // 
import java.awt.*; 
/*Note the following inheritance hierarchy 
java.lang.Object 
java.awt .Component 
java.awt.Container 
java.awt.Window 
java.awt.Frame 
*/ 
public class Q01{ 


public static void main(String[] args){ 
Foo <Window> var = new Foo <Window>(); 
var.runĪt(); 
}//end main 
}//end class Q01 


class Foo<T extends Component>{ 
public void runIt(){ 
System.out.println("Object instantiated."); 
}//end runIt 
3//end Foo 


Table 4.224 


Image 1 . Question 1. 


Object instantiated. 


Table 4.225 


Answer 1 (p. 1665) 


4.3.7.3.2 Question 2 


True or False: The code shown in Listing 2 (p. 1655) will compile and run successfully producing the output 
shown in Image 2 (p. 1655) . 
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Listing 2 . Question 2. 


/*File Q02.java 
FE AG IO EEE EEEE EE EEEE EEE EEEE EEE EE 2k 2k ak af ak // 
import java.awt.*; 
/*Note the following inheritance hierarchy 
java.lang.Object 
java.awt .Component 
java.awt.Container 
java.awt.Window 
java.awt.Frame 
*/ 
public class Q02{ 


public static void main(String[] args){ 
Foo <Window> var = new Foo <>(); 
var .runIt(); 
}//end main 
3//end class Q02 


class Foo<T extends Component>{ 
public void runIt(){ 
System.out.println("Object instantiated."); 
}//end runIt 
3//end Foo 


Table 4.226 


Image 2 . Question 2. 


Object instantiated. 


Table 4.227 


Answer 2 (p. 1665) 


4.3.7.3.3 Question 3 


True or False: The code shown in Listing 3 (p. 1656) will compile and run successfully producing the output 
shown in Image 3 (p. 1656) . 
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Listing 3 . Question 3. 


/*File Q03.java 
FE IG II I I IGA EE EEEE A Kk EEEE EEE EE 2k 2k ak ak ak // 
import java.awt.*; 
/*Note the following inheritance hierarchy 
java.lang.Object 
java.awt .Component 
java.awt.Container 
java.awt.Window 
java.awt.Frame 
*/ 
public class Q03{ 


public static void main(String[] args){ 
Foo <> var = new Foo <Window>(); 
var .runIt(); 
}//end main 
}//end class Q03 


class Foo<T extends Component>{ 
public void runIt(){ 
System.out.println("Object instantiated."); 
}//end runIt 
3//end Foo 


Table 4.228 


Image 3 . Question 3. 


Object instantiated. 


Table 4.229 


Answer 3 (p. 1664) 


4.3.7.3.4 Question 4 


True or False: The code shown in Listing 4 (p. 1657) will compile and run successfully producing the output 
shown in Image 4 (p. 1657) . 
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Listing 4 . Question 4. 


/*File Q04.java 
LEETEEEEEEEEEEEEE EEEE GIGI CII I II II I A a A ak kk ak ka 4 / 
public class Q04{ 


public static void main(String[] args){ 
Foo <String,Integer> varA = 
new Foo <String, Integer>("abcde",500) ; 
System. out.print (varA.get1()); 
System.out.println("," + varA.get2()); 


Foo <Integer,String> varB = 

new Foo <Integer,String>(900,"fghijkl"); 
System. out.print (varB.get1()); 
System.out.printin("," + varB.get2()); 


}//end main 
}//end class Q04 


class Foo<T1,T2>{ 
private T1 t1; 
private T2 t2; 


public Foo(T1 t1,T2 t2){ 
this.ti = t1; 
this.t2 = t2; 

}//end constructor 


public T1 get1(){ 
return t1; 
}//end get1 


public T2 get2(){ 
return t2; 
}//end get2 
}//end Foo 


Table 4.230 


Image 4 . Question 4. 


continued on next page 
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abcde, 500 
900,fghijkl 


Table 4.231 


Answer 4 (p. 1664) 


4.3.7.3.5 Question 5 


True or False: The code shown in Listing 5 (p. 1659) will compile and run successfully producing the output 
shown in I mage 5 (p. 1659) . 
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Listing 5 . Question 5. 


/*File Q05.java 
FOSS SIO ISCO III SCI I II II I I a A a Ak ak ka / 
public class QO5{ 


public static void main(String[] args){ 
Foo <String,Integer> varA = 
new Foo <>("abcde",500); 
System. out.print (varA.get1()); 
System.out.printin("," + varA.get2()); 


Foo <Integer,String> varB = 

new Foo <>(900,"fghijkl"); 
System. out.print (varB.get1()); 
System.out.printin("," + varB.get2()); 


}//end main 
}//end class Q05 


class Foo<T1,T2>{ 
private T1 t1; 
private T2 t2; 


public Foo(T1 t1,T2 t2){ 
this.ti = t1; 
this.t2 = t2; 

}//end constructor 


public T1 get1(){ 
return t1; 
}//end get1 


public T2 get2(){ 
return t2; 
}//end get2 
}//end Foo 


Table 4.232 


Image 5 . Question 5. 


continued on next page 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1654 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


abcde, 500 
900, fghijkl 


Table 4.233 


Answer 5 (p. 1664) 


4.3.7.3.6 Question 6 


True or False: The code shown in Listing 6 (p. 1661) will compile and run successfully producing the output 
shown in Image 6 (p. 1661) . 
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Listing 6 . Question 6. 


/*File Q06.java 
FOSS IOS GIGI I II II I I I A ak Ak ak EEEN 
public class Q06{ 


public static void main(String[] args){ 
Foo <> varA = 
new Foo <String, Integer>("abcde",500) ; 
System. out.print (varA.get1()); 
System.out.printin("," + varA.get2()); 


Foo <> varB = 

new Foo <Integer,String>(900,"fghijkl"); 
System. out.print (varB.get1()); 
System.out.printin("," + varB.get2()); 


}//end main 
}//end class Q06 


class Foo<T1,T2>{ 
private T1 t1; 
private T2 t2; 


public Foo(T1 t1,T2 t2){ 
this.ti = t1; 
this.t2 = t2; 

}//end constructor 


public T1 get1(){ 
return t1; 
}//end get1 


public T2 get2(){ 
return t2; 
}//end get2 
}//end Foo 


Table 4.234 


Image 6 . Question 6. 


continued on next page 
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abcde, 500 
900, fghijkl 


Table 4.235 


Answer 6 (p. 1664) 


4.3.7.4 Images 


Image 1 (p. 1654) . Question 1. 
( ) . Question 2. 
( ). Question 3. 
( ) . Question 4. 

Image 5 (p. 1659) . Question 5. 
( ) . Question 6. 
( ). Answer 6. 
( ) 


. Answer 3. 


4.3.7.5 Listings 


Listing 1 (p. 1654) . Question 1. 
Listing 2 (p ) . Question 2. 
Listing 3 (p. 1656) . Question 3. 
Listing 4 (p. 1657) . Question 4. 
Listing 5 (p. 1659) . Question 5. 

( ) 


Listing 6 (p. 1661) . Question 6. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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4.3.7.6 Answers 
4.3.7.6.1 Answer 6 


False. This program illustrates incorrect use of the diamond for type inference and will not compile. In Java 
SE 7 and later, you can replace the type arguments required to invoke the constructor of a generic class with 
an empty set of matching angle brackets as long as the compiler can determine, or infer, the type arguments 
from the context. This pair of angle brackets, is informally called the diamond. However, in this case, the 
diamond is in the wrong location. This results in the errors shown in Image 7 (p. 1664) . 


Image 7 . Answer 6. 


Q06.java:18: error: illegal start of type 
Foo <> varA = 

Q06.java:23: error: illegal start of type 
Foo <> varB = 


2 errors 


Table 4.236 


Back to Question 6 (p. 1660) 


4.3.7.6.2 Answer 5 


True. This program illustrates type inference. In Java SE 7 and later, you can replace the type arguments 
required to invoke the constructor of a generic class with an empty set of matching angle brackets as long 
as the compiler can determine, or infer, the type arguments from the context. This pair of angle brackets, 
is informally called the diamond. 

Note that the Foo constructor requires two parameters and the types of those parameters are specified 
inside the angle brackets. 

Also note that the order of the types of the two parameters is swapped between the instantiation of the 
first and second objects. The program also illustrates autoboxing. 

Back to Question 5 (p. 1658) 


4.3.7.6.3 Answer 4 


True. This program illustrates generics without any obvious type inference. This is the style of programming 
that would have been used prior to the release of Java SE 7. 

Note that the Foo constructor requires two parameters and the types of those parameters are specified 
inside the angle brackets. 

Also note that the order of the types of the two parameters is swapped between the instantiation of the 
first and second objects. The program also illustrates autoboxing. 

Back to Question 4 (p. 1656) 


4.3.7.6.4 Answer 3 


False. This program illustrates incorrect use of the diamond for type inference and will not compile. In Java 
SE 7 and later, you can replace the type arguments required to invoke the constructor of a generic class with 
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an empty set of matching angle brackets as long as the compiler can determine, or infer, the type arguments 
from the context. This pair of angle brackets, is informally called the diamond. However, in this case, the 
diamond is in the wrong location. Therefore, the program produces the error shown in Image 8 (p. 1665) . 


Image 8 . Answer 3. 


Q03.java:26: error: illegal start of type 
Foo <> var = new Foo <Window>(); 


1 error 


Table 4.237 


Back to Question 3 (p. 1655) 


4.3.7.6.5 Answer 2 


True. This program illustrates bounded parameters along with type inference. In Java SE 7 and later, 
you can replace the type arguments required to invoke the constructor of a generic class with an empty set 
of matching angle brackets as long as the compiler can determine, or infer, the type arguments from the 
context. This pair of angle brackets, is informally called the diamond. 

Back to Question 2 (p. 1654) 


4.3.7.6.6 Answer 1 


True. This program illustrates generics with bounded parameters but without any obvious type inference. 
This is the style of programming that would have been used prior to the release of Java SE 7. 
Back to Question 1 (p. 1653) 


4.3.7.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4260r: Review of Type Inference 
e File: Java4260r-htm 

e Published: 10/22/13 

e Revised 08/17/15 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
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a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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4.3.8 Java4270r: Review of Wildcards’ 
4.3.8.1 Table of Contents 


Preface (p. 1667) 
Questions (p. 1667) 


1 (p. 1667) , 2 (p. 1670) , 3 (p. 1672) , 4 (p. 1674) , 5 (p. 1676) , 6 (p. 1678) 


Images (p. 1680) 
Listings (p. 1680) 
Answers (p. 1682) 
Miscellaneous (p. 1684) 


4.3.8.2 Preface 


This module is one in a collection of modules on Java Generics designed for teaching ITSE2317 - Java 
Programming (Intermediate) at Austin Community College in Austin, TX. 

This and future modules in this series will be based on the Generics (Updated) 86 section of The Java 
Tutorials 8” from Oracle. (In the event that these links become broken, you should have no difficulty finding 
the Oracle material with an online search.) 

You will find the learning resources for this module on the Oracle site at Wildcards °° . 

This module contains review questions and answers keyed to the material in Wildcards 8° . 

Once you study that material, you should be able to answer the review questions in this module. 

This is the final module in this series. This course does not cover the following topics: 


e Type Erasure % 


e Restrictions on Generics 9! 


However, once you complete your study of all the material on generics 9? , (including the two topics listed 
above) , you should be able to answer the review questions at Questions and Exercises °? on the Oracle site. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


4.3.8.3 Questions 


4.3.8.3.1 Question 1 


True or False: The code shown in Listing 1 (p. 1669) will compile and run successfully producing the output 
shown in Image 1 (p. 1670) . 


85This content is available online at <http://cnx.org/content /m47836/1.2/>. 
86http://docs.oracle.com/javase/tutorial/java/generics/ 
87http://docs.oracle.com/javase/tutorial/index.html 
88http://docs.oracle.com/javase/tutorial/java/generics/wildcards.html 
8®http://docs.oracle.com/javase/tutorial/java/generics/wildcards.html 
*°http://docs.oracle.com/javase/tutorial/java/generics/erasure.html 
®lhttp://docs.oracle.com/javase/tutorial/java/generics/restrictions.html 
®2http://docs.oracle.com/javase/tutorial/java/generics/index.html 
®*3http://docs.oracle.com/javase/tutorial/java/generics/QandE/generics-questions.html 
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Listing 1 . Question 1. 


/*File QO1.java 

FE AIG II I IGA EE EEE EEEE EEEE EEE EE 2k 2k ak ak ak // 
import java.util.ArrayList; 

import java.awt.Button; 

import java.awt.Label; 

import java.awt.Component; 


public class Q01{ 

/* 

Given: 

Button and Label are subclasses of the Component 
class. 

The getClass method is defined in the Object 
class. When called on a reference to an object, 
the method returns the name of the class from 
which the object was instantiated. 


*/ 


public static void main(String[] args){ 
//Create and populate a list designed to 
// store references to objects of type Button 
// and display its contents. 
ArrayList <Button> listA = new ArrayList<>(); 
listA.add(new Button("Button01")); 
listA.add(new Button("Button02")) ; 
display (listA) ; 
System. out .println("");//blank line 


//Create and populate a list designed to 
// store references to objects of type Label 
// and display its contents. 
ArrayList <Label> listB = new ArrayList<>(); 
listB.add(new Label ("Label101")); 
listB.add(new Label ("Label02")) ; 
display (listB) ; 

}//end main 


static void display(ArrayList<Component> list){ 
for(Component n : list){ 
System.out.println(n.getClass()); 
if(n instanceof Button) { 
System. out. print1n( 
((Button)n) .getLabel()); 
}else if(m instanceof Label) { 
System. out.println(((Label)n) .getText()); 
3//end else 
}//end for loop 
}//end display 


}//end class Q01 Available for free at Connexions <http://cnx.org/content /coll1441/1.181> 
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Table 4.238 
Image 1 . Question 1. 
class java.awt.Button 
Button01 
class java.awt.Button 
Button02 
class java.awt.Label 
Label01 
class java.awt.Label 
Label02 
Table 4.239 


Answer 1 (p. 1683) 


4.3.8.3.2 Question 2 


True or False: The code shown in Listing 2 (p. 1671) will compile and run successfully producing the output 
shown in Image 2 (p. 1672) . 
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Listing 2 . Question 2. 


/*File Q02.java 

FE A AG IA I IGA I IOI AI EEEE EEEE EEEE E 2k 2k ak kak / 
import java.util.ArrayList; 

import java.awt.Button; 

import java.awt.Label; 

import java.awt.Component; 


public class Q02{ 

/* 

Given: 

Button and Label are subclasses of the Component 
class. 

The getClass method is defined in the Object 
class. When called on a reference to an object, 
the method returns the name of the class from 
which the object was instantiated. 


*/ 


public static void main(String[] args){ 
//Create and populate a list designed to 
// store references to objects of type Button 
// and display its contents. 
ArrayList <Button> listA = new ArrayList<>(); 
listA.add(new Button("Button01")); 
listA.add(new Button("Button02")) ; 
display (listA) ; 
System. out .println("");//blank line 


//Create and populate a list designed to 
// store references to objects of type Label 
// and display its contents. 
ArrayList <Label> listB = new ArrayList<>(); 
listB.add(new Label ("Label01")); 
listB.add(new Label ("Label02")) ; 
display (listB) ; 

}//end main 


static void display( 
ArrayList<? extends Component> list){ 
for(Component n : list){ 
System.out.println(n.getClass()); 
if(n instanceof Button) { 
System. out. print1n( 
((Button)n) .getLabel()); 
}else if(m instanceof Label) { 
System. out.println(((Label)n) .getText()); 
3//end else 
}//end for loop 


}//end display Available for free at Connexions <http://cnx.org/content /col11441/1.181> 
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Table 4.240 
Image 2 . Question 2. 
class java.awt.Button 
Button01 
class java.awt.Button 
Button02 
class java.awt.Label 
Label01 
class java.awt.Label 
Label02 
Table 4.241 


Answer 2 (p. 1683) 


4.3.8.3.3 Question 3 


True or False: The code shown in Listing 3 (p. 1673) will compile and run successfully producing the output 
shown in Image 3 (p. 1674) . 
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Listing 3 . Question 3. 


/*File Q03.java 

FA AG IA I IOI I I I I I EEEE EEEE EEEE E 2k 2k ak af ak // 
import java.util.ArrayList; 

import java.awt.Button; 

import java.awt.Label; 

import java.awt.Component; 


public class QO03{ 

/* 

Given: 

Button and Label are subclasses of the Component 
class. 

The getClass method is defined in the Object 
class. When called on a reference to an object, 
the method returns the name of the class from 
which the object was instantiated. 


*/ 


public static void main(String[] args){ 
//Create and populate a list designed to 
// store references to objects of type Button 
// and display its contents. 
ArrayList <Button> listA = new ArrayList<>(); 
listA.add(new Button("Button01")); 
listA.add(new Button("Button02")) ; 
display (listA) ; 
System. out .println("");//blank line 


//Create and populate a list designed to 
// store references to objects of type Label 
// and display its contents. 
ArrayList <Label> listB = new ArrayList<>(); 
listB.add(new Label ("Label101")); 
listB.add(new Label ("Labe102")); 
display (listB) ; 

}//end main 


static void display (ArrayList<?> list) { 
for(Object n : list)f{ 
System.out.println(n.getClass()); 
if(n instanceof Button) { 
System. out. print1n( 
((Button)n) .getLabel()); 
}else if(m instanceof Label) { 
System. out.println(((Label)n) .getText()); 
3//end else 
}//end for loop 
}//end display 


}//end class Q03 Available for free at Connexions <http://cnx.org/content /coll1441/1.181> 
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Table 4.242 
Image 3 . Question 3. 
class java.awt.Button 
Button01 
class java.awt.Button 
Button02 
class java.awt.Label 
Label01 
class java.awt.Label 
Label02 
Table 4.243 


Answer 3 (p. 1683) 


4.3.8.3.4 Question 4 


True or False: The code shown in Listing 4 (p. 1675) will compile and run successfully producing the output 
shown in Image 4 (p. 1676) . 
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Listing 4 . Question 4. 


/*File Q04.java 

FA AG IA I IGA I IOI AI EEEE EEEE EEEE E 2 2k ak af ak / 
import java.util.ArrayList; 

import java.awt.Button; 

import java.awt.Label; 

import java.awt.Component; 


public class Q04{ 

/* 

Given: 

Button and Label are subclasses of the Component 
class. 

The getClass method is defined in the Object 
class. When called on a reference to an object, 
the method returns the name of the class from 
which the object was instantiated. 


*/ 


public static void main(String[] args){ 
//Create and populate a list designed to 
// store references to objects of type Button 
// and display its contents. 
ArrayList <Button> listA = new ArrayList<>(); 
listA.add(new Button("Button01")); 
listA.add(new Button("Button02")) ; 
display (listA) ; 
System. out .println("");//blank line 


//Create and populate a list designed to 
// store references to objects of type Label 
// and display its contents. 
ArrayList <Label> listB = new ArrayList<>(); 
listB.add(new Label ("Label01")); 
listB.add(new Label ("Label02")) ; 
display (listB) ; 

}//end main 


static void display (ArrayList<Object> list){ 
for(Object n : list)f{ 
System.out.println(n.getClass()); 
if(n instanceof Button) { 
System. out. print1n( 
((Button)n) .getLabel()) ; 
}else if(m instanceof Label) { 
System. out.println(((Label)n) .getText()); 
3//end else 
}//end for loop 
}//end display 


}//end class Q04 Available for free at Connexions <http://cnx.org/content /coll1441/1.181> 
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Table 4.244 
Image 4 . Question 4. 
class java.awt.Button 
Button01 
class java.awt.Button 
Button02 
class java.awt.Label 
Label01 
class java.awt.Label 
Label02 
Table 4.245 


Answer 4 (p. 1682) 


4.3.8.3.5 Question 5 


True or False: The code shown in Listing 5 (p. 1677) will compile and run successfully producing the output 
shown in Image 5 (p. 1678) . 
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Listing 5 . Question 5. 


/*File Q05.java 

FE A EEEE EEE EE EEEE EEE EE EE EEEE EEE EE EEE EE 2k 2k ak af ak / 
import java.util.ArrayList; 

import java.awt.Window; 

import java.awt.Frame; 

import javax.swing. JFrame; 


public class QO5{ 

/* 

Given: 

Component extends Object 

Container extends Component 

Window extends Container 

Frame extends Window 

JFrame extends Frame 

The getClass method is defined in the Object 
class. When called on a reference to an object, 
the method returns the name of the class from 
which the object was instantiated. 


*/ 
public static void main(String[] args){ 
Frame frameO = new Frame("FrameO") ; 


ArrayList <Frame> listA = new ArrayList<>(); 
listA.add(frame0) ; 

listA.add(new Frame("Frame1")) ; 

display (listA) ; 


ArrayList<Window> listB = new ArrayList<>(); 
listB.add(new Window(frame0)) ; 

listB.add(new Window(frame0)) ; 

display (listB) ; 


ArrayList<JFrame> listC = new ArrayList<>(); 
listC.add(new JFrame("JFrameO") ); 
listC.add(new JFrame("JFramei")); 
display (listC) ; 

}//end main 


static void display( 
ArrayList<? super JFrame> list) { 
for(Object n : list)f{ 
System.out.println(n.getClass()); 
}//end for loop 
System. out .println();//blank line 
}//end display 


ł//end class QO5 Available for free at Connexions <http://cnx.org/content /coll1441/1.181> 
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Table 4.246 


Image 5 . Question 5. 


class java.awt.Frame 
class java.awt.Frame 


class java.awt.Window 
class java.awt.Window 


class javax.swing. JFrame 
class javax.swing. JFrame 


Table 4.247 


Answer 5 (p. 1682) 


4.3.8.3.6 Question 6 


True or False: The code shown in Listing 6 (p. 1679) will compile and run successfully producing the output 
shown in Image 6 (p. 1680) . 
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Listing 6 . Question 6. 


/*File Q06.java 

FE AG IIA I IOI I I IOI I EEEE EEEE EEE EE 2k 2k ak ak ak // 
import java.util.ArrayList; 

import java.awt.Window; 

import java.awt.Frame; 

import javax.swing. JFrame; 


public class QO06{ 

/* 

Given: 

Component extends Object 

Container extends Component 

Window extends Container 

Frame extends Window 

JFrame extends Frame 

The getClass method is defined in the Object 
class. When called on a reference to an object, 
the method returns the name of the class from 
which the object was instantiated. 


*/ 
public static void main(String[] args){ 
Frame frameO = new Frame("FrameO") ; 


ArrayList <Frame> listA = new ArrayList<>(); 
listA.add(frame0) ; 

listA.add(new Frame("Frame1")) ; 

display (listA) ; 


ArrayList<Window> listB = new ArrayList<>(); 
listB.add(new Window(frame0)) ; 

listB.add(new Window(frame0)) ; 

display (listB) ; 


ArrayList<JFrame> listC = new ArrayList<>(); 
listC.add(new JFrame("JFrameO") ); 
listC.add(new JFrame("JFramei")); 
display (listC) ; 

}//end main 


static void display( 
ArrayList<? super Frame> list){ 
for(Object n : list)f{ 
System.out.println(n.getClass()); 
}//end for loop 
System. out .println();//blank line 
}//end display 


ł//end class Q06 Available for free at Connexions <http://cnx.org/content /coll1441/1.181> 
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Table 4.248 


Image 6 . Question 6. 


class java.awt.Frame 
class java.awt.Frame 


class java.awt.Window 
class java.awt.Window 


class javax.swing. JFrame 
class javax.swing. JFrame 


Table 4.249 


Answer 6 (p. 1682) 


4.3.8.4 Images 


e Image 1 (p. 1670) . Question 1. 
e Image 2 (p. 1672) . Question 2. 
e Image 3 (p. 1674) . Question 3. 
e Image 4 (p. 1676) . Question 4. 
e Image 5 (p. 1678) . Question 5. 
e Image 6 (p. 1680) . Question 6. 
e Image 7 (p. 1682) . Answer 6. 

e Image 8 (p. 1682) . Answer 4. 

e Image 9 (p. 1684) . Answer 1. 

4.3.8.5 Listings 

e Listing 1 (p. 1669) . Question 1. 
e Listing 2 (p. 1671) . Question 2. 
e Listing 3 (p. 1673) . Question 3. 
e Listing 4 (p. 1675) . Question 4. 
e Listing 5 (p. 1677) . Question 5. 
e Listing 6 (p. 1679) . Question 6. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1676 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


4.3.8.6 Answers 
4.3.8.6.1 Answer 6 


False. This program attempts to illustrate the use of a lower bounded wildcard to define a generic method 
that will accept an incoming reference to an object of a generic class where the parameter type for the object 
is equal to or above the type of the wildcard in the inheritance hierarchy. The lower bounded wildcard type 
for the display method is Frame. Therefore, the display method will accept references to ArrayList objects 
for parameter types Frame, Window, Container, Component, or Object, but it will not accept a reference to 
an ArrayList object for parameter type JFrame. Therefore, the program will not compile, resulting in the 
error shown in Image 7 (p. 1682) . 


Image 7 . Answer 6. 


Q06.java:56: error: method display in class Q06 cannot be applied 
to given types; 
display (listC) ; 


required: ArrayList<? super Frame> 
found: ArrayList<JFrame> 
reason: actual argument ArrayList<JFrame> cannot be converted to 
ArrayList<? super Frame> by method invocation conversion 
1 error 


Table 4.250 


Back to Question 6 (p. 1678) 


4.3.8.6.2 Answer 5 


True. This program illustrates the use of a lower bounded wildcard to define a generic method that will 
accept an incoming reference to an object of a generic class where the parameter type for the object is equal 
to or above the type of the wildcard in the inheritance hierarchy. The lower bounded wildcard type for the 
display method is JFrame. Therefore, the display method will accept references to ArrayList objects for 
parameter types JFrame, Frame, Window, Container, Component, or Object 

Back to Question 5 (p. 1676) 


4.3.8.6.3 Answer 4 


False. This program illustrates the fact that a parameter of type Object is not the same as an unbounded 
wildcard parameter. The program refuses to compile and produces the errors shown in Image 8 (p. 1682) . 


Image 8 . Answer 4. 


continued on next page 
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Q04.java:31: error: method display in class Q04 cannot be applied 
to given types; 
display (listA) ; 


required: ArrayList<Object> 

found: ArrayList<Button> 

reason: actual argument ArrayList<Button> cannot be converted to 
ArrayList<Object> by method invocation conversion 


Q04.java:40: error: method display in class Q04 cannot be applied 
to given types; 
display (listB) ; 


required: ArrayList<Object> 
found: ArrayList<Label> 
reason: actual argument ArrayList<Label> cannot be converted to 
ArrayList<Object> by method invocation conversion 
2 errors 


Table 4.251 


Back to Question 4 (p. 1674) 


4.3.8.6.4 Answer 3 


True. This program illustrates two scenarios where an unbounded wildcard is a useful approach: 

1. When you are writing a method that can be implemented using functionality provided in the Object 
class. The getClass method that is called in the display method is defined in the Object class. 

2. When the code in a generic method doesn’t depend on the type parameter. An if-else statement along 
with specific casts is used in the display method to isolate the calls to the getText and getLabel methods 
from the type parameter. 

Back to Question 3 (p. 1672) 


4.3.8.6.5 Answer 2 


True. This program illustrates the use of upper bounded wildcards. The method named display will accept 

and process a reference to an ArrayList object whose element types are Component or any subclass of 

Component. Methods that are defined in or inherited into the Component class can be called on the 

elements with no requirement for a cast. Methods that are not defined in or inherited into the Component 

class but are defined in the element classes can be called on the elements after casting to the element type. 
Back to Question 2 (p. 1670) 


4.3.8.6.6 Answer 1 


False. This program will not compile. The method named display will only accept and process a reference 
to an ArrayList object whose element are of type Component. ArrayList objects whose element types are 
subclasses of Component do not satisfy that requirement. An attempt to compile the program produces the 
errors shown in Image 9 (p. 1684) . 
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Image 9 . Answer 1. 


Q01.java:34: error: method display in class Q01 
cannot be applied to given types; 
display (listA) ; 


required: ArrayList<Component > 

found: ArrayList<Button> 

reason: actual argument ArrayList<Button> cannot be converted to 
ArrayList<Component> by method invocation conversion 


Q01.java:43: error: method display in class Q01 cannot be applied 
to given types; 
display (listB) ; 


required: ArrayList<Component > 
found: ArrayList<Label> 
reason: actual argument ArrayList<Label> cannot be converted to 
ArrayList<Component> by method invocation conversion 
2 errors 


Table 4.252 
Back to Question 1 (p. 1667) 


4.3.8.7 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4270r: Review of Wildcards 
e File: Java4270r.htm 

e Published: 10/24/13 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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4.4 Event Handling 


4.4.1 Jy0035: Java OOP: Preface to Event Handling” 
4.4.1.1 Additional material 


While much of the material required for success in the Event Handling portion of this course is contained 
in this sub-collection, other important material is contained in the sub-collection titled Essence of OOP 
and the collection titled Programming Oldies But Goodies °° . 

There is a large Essence of OOP section for the prerequisite course ( ITSE 2321 °° ) . In addition, 
the material in the Essence of OOP section that is particularly germane to this course is listed below: 


e Java OOP: The AWT and Swing, A Preview 9” 

e Java OOP: Callbacks - I 9° 

e Java OOP: Event Handling in JDK 1.1, A First Look, Delegation Event Model °’ 
e Java OOP: Swing and the Delegation Event Model 10° 

e Java OOP: Member Classes 1°! 

e Java OOP: Local Classes 1°? 

e 


Java OOP: Anonymous Classes 103 


(Note in particular that the module titled Java OOP: Anonymous Classes ‘°4 contains quite a lot of 
material on event handling in addition to the material on anonymous classes. You will need to understand 
the material on anonymous classes as well as the material on event handling to succeed in the Event 
Handling portion of this course.) 

The material in the Programming Oldies But Goodies } collection has not yet been converted to the 
cnxml format required by cnx.org for the publication of top-level modules. Instead, the material in that 
collection is still in its original html format awaiting conversion. 

Here is a partial list of some of the material in that collection that you may find useful for an understanding 
of event handling: 


Java082 1°° Sharing a Listener Object Among Visual Components 

Java087 1°" Swing, Understanding getContentPane() and other JFrame Layers 
Java092 '°8 Mouse Motion Events 

Java094 19° Using Abbreviated Inner Classes 

Javal14 !!° BorderLayout 

Javal16 !!! FlowLayout 


°4This content is available online at <http://cnx.org/content /m47842/1.8/>. 
°*Shttp://cnx.org/content /col11478 /latest / 
°Shttp://cnx.org/contents/e86afl09-f5f1-4de8-a8f0-be0ef2d87567 
®7http://cnx.org/content /m44331 /latest /?collection=col11441 /latest 
°*Shttp://cnx.org/content /m44333/latest /?collection=col11441/latest 
°*°http://cnx.org/content /m44340/latest /?collection=col11441 /latest 
100http://cnx.org/content /m44336 /latest /?collection=col11441 /latest 
10lhttp://cnx.org/content /m44347 /latest /?collection=col11441/latest 
102http://cnx.org/content /m44346 /latest /?collection=col11441 /latest 
103http://cnx.org/content /m44342/latest /?collection=col11441/latest 
14h ttp://cnx.org/content /m44342/latest /?collection=col11441/latest 
l05http://cnx.org/content /col11478 /latest / 
106 http://cnx.org/content /m45597 /latest /Java082.htm 
107http://cnx.org/content /m45597 /latest /Java087.htm 
108http://cnx.org/content /m45597 /latest /Java092.htm 
109http://cnx.org/content /m45597 /latest /Java094.htm 
10http://cnx.org/content /m45597 /latest /Javal14.htm 
11http://cnx.org/content /m45597 /latest /Javal16.htm 
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A more exhaustive list of useful tutorials in the Programming Oldies But Goodies 11? collection is provided 
here 113 , 


4.4.1.2 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jy0035: Java OOP: Preface to Event Handling 
e File: Jy0035.htm 

e Published: 10/26/13 

e Revised 09/04/15 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


Į also want you to know that I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


4.4.2 Event Handling with Graphics 
4.4.2.1 Part 1 
4.4.2.1.1 Java OOP: Modifying the World and SimpleTurtle Classes’ 


14 


4.4.2.1.1.1 Table of Contents 
e Preface (p. 1687) 


Viewing tip (p. 1687) 


x Figures (p. 1687) 
x Listings (p. 1687) 


Preview (p. 1687) 

Discussion and sample code (p. 1692) 
Run the program (p. 1695) 
Summary (p. 1695) 

What’s next? (p. 1695) 
Miscellaneous (p. 1695) 

Complete program listings (p. 1696) 


1l2http://cnx.org/content /col11478 /latest / 
113h¢tp://cnx.org/contents/Ofda6dee-686e-4448-b6c3-407396ed 12c8 
114This content is available online at <http://cnx.org/content /m44330/1.2/>. 
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4.4.2.1.1.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 11° . 


4.4.2.1.1.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.1.1.2.1.1 Figures 


e Figure 1 (p. 1690) . The required graphic output image. 
e Figure 2 (p. 1692) . Required output on the command line screen. 


4.4.2.1.1.2.1.2 Listings 


e Listing 1 (p. 1693) . Modification to load a jpg file by default. 

e Listing 2 (p. 1693) . Original array containing turtle colors. 

e Listing 3 (p. 1694) . Modified array of turtle colors. 

e Listing 4 (p. 1694) . Change the initial heading. 

e Listing 5 (p. 1696) . Source code for driver class named Prob01.. 

e Listing 6 (p. 1697) . Source code for the modified World class.. 

e Listing 7 (p. 1699) . Source code for the modified SimpleTurtle class.. 


4.4.2.1.1.3 Preview 


Program specifications 

Write a program named Prob01 that uses the class definition shown in Listing 5 (p. 1696) and Ericson’s 
media library along with the image file named Prob01.jpg to produce the graphic output image shown 
in Figure 1 (p. 1690) . 


15 http://cnx.org/content /m44148/latest / 
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Dick Baldwin 
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Dick Baldwin 
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Figure 1 . The required graphic output image. 


Bw oi 


Dick Baldwin 


Table 4.253 


No new classes 

You may not define any new classes to cause your program to behave as required, and you may not 
modify the class definition for the class named Prob0O1 given in Listing 5 (p. 1696) . You must copy and 
modify (if necessary) the following media classes to cause your program to produce the required output: 


e World.java 
e Turtle.java 
e SimpleTurtle.java 


Files in your folder 
Your folder must contain only the following class files, source-code files, and image files: 


Prob01.class 
Prob01.java 
Prob01.jpg 
SimpleTurtle.class 
SimpleTurtle.java 
Turtle.class 
Turtle.java 
World.class 
World.java 


Output text 
In addition to the output image described above, your program must produce the output text on the 
command- line screen shown in Figure 2 (p. 1692) . 
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Figure 2 . Required output on the command line screen. 


Dick Baldwin 
Picture, filename Prob01.jpg height 274 width 365 
Dick Baldwin 
Dick Baldwin 
Dick Baldwin 
Dick Baldwin 


Table 4.254 


You must substitute your name for mine wherever my name appears in the image and on the command- 
line screen. 
An analysis 
As is often the case, the real challenge with this problem is to decide what needs to be done to satisfy 
the specifications. 
Required modifications 
By comparing the default behavior of the World and SimpleTurtle classes with the requirements 
of this program, it can be determined that the following modifications to the World and SimpleTurtle 
classes are required to meet the specifications. (Modification of the Turtle class is not required) : 


e Modify the World class to load a picture named Prob01.jpg as the default background for the 

world in place of the all-white Picture object. 

Modify the World class to display the student’s name near the top of the image. 

e Modify the World class to display the student’s name and information about the picture on the 

command-line screen. 

e Modify the SimpleTurtle class to change the initial heading for new turtle objects to northeast 

instead of north. 

e Modify the SimpleTurtle class to change the order in which colors are assigned to new turtles as 
they are instantiated. 


4.4.2.1.1.4 Discussion and sample code 
4.4.2.1.1.4.1 Modifications to the World class 


Ericson’s World class was modified to cause it to load a jpg file by default instead of displaying a blank 
picture by default. It was also modified to cause it to display text on the background image and to display 
text on the command line screen. These changes are reflected in Figure 1 (p. 1690) and Figure 2 (p. 1692) . 

A complete listing of the modified World class is shown in Listing 6 (p. 1697) . 

Modifying the code 

The code used to accomplish the modifications described above is shown in Listing 1 (p. 1693) . 


Listing 1 . Modification to load a jpg file by default. 


continued on next page 
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//create the background picture 
//picture = new Picture(width, height) ; 
picture = new Picture("Prob01. jpg"); 


picture.addMessage("Dick Baldwin",10,20); 
System. out.println(picture) ; 


Table 4.255 


Note that one original statement was disabled and replaced by three new statements. 

In addition, several other println statements were added at strategic locations within the World and 
SimpleTurtle classes (not shown here) to cause the student’s name to appear multiple times in the text 
output shown in Figure 2 (p. 1692) . 

Meeting the requirements 

These modifications to the World and SimpleTurtle classes met the following requirements estab- 
lished earlier under Analysis 1° . 


e Modify the World class to load a picture named Prob01.jpg as the default background for the 
world in place of the all-white Picture object. 
Modify the World class to display the student’s name near the top of the image. 
Modify the World class to display the student’s name and information about the picture on the 
command-line screen. 


4.4.2.1.1.4.2 Modifications to the SimpleTurtle class 


The SimpleTurtle class was modified to change the order in which colors are assigned to new turtle 
objects and to change the initial heading of the turtle from north to northeast. 

A complete listing of the modified SimpleTurtle class is shown in Listing 7 (p. 1699) near the end of 
the module. 

Change the order of color assignment 

Listing 2 (p. 1693) declares and initializes an array of color data that is used in the original version of 
the SimpleTurtle class to assign colors to the turtles on a cyclical basis as they are instantiated. 


Listing 2 . Original array containing turtle colors. 


/** array of colors to use for the turtles */ 
private static Color[] colorArray = 
{ Color.green, 
Color.cyan, 
new Color(204,0,204), 
Color. gray}; 


Table 4.256 
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Listing 3 (p. 1694) declares and initializes a modified version of the array of color data that is used to 
assign colors to the turtles as they are instantiated. 
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Listing 3 . Modified array of turtle colors. 


/** array of colors to use for the turtles */ 
private static Color[] colorArray = 
{ Color.cyan, 
new Color(204,0,204), 
Color.green, 
Color.gray}; 


Table 4.257 


Determining which color to use 

The code that assigns colors to the turtles as they are instantiated keeps track of the number of turtle 
objects that have been instantiated. 

An index is computed as the 

turtle count modulus the length of the array 

The colors are extracted from the array on a cyclical basis as more and more turtle objects are instantiated. 

Each time the number of turtles is evenly divisible by the length of the array, the index used to access 
colors from the array starts over at zero. 

Meeting the requirements 

This modification to the SimpleTurtle class accomplished the following requirement established earlier 
under Analysis 1!” . 


e Modify the SimpleTurtle class to change the order in which colors are assigned to new turtles as 
they are instantiated. 


Change the initial heading 
Listing 4 (p. 1694) modifies the initialization value for a variable named heading , which is used to 
establish the direction that the turtle is facing. 


Listing 4 . Change the initial heading. 


/** heading angle */ 
//THIS IS A MODIFICATION 
//private double heading = 0;//default faces north 
private double heading = 45;// default faces northeast 


Table 4.258 


The default direction in the original version of the class is due north or zero degrees. The modified default 
direction is northeast or 45 degrees. 

Meeting the requirements 

This modification to the SimpleTurtle class accomplished the following requirement established earlier 
under Analysis 18 . 


"7http://cnx.org/content /m44330/latest /Lecture01.htm#Analysis 
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e Modify the SimpleTurtle class to change the initial heading for new turtle objects to northeast 


instead of north. 
That completes the required modifications that were established under Analysis 11° . 


4.4.2.1.1.5 Run the program 


I encourage you to copy the code from Listing 5 (p. 1696) , Listing 6 (p. 1697) , and Listing 7 (p. 1699) . 
Compile the code and execute it. Experiment with the code, making changes, and observing the results of 
your changes. Make certain that you can explain why your changes behave as they do. 

Click Prob01.jpg !2° to download the required input image file. 


4.4.2.1.1.6 Summary 


You learned how to make simple modification to the World and SimpleTurtle classes that modify how 
a program that uses Ericson’s library behaves. 


4.4.2.1.1.7 What’s next? 


This module dealt with modifications to the World and SimpleTurtle Classes. The next module will 
deal with modifications to the Turtle and SimpleTurtle Classes. 


4.4.2.1.1.8 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Modifying the World and SimpleTurtle Classes 
e File: Java3102.htm 
e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.1.1.9 Complete program listings 


Complete listings of the classes discussed in this module are shown in Listing 5 (p. 1696) , Listing 6 (p. 
1697) , and Listing 7 (p. 1699) below. 
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Listing 5 . Source code for driver class named Prob01. 


public class Prob01{ 


public static void main(String[] args){ 


World mars = new World(200,250) ; 
Turtle joe = new Turtle(mars) ; 
joe.forward(); 

Turtle bill = new Turtle(mars) ; 
bill.moveTo(50,125) ; 

Turtle sue = new Turtle(mars) ; 
sue.moveTo (150,125) ; 

Turtle tom = new Turtle(mars) ; 
tom.moveTo(100, 225) ; 


}//end main method 
}//end class Prob01 


Table 4.259 
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Listing 6 . Source code for the modified World class. 


/ 


{ 


import javax.swing.*; 


import java.util.List; 
import java.util.ArrayList; 
import java.util.Iterator; 
import java.util.Observer; 
import java.awt.*; 


*Note, this version of the World class was modified to 
* cause it to load a jpg file by default instead of 

* displaying a blank picture by default. 12/23/08 

*/ 


Class to represent a 2d world that can hold turtles and 
display them 


Copyright Georgia Institute of Technology 2004 
@author Barb Ericson ericson@cc.gatech.edu 


*/ 


public class World extends JComponent implements ModelDisplay 


//1/11111/1111/1/1/1/1// fields ///////1//111/1111/1/11111 


/** should automatically repaint when model changed */ 
private boolean autoRepaint = true; 


/** the background color for the world */ 
private Color background = Color.WHITE; 


/** the width of the world */ 
private int width = 640; 


/** the height of the world */ 
private int height = 480; 


/** the list of turtles in the world */ 
private List<Turtle> turtleList = new ArrayList<Turtle>(); 


/** the JFrame to show this world in */ 
private JFrame frame = new JFrame("World") ; 


/** background picture */ 
private Picture picture = null; 


//////111/////1/// the constructors /////////////// 


/** 
* Constructor that takes no arguments 
*/ 
public World() 
{ 
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// set up the world and make it visible 
initWorld(true) ; 


en 
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Listing 7 . Source code for the modified SimpleTurtle class. 


import javax.swing.*; 
import java.awt.*; 
import java.awt.font.*; 
import java.awt.geom.*; 
import java.util.Observer; 
import java.util.Random; 


/*xNote: This class was modified to change the order of the 
* colors used for new turtle objects as well as the 

* initial heading for the turtle. 12/23/08 

*/ 


/** 
*Class that represents a Logo-style turtle. The turtle 


* starts off facing north. 
* A turtle can have a name, has a starting x and y position, 
* has a heading, has a width, has a height, has a visible 
* flag, has a body color, can have a shell color, and has a pen. 
* The turtle will not go beyond the model display or picture 
* boundaries. 
* 
* You can display this turtle in either a picture or in 
* a class that implements ModelDisplay. 
* 
* Copyright Georgia Institute of Technology 2004 
* @author Barb Ericson ericson@cc.gatech.edu 
*/ 
public class SimpleTurtle 


{ 
//1/111/11/1111/1/1/1/1/ fields ///////1/11/1/111/1111/1/11111 


/** count of the number of turtles created */ 
private static int numTurtles = 0; 


/** array of colors to use for the turtles */ 

//THIS IS A MODIFICATION 

//THE ORDER OF THE COLORS IN THE ARRAY HAS BEEN MODIFIED 
private static Color[] colorArray = { Color.cyan, new Color(204,0,204) ,Color.green, Color.gray}; 


/** who to notify about changes to this turtle */ 
private ModelDisplay modelDisplay = null; 


/** picture to draw this turtle on */ 
private Picture picture = null; 


/** width of turtle in pixels */ 
private int width = 15; 


/** height of turtle in pixels */ 
private int height = 18 
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/** current location in x (center) */ 
private int xPos = 0; 
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-end- 
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4.4.2.1.2.1 Table of Contents 
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This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 


using Java. 


The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library !?? . 


4.4.2.1.2.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 


following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.1.2.2.1.1 Figures 


e Figure 1 (p. 1704) . Required screen output. 
e Figure 2 (p. 1705) . Required text output. 


4.4.2.1.2.2.1.2 Listings 


Listing 1 
Listing 2 


Listing 4 
Listing 5 
Listing 6 


(p 
(p 
Listing 3 (p. 
(p 
(p 
(p 


. 1705) . Modified Turtle constructor. . 

. 1706) . Modified SimpleTurtle constructor. 
1707) . Modified toString method. 

. 1708) . Source code for the class named Prob02. 

. 1709) . Modified Turtle class. 

. 1711) . Modified SimpleTurtle class. 


121This content is available online at <http://cnx.org/content /m44348/1.2/>. 
122http://cnx.org/content /m44148/latest / 
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4.4.2.1.2.3 Preview 


Program specifications 
Write a program named Prob02 that uses the class definition shown in Listing 4 (p. 1708) and Ericson’s 
media library to produce the graphic output image shown in Figure 1 (p. 1704) . 


-lolx 


Dick Baldwin 


ily name is Joe the turtle. 
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Dick Baldwin 


hit name is Joe the turtle. 
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Dick Baldwin 


hit name is Joe the turtle. 
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Figure 1 . Required screen output. 


-ioj 


Dick Baldwin 


biy name is Joe the turtle. 
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No new classes allowed 

You may not define any new classes to cause your program to behave as required, and you may not 
modify the class definition for the class named Prob02 given in Listing 4 (p. 1708) . 

Files in your folder 

You must copy and modify (as necessary) the media classes named Turtle.java and SimpleTur- 
tle.java from Ericson’s library to cause your program to produce the required output. 

Your folder must contain only the following class files and source-code files: 


Prob02.class 
Prob02.java 
SimpleTurtle.class 
SimpleTurtle.java 
Turtle.class 
Turtle.java 


Output text 
In addition to the output image described above, your program must produce the text output shown in 
Figure 2 (p. 1705) on the command- line screen 
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Figure 2 . Required text output. 


Dick Baldwin 
My name is Joe the turtle. 
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Required modifications 
By comparing the default behavior of the Turtle and SimpleTurtle classes with the requirements 
of this program, it can be determined that the following modifications to the Turtle and SimpleTurtle 
classes are required to meet the specifications. 


1. Modify the Turtle class to cause the student’s name to be displayed on the command line. 

2. Modify the Turtle and SimpleTurtle classes to accept and save a String parameter in addition 

to the World parameter when the Turtle object is constructed. 

3. Modify the SimpleTurtle class to cause the default background of the world to be BLUE. 

4. Modify the SimpleTurtle class to cause the student’s name to be displayed near the top of the 

World image. 

5. Modify the toString method in the SimpleTurtle class to cause it to return the value of the 

String parameter whenever the toString method is called. This causes the drawInfoString 

method to display the string in place of its normal behavior. It also causes the last statement in Listing 
4 (p. 1708) to display the turtle’s name. 


4.4.2.1.2.4 Discussion and sample code 
4.4.2.1.2.4.1 Modifications to the Turtle class 


Ericson’s Turtle class was modified according to the first two items listed above under required modifica- 
tions 173 , 

A complete listing of the modified Turtle class is provided in Listing 5 (p. 1709) near the end of the 
module. 

Modification to the Turtle constructor 

The Turtle class has several overloaded constructors. One of the constructors was modified to accept 
a String parameter in addition to the World parameter and pass the new parameter along to the 
superclass constructor. The code is shown in Listing 1 (p. 1705) . 


Listing 1 . Modified Turtle constructor. 


public Turtle (ModelDisplay modelDisplay, 
String turtleName) { 
// let the parent constructor handle it 
super (modelDisplay,turtleName) ; 
System.out.println("Dick Baldwin"); 
} 
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123http://cnx.org/content /m44348/latest /Lecture02.htm#Required_ modifications 
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A println statement was also added to the modified constructor to cause it to display the student’s 
name on the command line screen when the Turtle object is constructed as shown in Figure 2. 


4.4.2.1.2.4.2 Modifications to the SimpleTurtle class 


A complete listing of the modified SimpleTurtle class is shown in Listing 6 (p. 1711) near the end of the 
module. 

The superclass of the Turtle class 

The SimpleTurtle class is the superclass of the Turtle class. Therefore, the SimpleTurtle class 
must be modified to accept the String parameter passed to the superclass in Listing 1 (p. 1705) . This 
was accomplished by modifying one of the constructors of the SimpleTurtle class as shown in Listing 2 
(p. 1706) . 


Listing 2 . Modified SimpleTurtle constructor. 


String turtleName = null; 


public SimpleTurtle(ModelDisplay display, 
String turtleName) { 


// call constructor that takes x and y 

this((int) (display.getWidth() / 2), 
(int) (display.getHeight() / 2)); 

modelDisplay = display; 

display .addModel (this); 


//THIS IS THE MODIFICATION 

this.turtleName = turtleName; 

Picture picture = ((World) (display) ) .getPicture() ; 
picture. setAl1PixelsToAColor (Color .BLUE) ; 
picture.addMessage("Dick Baldwin",10,20); 
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The modification is shown in the last four statements in Listing 2 (p. 1706) . This modification satisfies 
items 2, 3, and 4 listed earlier under required modifications !*4 . 

Modified toString method 

Listing 3 (p. 1707) shows the modified toString method that satisfies item 5 listed above under 
required modifications 17° . 


Listing 3 . Modified toString method. 


continued on next page 
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public String toString(){ 
//return this.name + " turtle at " + this.xPos + ", " + 
// this.yPos + " heading " + this.heading + "."; 
return "My name is " + turtleName + " the turtle."; 
}//end toString 
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The original code was preserved as comments in Listing 3 (p. 1707) , and the new modified code is shown 
below those comments. 


4.4.2.1.2.5 Run the program 


I encourage you to copy the code from Listing 4 (p. 1708) , Listing 5 (p. 1709) , and Listing 6 (p. 1711) . 
Compile the code and execute it. Experiment with the code, making changes, and observing the results of 
your changes. Make certain that you can explain why your changes behave as they do. 


4.4.2.1.2.6 Summary 


You learned how to: 


1. Modify the Turtle class to cause the student’s name to be displayed on the command line. 

2. Modify the Turtle and SimpleTurtle classes to accept and save a String parameter in addition 

to the World parameter when the Turtle object is constructed. 

3. Modify the SimpleTurtle class to cause the default background of the world to be BLUE. 

4. Modify the SimpleTurtle class to cause the student’s name to be displayed near the top of the 

World image. 

5. Modify the toString method in the SimpleTurtle class to cause it to return the value of the 

String parameter whenever the toString method is called. This causes the drawInfoString 

method to display the string in place of its normal behavior. It also causes the last statement in Listing 
4 (p. 1708) to display the turtle’s name. 


4.4.2.1.2.7 What’s next? 


In the next module, you will learn how to incorporate GUI components into a World object. In particular, 
you will learn how to add a JButton object toa World object and register an action listener on the 
button to control the behavior of the program. 


4.4.2.1.2.8 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 
e Module name: Java OOP: Modifications to the Turtle and SimpleTurtle Classes 


e File: Java3104.htm 
e Revised 12/23/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.1.2.9 Complete program listing 


Complete listings of the programs discussed in this module are shown below. 


Listing 4 . Source code for the class named Prob02. 


import java.awt.Color; 


public class Prob02{ 
public static void main(String[] args){ 
World mars = new World(200, 300); 
Turtle joe = new Turtle(mars,"Joe") ; 
joe.moveTo(20, 280) ; 
joe.setInfoColor (Color .WHITE) ; 
joe.setShowInfo(true) ; 
System. out.println(joe); 
}//end main method 
}//end class Prob02 
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Listing 5 . Modified Turtle class. 


/*12/23/0812/23/08 This class and the class named 
SimpleTurtle were modified to: 


Accept and save a String parameter in addition to the 
World parameter when the Turtle object is constructed. 


Modify the toString method to cause it to return the 
value of the String parameter whenever the toString 
method is called. This causes the drawInfoString method 
to display the string in place of its normal behavior. 


Cause the default background of the world to be BLUE. 


Cause the student’s name to be displayed near the top of 
the World image. 


Cause the student’s name as well as the turtle’s name to 
be displayed on the command line. 


*/ 


/ ** 
Class that represents a turtle which is similar to a Logo turtle. 
This class inherts from SimpleTurtle and is for students 


to add methods to. 


Copyright Georgia Institute of Technology 2004 
@author Barb Ericson ericson@cc.gatech.edu 


* * * AEE: *F ¥ 


*/ 
public class Turtle extends SimpleTurtle 
{ 
///111///1111////{//_constractors /////////1/1/1111/111111 


/** Constructor that takes the x and y and a picture to 
* draw on 
* @param x the starting x position 
* @param y the starting y position 
* @param picture the picture to draw on 
*/ 
public Turtle (int x, int y, Picture picture) 
{ 
// let the parent constructor handle it 
super (x,y,picture) ; 


} 


/** Constructor that takes the x and y and a model 

* display to draw it on 

* @param x the starting x position 

* @param y the starting y position 

* @param modelDisplayer the thing that displays the model 
Sea Turtle Gave for freg at Connexions <http://cnx.org/content/col11441/1.181> 

ModelDisplay modelDisplayer) 

{ 

// let the parent constructor handle it 
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Listing 6 . Modified SimpleTurtle class. 


import javax.swing.*; 
import java.awt.*; 
import java.awt.font.*; 
import java.awt.geom.*; 
import java.util.Observer; 
import java.util.Random; 


/*12/23/08 This class and the class named Turtle were 
modified to: 

Accept and save a String parameter in addition to the 
World parameter when the Turtle object is constructed. 


Modify the toString method to cause it to return the 
value of the String parameter whenever the toString 
method is called. This causes the drawInfoString method 
to display the string in place of its normal behavior. 


Cause the default background of the world to be BLUE. 


Cause the student’s name to be displayed near the top of 
the World image. 


Cause the student’s name as well as the turtle’s name to 
be displayed on the command line. 


*/ 


/ ** 
* Class that represents a Logo-style turtle. The turtle 
* starts off facing north. 


* A turtle can have a name, has a starting x and y position, 
* has a heading, has a width, has a height, has a visible 
* flag, has a body color, can have a shell color, and has a pen. 
* The turtle will not go beyond the model display or picture 
* boundaries. 
* 
* You can display this turtle in either a picture or in 
* a class that implements ModelDisplay. 
* 
* Copyright Georgia Institute of Technology 2004 
* @author Barb Ericson ericson@cc.gatech.edu 
*/ 
public class SimpleTurtle 
{ 


//1111/11/111//1/1/1/ fields ////////1/1/111/1111/1/11111 


/** count of the number of turtles created */ 
private static int numTurtles = 0; 
/** array of colors to use for the turtles */ 
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/** who to notify about changes to this turtle */ 
private ModelDisplay modelDisplay = null; 
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private static Color[] colorArray = { Color.green, Color.cyan, new Color(204,0,204), 


plor.gray}; 


-end- 


4.4.2.1.3 Java OOP: Incorporating GUI Components into a World Object” 


Table 4.269 


4.4.2.1.3.1 Table of Contents 
e Preface (p. 1712) 


Viewing tip (p. 1712) 


x Figures (p. 1712) 
x Listings (p. 1712) 


Preview (p. 1713) 

Discussion and sample code (p. 1721) 
Run the program (p. 1726) 
Summary (p. 1726) 

What’s next? (p. 1727) 
Miscellaneous (p. 1727) 

Complete program listing (p. 1727) 


4.4.2.1.3.2 Preface 


1707 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 


using Java. 


The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 1?" . 


4.4.2.1.3.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 


following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.1.3.2.1.1 Figures 


e Figure 1 (p. 1716) . Initial screen output. 
e Figure 2 (p. 1720) . Screen output after clicking the button. 
e Figure 3 (p. 1721) . Required text output. 


4.4.2.1.3.2.1.2 Listings 


Listing 1 
Listing 2 
Listing 3 


Listing 5 
Listing 6 
Listing 7 


(p 
(p 
(p 
Listing 4 (p. 
(p 
(p 
(p 


. 1726 


. 1721) . The new getFrame method. 


. 1722) . Prob03 class definition. 
. 1722) . Beginning of the Prob03Runner class. 
1723) . Beginning of the run method. 
. 1724) . Register an action listener on the button. 
. 1724) . Set the picture background to blue. 
) 


. Display the student’s name on the picture. 


!26This content is available online at <http://cnx.org/content/m44350/1.2/>. 
!27http://cnx.org/content /m44148/latest / 
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e Listing 8 (p. 1726) . Add a turtle to the world. 
e Listing 9 (p. 1728) . Source code for the program named Prob03. 
e Listing 10 (p. 1730) . The modified World class. 


4.4.2.1.3.3 Preview 


In this module, you will learn how to incorporate GUI components into a World object. In particular, 
you will learn how to add a JButton object toa World object and register an action listener on the 
button to control the behavior of the program. 

Program specifications 

Write a program named Prob03 that uses the Prob03 class definition shown in Listing 2 (p. 1722) 
and Ericson’s media library to produce the graphic output images shown in Figure 1 (p. 1716) and Figure 
2 (p. 1720) . 

The image shown in Figure 1 (p. 1716) is the image that appears on the screen when the program starts 
running. 


B world MB 


Click to make a turtle. 
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| World 


Click to make a turtle. 
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Click to make a turtle. 
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Figure 1 . Initial screen output. 


B world al mj [x] 


Click to make a turtle. 
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Click the button 
The image shown in Figure 2 (p. 1720) is what you should see when you click the button at the bottom 
of the world. 
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| A World Bet 


Dick Baldwin 


Click to make a turtle, 
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Dick Baldwin 


Click to make a turtle. 
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| A World Bet 


Dick Baldwin 


Click to make a turtle, 
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Figure 2 . Screen output after clicking the button. 


Dick Baldwin 


| Click to make a turtle. 
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Modify Ericson’s World class 
You must copy and modify (as necessary) the media class named World to cause your program to 
produce the required output with the required behavior. 
Add a JButton to the World 
This program adds a JButton object to the SOUTH location of the World object as shown in Figure 
1 (p. 1716) and Figure 2 (p. 1720) and registers an action listener on the button to control the behavior of 
the program. 
Program behavior 
The program initially displays an empty white world as shown in Figure 1 (p. 1716) . When the user 
clicks the button, the world’s background color changes to blue, a turtle appears in the center of the World 
, and the student’s name appears near the top of the world. 
Output text 
In addition to the output images described above, your program must produce the text output shown in 
Figure 3 (p. 1721) on the command- line screen 
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Figure 3 . Required text output. 


Dick Baldwin 
Dick Baldwin 
Picture, filename None height 300 width 200 
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Analysis 

A World object is actually a specialized use of a standard Java JFrame object. However, by default, 
the frame is not available to users of the World class. Therefore, in order to satisfy the requirements of 
this program, the World class must be modified to provide access to the frame. 

Add a getFrame method 

This program adds a method named getFrame tothe World class. The getFrame method returns 
a reference tothe JFrame object that is used to display the world. This makes it possible to treat World 
objects in much the same way that other JFrame objects are treated. 

Add a button and pack the frame 

The program uses the JFrame object’s reference to add a JButton object to the SOUTH location 
of the JFrame . After adding the button, the program calls the pack method on the frame to cause the 
size of the frame to be automatically adjusted to accommodate both the Picture object that constitutes 
the background and the JButton object. 


4.4.2.1.3.4 Discussion and sample code 
4.4.2.1.3.4.1 Modification to the World class 


A complete listing of the modified World class is provided in Listing 10 (p. 1730) near the end of the 
module 

Getting access to the frame 

An object of the World class contains a private instance variable named frame that contains a 
reference to the JFrame object. Because it is private, however, it is not available to users of the World 
class. The getter method shown in Listing 1 (p. 1721) was added to the World class to provide access 
tothe JFrame 


Listing 1 . The new getFrame method. 


public JFrame getFrame(){ 
System.out.println("Dick Baldwin"); 
return frame; 
}//end getFrame 
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The new method also displays the student’s name when the method is called, producing part of the text 
output in Figure 3 (p. 1721) . 

No other change to is required 

This is the only change to Ericson’s library that is required to write this program. Everything else in the 
program makes use of existing library classes with no modifications. 
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4.4.2.1.3.4.2 The Prob03Runner class 


Will explain in fragments 

I will explain this program in fragments. A complete listing is shown in Listing 9 (p. 1728) near the end 
of the module. 

The driver class 

The driver class for this program is named Prob03 . The definition of the driver class is shown in its 
entirety in Listing 2 (p. 1722) . 


Listing 2 . Prob03 class definition. 


import java.awt.BorderLayout ; 
import javax.swing. JFrame; 
import javax.swing. JButton; 
import java.awt.event.ActionListener; 
import java.awt.event.ActionEvent; 
import java.awt.Color; 


public class Prob03{ 
public static void main(String[] args){ 
new ProbO3Runner().run(); 
}//end main method 
}//end class Prob03 


Table 4.274 


The driver class simply instantiates a new object of a class named ProbO3Runner and calls a method 
named run on that object. 

Beginning of the Prob03Runner class 

The beginning of the ProbO3Runner class and the constructor for the class is shown in Listing 3 (p. 
1722) . 


Listing 3 . Beginning of the Prob03Runner class. 


class ProbO3Runner{ 
public Prob03Runner () { 
System.out.println("Dick Baldwin"); 
}//end constructor 
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As you can see, the constructor simply displays the student’s name, providing some of the text output 
shown in Figure 3 (p. 1722) . 

Beginning of the run method 

The beginning of the run method is shown in Listing 4 (p. 1723) . This is where things start to get 
interesting. 
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Listing 4 . Beginning of the run method. 


public void run(){ 
//This reference must be final because it is 
// referenced from within an anonymous class 
// definition. 
final World world = new World(200, 300); 


//Get a reference to the JFrame object that is used 
// to display the World. 
JFrame frame = world.getFrame() ; 


//Instantiate a new JButton object and add it to the 
// SOUTH location in the JFrame object. 
JButton button = new JButton( 

"Click to make a turtle."); 
frame. getContentPane() .add(button, BorderLayout . SOUTH) ; 


frame.pack();//VERY IMPORTANT 


Table 4.276 


A new World object 

Listing 4 (p. 1723) begins by instantiating a new object of the World class with a size of 200x300 
pixels. The reference to the object is saved ina final variable named world 

A final reference variable 

As the comment indicates, the variable must be final because it is referenced from within an anonymous 
class definition. I won’t take the time to explain that here. I will simply refer you to my website where I 
have published several tutorial modules on anonymous classes. 

The size of the world... 

The purpose of specifying the size of the world when it is instantiated is to implicitly specify the size of 
the Picture object that forms the background for the world. 

The size of the picture actually matches the specified dimensions. Therefore the actual size of the world 
is a little larger than the specified dimensions due to the borders that surround the picture. 

Get a reference to the frame 

After the World object is instantiated, the new getFrame method is called on the world’s reference 
in order to get and save a reference to the frame. 

A new JButton object 

Then anew JButton object is instantiated. The reference to the JButton object is saved in the 
variable named button 

Add the button to the frame and pack it 

Then the button is added to the SOUTH location in the frame and the pack method is called on the 
frame. Calling the pack method causes the size of the frame, (and hence the size of the world) to be 
adjusted so as to accommodate the picture in the CENTER of the frame and the button at the bottom 
(SOUTH) of the frame. 

The final size of the world 

After the button is added and the world is packed, the overall height of the world is quite a bit larger 
than the original dimensions. I measured it and found it to be about 209x361 pixels including borders. 
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The expansion in height is necessary to make room for the button. However, as you can see in Figure 3 
(p. 1721) , the size of the picture remains at 200x300 pixels. 

Register an action listener on the button 

I elected to use an anonymous class to register an action listener on the button. The purpose of the 
listener is to produce the desired behavior when the button is clicked. 

Note, however, that there are other ways to register an action listener on the button and the student is 
not required to use an anonymous class for that purpose. 

Beginning of the anonymous class 

The definition of the anonymous listener class and the instantiation of the listener object begins in Listing 
5 (p. 1724) . 


Listing 5 . Register an action listener on the button. 


button.addActionListener (new ActionListener () 
{//Begin the class definition 


public void actionPerformed(ActionEvent e){ 
Picture picture = world.getPicture(); 
System.out.println(picture) ; 
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Unfamiliar with anonymous classes? 

If you are unfamiliar with anonymous classes and action listeners, I will simply refer you to my website 
where I have published several tutorial modules on the topic. I have also published modules on the topic in 
this collection. 

In a nutshell... 

In a nutshell, however, the method named actionPerformed , which begins in Listing 5 (p. 1724) , 

will be executed each time the user clicks the button in Figure 1 (p. 1716) . 
Behavior of the actionPerformed method 

The code in Listing 5 (p. 1724) gets and saves a reference to the Picture object that forms the 
background in the world object. Then it passes a copy of that reference to the println method, producing 
the third line of output text shown in Figure 3 (p. 1721) . 

Set the background picture to blue 

Listing 6 (p. 1724) calls the method named setAllPixelsToAColor onthe Picture object passing 

the color BLUE as a parameter. 


Listing 6 . Set the picture background to blue. 


picture.setAl1PixelsToAColor (Color .BLUE) ; 


Table 4.278 


As you might expect, this causes the background of the world to turn from white to blue as shown in 
Figure 2 (p. 1720) . 

Display the student’s name on the picture 

Listing 7 (p. 1726) calls the addMessage method on the picture to add the student’s name near the 
upper-left corner of the world. (See Figure 2 (p. 1720) .) 
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Listing 7 . Display the student’s name on the picture. 


picture.addMessage("Dick Baldwin",10,20); 


Table 4.279 


Finally, Listing 8 (p. 1726) instantiates a new Turtle object in the default color, with the default 
heading (north) , located in the default position, which is the center of the picture that constitutes the 
background image for the world. 


Listing 8 . Add a turtle to the world. 


Turtle turtle = new Turtle(world) ; 
}//end actionPerformed 


}//end class definition 
);//end addActionListener 


3//end run 


}//end class Prob03Runner 
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Multiple clicks 

If you click the button more than once, you will instantiate a new Turtle object and produce a line 
of output text on the command line screen with each click. The turtles will all be in the same location but 
they will cycle through four different color schemes. 

Note that adding the turtle to the world causes the world to be repainted, eliminating the requirement 
to purposely repaint the world. 

End the run method 

Finally, Listing 8 (p. 1726) signals the end of the run method, causing the run method to terminate 
and return control to the main method in Listing 2 (p. 1722). The main method terminates causing 
the program to terminate. 


4.4.2.1.3.5 Run the program 


I encourage you to copy the code from Listing 9 (p. 1728) and Listing 10 (p. 1730) . Compile the code and 
execute it. Experiment with the code, making changes, and observing the results of your changes. Make 
certain that you can explain why your changes behave as they do. 


4.4.2.1.3.6 Summary 


In this module, you learned how to incorporate GUI components into a World object. In particular, you 
learned how to add a JButton object toa World object and register an action listener on the button 
to control the behavior of the program. 
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4.4.2.1.3.7 What’s next? 


In the next module, you will learn how to modify the SimplePicture class to make it possible to control 
the color of the text that is placed on the image ina Picture object. Then you will place a turtle object 
in a world and perform a series of maneuvers causing the turtle to draw a square spiral. 


4.4.2.1.3.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Incorporating GUI Components into a World Object 
e File: Java3106.htm 
e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.1.3.9 Complete program listing 


Complete listings of the programs discussed in this module are provided below. 
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Listing 9 . Source code for the program named Prob03. 


import java.awt.BorderLayout ; 
import javax.swing. JFrame; 
import javax.swing.JButton; 
import java.awt.event.ActionListener; 
import java.awt.event.ActionEvent; 
import java.awt.Color; 


public class Prob03{ 
public static void main(String[] args){ 
new ProbO3Runner().run(); 
}//end main method 
}//end class Prob03 


class ProbO3Runner{ 
public Prob03Runner () { 
System.out.println("Dick Baldwin"); 
}//end constructor 


public void run(){ 
//This reference must be final because it is 
// referenced from within an anonymous class 
// definition. 
final World world = new World(200, 300); 


//Get a reference to the JFrame object that is used 
// to display the World. 
JFrame frame = world.getFrame() ; 


//Instantiate a new JButton object and add it to the 
// SOUTH location in the JFrame object. 
JButton button = new JButton( 

"Click to make a turtle."); 
frame. getContentPane() .add(button, BorderLayout . SOUTH) ; 


frame.pack();//VERY IMPORTANT 


//Use an anonymous class to register an action 
// listener on the button. Note that the student is 
// not required to use an anonymous class. 
button. addActionListener (new ActionListener () 
{//Begin the class definition 
public void actionPerformed(ActionEvent e){ 
Picture picture = world.getPicture(); 
System.out.println(picture) ; 
//Set picture background to blue. 
picture.setAl1PixelsToAColor (Color. BLUE) ; 
7/DisplaviERls SE ksait Corna Sa ERa /mx-pke (content /coll 1441 /1.181> 
picture. addMessage( 
"Dick Baldwin",10,20); 
//Add a turtle to the world. This causes the 


@ 
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Listing 10 . The modified World class. 


import javax.swing.*; 
import java.util.List; 
import java.util.ArrayList; 
import java.util.Iterator; 
import java.util.Observer; 
import java.awt.*; 


/*12/23/08 Modified the World class. Added a method named 
*xgetFrame that returns a reference to the JFrame object 
*in which the turtles are displayed. 


*/ 


/ ** 

* Class to represent a 2d world that can hold turtles and 

* display them 

* 

* Copyright Georgia Institute of Technology 2004 

* @author Barb Ericson ericson@cc.gatech.edu 

*/ 
public class World extends JComponent implements ModelDisplay 
{ 

//1/11111/1111/1/1/1/1//_ields ///////1///1/11/1111/1/11111 


/** should automatically repaint when model changed */ 
private boolean autoRepaint = true; 


/** the background color for the world */ 
private Color background = Color.white; 


/** the width of the world */ 
private int width = 640; 


/** the height of the world */ 
private int height = 480; 


/** the list of turtles in the world */ 
private List<Turtle> turtleList = new ArrayList<Turtle>(); 


/** the JFrame to show this world in */ 
private JFrame frame = new JFrame("World") ; 


/** background picture */ 
private Picture picture = null; 


JITITILITISI IIL /1/ the constructors /////////////// 


/** 
* Constructor that takes no arguments 
*/ 
public World() 
{ Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
// set up the world and make it visible 
initWorld(true) ; 
} 
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-end- 


4.4.2.1.4 Java OOP: Background Color, Text Color, Mouse Clicks, etc. 
4.4.2.1.4.1 Table of Contents 
e Preface (p. 1731) 


Viewing tip (p. 1731) 


x Figures (p. 1731) 
x Listings (p. 1731) 


Preview (p. 1732) 

Discussion and sample code (p. 1739) 
Run the program (p. 1746) 
Summary (p. 1746) 

What’s next? (p. 1746) 
Miscellaneous (p. 1746) 

Complete program listings (p. 1747) 


4.4.2.1.4.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 17° . 


4.4.2.1.4.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.1.4.2.1.1 Figures 


e Figure 1 (p. 1734) . Output image at startup. 
e Figure 2 (p. 1736) . Output image after ten mouse clicks. 
e Figure 3 (p. 1738) . Output image after eleven mouse clicks. 


4.4.2.1.4.2.1.2 Listings 


e Listing 1 (p. 1740) . The new setMessageColor method. 

e Listing 2 (p. 1741) . The modified addMessage method. 

e Listing 3 (p. 1742) . Beginning of the Prob04Runner class. 

e Listing 4 (p. 1743) . Beginning of the anonymous listener class. 
e Listing 5 (p. 1743) . Add a turtle to the world. 

e Listing 6 (p. 1744) . Not the first click. 

e Listing 7 (p. 1745) . Process odd or even clicks. 


128This content is available online at <http://cnx.org/content /m44351/1.2/>. 
129http://cnx.org/content /m44148/latest / 
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Listing 8 (p. 1746) . Cause the program to terminate properly. 
Listing 9 (p. 1748) . Source code for the program named Prob04. 
Listing 10 (p. 1750) . Modified World class. 

Listing 11 (p. 1752) . Modified SimplePicture class. 


4.4.2.1.4.3 Preview 


The program that I will explain in this module requires you to modify both the World class and the 
SimplePicture class from Ericson’s media library. 

Just as you did in an earlier module, you will modify the World class to make it possible to get access 
tothe JFrame object that is encapsulated in a World object. 

You will modify the SimplePicture class to make it possible to control the color of the text that is 
placed on the image ina Picture object. 

Program specifications 

Write a program named Prob04 that uses the class definition for the Prob04 class shown in Listing 
9 (p. 1748) along with Ericson’s media library to produce the graphic output images shown in Figure 1 (p. 
1734) , Figure 2 (p. 1736) , and Figure 3 (p. 1738) . 
Output image at startup 
Figure 1 (p. 1734) shows the output image when you first start the program. 


World E) (5) [x] 


Click Me. 
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Figure 1 . Output image at startup. 
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Click Me. 
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Output image after ten mouse clicks 
This program adds a JButton object to the SOUTH location of the World object as shown in Figure 
1 (p. 1734) . Figure 2 (p. 1736) shows the output image after you click button ten times. 
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Click Me. | 


Figure 2 . Output image after ten mouse clicks. 
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Output image after eleven mouse clicks 
Figure 3 (p. 1738) shows the output image after you click button eleven times. 
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Figure 3 . Output image after eleven mouse clicks. 
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Operational description 

The program initially displays an empty white world with a button at the bottom as shown in Figure 1 
(p. 1734) . 

When the user clicks the button: 


e The world’s background color changes to green. 

e A turtle appears near the bottom right corner of the World. 

e The student’s name appears near the top left corner of the world in red. 
e The turtle has a blue body and a red shell. 


Click the button again 
When you click the button the second time: 


The background color changes to yellow. 

The student’s name changes to blue. 

The turtle changes to a red body with a blue shell. 

The turtle turns 90 degrees left and moves forward 100 pixels plus the value of a click counter. 
The turtle leaves a blue trail. 


Click the button another time 
On the next click: 


e The colors revert to the color scheme with the yellow background. 
e The turtle turns 90 degrees left and moves forward 100 pixels plus the value of the click counter leaving 
a red trail. 


Click the button repeatedly 

This cycle repeats on each click with the turtle’s trail drawing a square spiral of increasing size with red 
lines on the top and bottom of the spiral and blue lines on the right and left of the spiral. 

Output text 

In addition to the output images described above, your program must produce some output text on the 
command- line screen 


4.4.2.1.4.4 Discussion and sample code 


The driver class 

The driver class named Prob04 is shown at the beginning of Listing 9 (p. 1748) near the end of the 
module. The main method simply instantiates a new object of the class named Prob04Runner_ , 
which I will explain later. The event driven behavior of the program is controlled by a listener object that 
is registered on the button in the constructor of the Prob04Runner class. 

Modification of the World class 

This program adds a method named getFrame tothe World class. The method returns a reference 
tothe JFrame object that is used to display the world. 

The program uses that reference to add a JButton object to the SOUTH location of the World . I 
explained a modification very similar to this in an earlier module, so I won’t repeat that explanation here. 

A complete listing of the modified World class is provided in Listing 10 (p. 1750) near the end of the 
module. 

Modification of the SimplePicture class 

This program modifies the addMessage method of the SimplePicture class to cause it to use a color 
variable named messageColor to set the color of the text. The modification also declares and initializes 
the private instance variable named messageColor . 

The SimplePicture class was also modified to include a setMessageColor method that can be 
used to set the color value stored in the variable named messageColor . 
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The new setMessageColor method 
The new method named setMessageColor that was added to the SimplePicture class is shown in 
Listing 1 (p. 1740) . 


Listing 1 . The new setMessageColor method. 


public void setMessageColor(Color color){ 
System.out.println("Dick Baldwin"); 
messageColor = color; 
}//end setMessageColor 
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Save the color value 

The setMessageColor method saves the incoming color parameter in a private instance variable 
named messageColor that was added to the class. 

The default value of the variable is Color.WHITE , thereby preserving the default behavior of the 
addMessage method. 

You can view the new variable named messageColor in Listing 11 (p. 1752) near the end of the 
module. 

Display the student’s name 

The new setMessageColor method also causes my name to be displayed each time the method is 
called. This is of no operational value, but is useful during the testing stage of the modified class. This is 
part of the code that produces text output on the command line screen. 

The modified addMessage method 

The modified version of the addMessage method is shown in Listing 2 (p. 1741) . 
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Listing 2 . The modified addMessage method. 


public void addMessage( 
String message, int xPos, int yPos){ 
// get a graphics context to use to draw on the 
// buffered image 
Graphics2D graphics2d = bufferedImage.createGraphics() ; 


// set the color to white 
//graphics2d.setPaint (Color.white) ; 


//modified by Baldwin on 12/23/08 
graphics2d.setPaint (messageColor) ; 


// set the font to Helvetica bold style and size 16 
graphics2d.setFont (new Font ("Helvetica",Font.BOLD,16)); 


// draw the message 
graphics2d.drawString (message, xPos, yPos) ; 


}//end addMessage 
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The original statement shown in Listing 2 (p. 1741) was disabled and replaced by the statement shown 
following the modification comment. This causes the text to be displayed on the image using the color stored 
in the new private instance variable named messageColor 

The Prob04Runner class 

I will explain this program in fragments. A complete listing is shown in Listing 9 (p. 1748) near the end 
of the module. 

The driver class 

The driver class for this program is named Prob04 . As I mentioned earlier, you can view the class 
definition in its entirety near the beginning of Listing 9 (p. 1748) . 

Beginning of the Prob04Runner class 
The Prob04Runner class begins in Listing 3 (p. 1742) . 
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Listing 3 . Beginning of the Prob04Runner class. 


class Prob04Runner{ 
Turtle turtle = null; 
Picture picture = null; 
int counter = 0; 
World world = new World(200,200) ; 
JButton button = new JButton("Click Me."); 


public Prob04Runner () { 
System.out.println("Dick Baldwin"); 
System. out.println(world.getPicture()); 


//Get a reference to the JFrame object that is used 
// to display the World. 
JFrame frame = world.getFrame() ; 


//Add the JButton object to the 
// SOUTH location in the JFrame object. 
frame. getContentPane() .add(button, BorderLayout.SOUTH) ; 


frame. pack(); 
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Very familiar code 

You should already be familiar with all of the code in Listing 3 (p. 1742) . When the code in Listing 3 
(p. 1742) has finished executing, the image shown in Figure 1 (p. 1734) should have appeared on the screen. 

Waiting for an event 

At this point, the program is essentially idle waiting for the user to either click the button at the bottom 
of Figure 1 (p. 1734) , or click the red X-button in the upper-right corner of Figure 1 (p. 1734) . (More on 
the red X-button later.) 

Beginning of the anonymous listener class 

This program uses an anonymous inner class to register an action listener on the button. The anonymous 
class begins in Listing 4 (p. 1743) . 
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Listing 4 . Beginning of the anonymous listener class. 


button.addActionListener (new ActionListener () 
{//Begin the anonymous class definition 


public void actionPerformed(ActionEvent e){ 
picture = world.getPicture(); 


//Set picture background to green. 
picture.setAl1PixelsToAColor (Color.GREEN) ; 
picture.setMessageColor(Color.RED) ; 


//Display the student’s name on the picture. 
picture.addMessage("Dick Baldwin",10,20); 
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The event handler method named actionPerformed 

Once the listener object is instantiated from the anonymous class and registered on the button, the 
method named actionPerformed , which begins in Listing 4 (p. 1743) , will be executed each time the 
button is clicked. 

Get a reference to the background picture 

The actionPerformed method begins by getting and saving a reference to the Picture object that 
provides the background image for the World object. By default, all of the pixels in this image are white, 
as shown in Figure 1 (p. 1734) . 

Set the background color to green 

Then the method calls Ericson’s standard method named setAllPixelsToAColor method to set the 
color of all of the background pixels to green. 

Display student’s name in red 

Following that, the method calls the new setMessageColor method to set the text color to red, and 
calls the modified addMessage method to display my name in red near the upper-left corner of the image. 
Figure 3 (p. 1738) shows an example of a green background and red text. 

Add a turtle to the world 

Listing 5 (p. 1743) tests to determine if the variable named turtle that was declared in Listing 3 (p. 
1742) still contains null. If so, that means that this is the first time that the button has been clicked and 
the Turtle object has not yet been added to the world. 


Listing 5 . Add a turtle to the world. 


if (turtle == null){ 
turtle = new Turtle(150,150,world); 
turtle.setHeading (90) ; 
turtle.setShellColor(Color.RED) ; 
turtle.setBodyColor(Color.BLUE) ; 
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Add a Turtle object and set its colors 

Listing 5 (p. 1743) instantiates a new Turtle object and adds it to the world near the lower-right 
corner facing due east (90 degrees) . 

The shell color is set to red and the body color (feet and head) is set to blue. An example of the turtle 
with this color scheme is shown in Figure 3 (p. 1738) . 

Not the first click 

If the conditional clause in Listing 5 (p. 1743) returns false, that means that this is not the first time the 
button has been clicked and the else clause, which begins in Listing 6 (p. 1744) will be executed. 


Listing 6 . Not the first click. 


}else{ 
turtle.turnLeft(); 
turtle.forward(100+counter) ; 
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Rotate and move 

The else clause begins by causing the turtle to rotate to the left by a default angle of 90 degrees. Then 
the turtle moves forward by a distance equal to 100 plus the value of a counter that is incremented by one 
each time the button is clicked. 

For example, on the second click of the button, the turtle moves toward the north drawing a blue line 
along the way. The default width of the line is one pixel and the default color of the line is the same as the 
shell color. 

Process odd or even clicks 

The behavior of the actionPerformed method at this point depends on whether the incremented 

value of the counter variable is even or odd. The code to accomplish this is shown in Listing 7 (p. 1745) . 
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Listing 7 . Process odd or even clicks. 


if (counter++ %2 != 0){ 
picture.setAllPixelsToAColor (Color.GREEN) ; 
picture.setMessageColor(Color.RED) ; 


picture.addMessage( 

"Dick Baldwin",10,20); 
turtle.setShellColor(Color.RED) ; 
turtle.setBodyColor (Color .BLUE) ; 

}else{ 
picture.setA11PixelsToAColor (Color .YELLOW); 
picture.setMessageColor (Color .BLUE); 


picture.addMessage( 

"Dick Baldwin",10,20); 
turtle.setShellColor (Color .BLUE) ; 
turtle.setBodyColor(Color.RED) ; 

}//end else 


picture. addMessage( 
"Dick Baldwin",10,20); 
}//end else 
}//end actionPerformed 
}//end class definition 


);//end addActionListener 


}//end constructor 


}//end class Prob04Runner 
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If the counter value is odd... 

If the value of the counter ( before it is incremented — note the post-increment operator) is odd, the 
color scheme for the background, the message, and the turtle is set to that shown in Figure 3 (p. 1738) with 
the green background. 

If the counter value is even... 

Otherwise, if the counter value is even, the color scheme is set to that shown in Figure 2 (p. 1736) with 
the yellow background. 

The end of several sections of code 

Listing 7 (p. 1745) also completes the else clause that began in Listing 6 (p. 1744) . 

In addition, Listing 7 (p. 1745) signals the end of the actionPerformed method, the end of the 
anonymous class definition, the end of the constructor, and the end of the class named Prob04Runner 

Waiting for an event 

As mentioned earlier, once the constructor finishes execution, the program becomes idle waiting for the 
user to either click the button at the bottom of Figure 1 (p. 1734) , or click the red X-button in the 
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upper-right corner of Figure 1 (p. 1734) . 
Does not terminate as expected 

Normally a user would expect the program to terminate and return control to the operating system when 
the user clicks the red X-button in the upper-right corner of the last remaining window. However, this 
program does not do that. Instead, clicking this button simply hides the window and control is not returned 
to the operating system. 

A programming oversight 

This was a programming oversight on my part, which can be corrected by adding the second statement in 
Listing 8 (p. 1746) to the definition of the Prob04Runner class immediately following the first statement 
shown in Listing 8 (p. 1746) . 


Listing 8 . Cause the program to terminate properly. 


JFrame frame = world.getFrame() ; 
frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
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To understand why this is necessary to cause the program to terminate, I recommend that you visit the 
standard Sun javadocs and examine the description of the method named setDefaultCloseOperation in 
the JFrame class. 
4.4.2.1.4.5 Run the program 


I encourage you to copy the code from Listing 9 (p. 1748) , Listing 10 (p. 1750) , and Listing 11 (p. 1752) . 
Compile the code and execute it. Experiment with the code, making changes, and observing the results of 
your changes. Make certain that you can explain why your changes behave as they do. 


4.4.2.1.4.6 Summary 


Just as you did in an earlier module, you modified the World class to make it possible to get access to the 
JFrame object that is encapsulated in a World object. 

You learned how to modify the SimplePicture class to make it possible to control the color of the 
text that is placed on the image ina Picture object. 

Then you placed a turtle object in a world and performed a series of maneuvers causing the turtle to 
draw a square spiral. 
4.4.2.1.4.7 What’s next? 
In the next module, you will learn how to create and service a graphical user interface containing panels, 
labels, text fields, and buttons. 
4.4.2.1.4.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Background Color, Text Color, Mouse Clicks, etc. 
e File: Java3108.htm 
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e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.1.4.9 Complete program listings 


Complete listings of the programs discussed in this module are shown below. 
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Listing 9 . Source code for the program named Prob04. 


/*File Prob04 Copyright 2008 R.G.Baldwin 
FE EEEE EE EEE EEEE EEEE E EEEE EEEE EE I I EE 21 2k EE 21 21 E 4 4 21 E 2 a 4 2k 2 2 E / 
import java.awt.BorderLayout ; 
import javax.swing. JFrame; 
import javax.swing. JButton; 
import java.awt.event.ActionListener; 
import java.awt.event.ActionEvent; 
import java.awt.Color; 
import java.awt.Toolkit; 


public class Prob04{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new ProbO04Runner () ; 
}//end main method 
}//end class Prob04 


class Prob04Runner{ 
Turtle turtle = null; 
Picture picture = null; 
int counter = 0; 
World world = new World(200,200) ; 
JButton button = new JButton("Click Me."); 


public Prob04Runner () { 
System.out.println("Dick Baldwin"); 
System. out.println(world.getPicture()); 


//Get a reference to the JFrame object that is used 
// to display the World. 
JFrame frame = world.getFrame() ; 


//Add the JButton object to the 
// SOUTH location in the JFrame object. 
frame. getContentPane() .add (button, BorderLayout.SOUTH) ; 


frame. pack() ; 


//Use an anonymous class to register an action 
// listener on the button. Note that the student is 
// not required to use an anonymous class. 
button.addActionListener (new ActionListener () 
{//Begin the class definition 
public void actionPerformed(ActionEvent e){ 
picture = world.getPicture(); 


//Set picture background to green. 
picture.setAl1PixelsToAColor (Color.GREEN) ; 
picture, setMessageColor (Color .REẸD) ; 

Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
//Display the student’s name on the picture. 
picture. addMessage( 
"Dick Baldwin",10,20); 
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Listing 10 . Modified World class. 


import javax.swing.*; 
import java.util.List; 
import java.util.ArrayList; 
import java.util.Iterator; 
import java.util.Observer; 
import java.awt.*; 


/*12/23/08 Modified the World class. Added a method named 
*xgetFrame that returns a reference to the JFrame object 
*in which the turtles are displayed. 


*/ 


/ ** 

* Class to represent a 2d world that can hold turtles and 

* display them 

* 

* Copyright Georgia Institute of Technology 2004 

* @author Barb Ericson ericson@cc.gatech.edu 

*/ 
public class World extends JComponent implements ModelDisplay 
{ 

//1/11111/1111/1/1/1/1//_ields ///////1///1/11/1111/1/11111 


/** should automatically repaint when model changed */ 
private boolean autoRepaint = true; 


/** the background color for the world */ 
private Color background = Color.white; 


/** the width of the world */ 
private int width = 640; 


/** the height of the world */ 
private int height = 480; 


/** the list of turtles in the world */ 
private List<Turtle> turtleList = new ArrayList<Turtle>(); 


/** the JFrame to show this world in */ 
private JFrame frame = new JFrame("World") ; 


/** background picture */ 
private Picture picture = null; 


JITITILITISI IIL /1/ the constructors /////////////// 


/** 
* Constructor that takes no arguments 
*/ 
public World() 
{ Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
// set up the world and make it visible 
initWorld(true) ; 
} 
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Listing 11 . Modified SimplePicture class. 


import javax.imageio.ImagelI0; 
import java.awt.image.BufferedImage; 
import javax.swing.ImagelIcon; 
import java.awt.*; 
import java.io.*; 
import java.awt.geom.*; 


/* 

12/23/08 Modified the addMessage method to cause it to 
use a color variable to set the color of the message. 
Also provided a setMessageColor method to set the color 
and a variable named messageColor to contain the color. 


/* 


/** 
* A class that represents a simple picture. A simple picture may have 
* an associated file name and a title. A simple picture has pixels, 
* width, and height. A simple picture uses a BufferedImage to 
* hold the pixels. You can show a simple picture in a 
* PictureFrame (a JFrame). 
* 
* Copyright Georgia Institute of Technology 2004 
* @author Barb Ericson ericson@cc.gatech.edu 
*/ 


public class SimplePicture implements DigitalPicture 


{ 


///1111111111/1//1/11/1/ Fields ///////////1/111/111111111 
/*x* 

* the color of the message 

*/ 


private Color messageColor = Color.WHITE; 


/*x* 


* the file name associated with the simple picture 
*/ 


private String fileName; 


/*x 
* the title of the simple picture 
*/ 

private String title; 


/*x* 


* buffered image to hold pixels for the simple picture 
*/ 


private BufferedImage bufferedImage; 
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* frame used to display the simple picture 
*/ 


private PictureFrame pictureFrame; 
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-end- 
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This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 


using Java. 


The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 1°! . 


4.4.2.1.5.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 


following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.1.5.2.1.1 Figures 


e Figure 1 (p. 1758) . Program output at startup. 
e Figure 2 (p. 1762) . Program output after one click. 
e Figure 3 (p. 1766) . Program output after several clicks. 


4.4.2.1.5.2.1.2 Listings 


Listing 1 
Listing 2 
Listing 3 
Listing 4 


Listing 6 
Listing 7 
Listing 8 
Listing 9 


(p 
(p 
(p 
(p 
Listing 5 (p. 
(p 
(p 
(p 
(p 


. 1767) . Beginning of the class named Prob05Runner. 


. 1767) . Instantiate GUI components. 
. 1768) . Beginning of the constructor. 
. 1769) . Add the six GUI components to the panel. 
1769) . Get the frame and add the panel to the frame. 
. 1770) . Set the background to blue and add a turtle. 
. 1771) . Define, instantiate, and register a listener on the Move button. 
. 1771) . Action listener to terminate the program. 
. 1774) . Source code for Prob05. 


130This content is available online at <http://cnx.org/content /m44352/1.3/>. 
131 http://cnx.org/content /m44148/latest / 
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4.4.2.1.5.3 Preview 


In this module, you will learn how to create and service a graphical user interface containing panels, labels, 
text fields, and buttons. 

Just as you did in earlier modules, you will modify the World class to make it possible to get access 
to the JFrame object that is encapsulated in a World object. However, because I explained those 
modifications to the World class in earlier modules, I won’t repeat the explanation here. You can find a 
modified version of the World class in Java OOP: Background Color, Text Color, Mouse Clicks, etc. 1°? 

Program specifications 

Write a program named Prob05 that uses the class definition named Prob05 shown in Listing 9 (p. 
1774) along with Ericson’s media library to produce the graphic output images shown in Figure 1 (p. 1758) 
, Figure 2 (p. 1762) , and Figure 3 (p. 1766) . 

Program output at startup 
Figure 1 (p. 1758) shows the image that appears on the screen when the program first starts running. 


Dick Baldwin 


132http://cnx.org/content /m44351/latest /#Listing 10 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1751 


Dick Baldwin 
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Dick Baldwin 
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Figure 1 . Program output at startup. 


Dick Baldwin 


Table 4.297 
Program output after one click 


Figure 2 (p. 1762) shows the output image after the user enters the values shown into the two text fields 
and clicks the Move button once. 
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Dick Baldwin 
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Dick Baldwin 
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Dick Baldwin 
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Figure 2 . Program output after one click. 


=lo}xi| 


Dick Baldwin 
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Program output after several clicks 


Figure 3 (p. 1766) shows the output image after the user enters several different sets of values into the 
text fields and clicks the Move button several times. 
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Dick Baldwin 
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Dick Baldwin 
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Dick Baldwin 
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Figure 3 . Program output after several clicks. 


Dick Baldwin 
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Labels, text fields, and buttons 

As shown in Figure 1 (p. 1758) , this program adds two buttons, two labels, and two text fields to form 
a GUI at the bottom of the World object. Although it isn’t obvious, those six components are contained 
ina Panel object. 

Each time you enter numeric values into the angle and distance fields and then click the Move button, 
the turtle will turn by that angle in degrees and move by that distance in pixels. 

Program termination 

The program terminates and returns control to the operating system when the user clicks the Quit 
button. 

Use AWT components instead of Swing components 

The GUI at the bottom of the World object is comprised of AWT components instead of Swing 
components. 

Required text output 
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In addition to the output image described above, your program must produce some rather inconsequential 
text output on the command- line screen. 


4.4.2.1.5.4 Discussion and sample code 


The class named Prob05 

You can view the driver class named Prob05 at the beginning of the source code in Listing 9 (p. 1774) 
. You are already familiar with the code in the main method of that class from earlier modules so I won’t 
waste time explaining it. 

Briefly, the main method instantiates a new object of the class named Prob0O5Runner . Once that 
object is instantiated, the program goes idle waiting for an event to happen. Events happen when the user 
enters text into the text fields or presses one of the buttons shown in Figure 1 (p. 1758) . 

The class named Prob05Runner 

I will explain this program in fragments. A complete listing of the program is provided in Listing 9 (p. 
1774) near the end of the module 

The class named Prob05Runner begins in Listing 1 (p. 1767) . 


Listing 1 . Beginning of the class named Prob05Runner. 


class ProbO5Runner{ 
Turtle turtle = null; 
Picture picture = null; 
World world = new World(200, 300) ; 
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There’s nothing new in Listing 1 (p. 1767) . You have seen code like this in several earlier modules. 

Instantiate GUI components 

Listing 2 (p. 1767) instantiates the GUI components that are used to construct the GUI at the bottom 
of Figure 1 (p. 1758) . 


Listing 2 . Instantiate GUI components. 


Panel mainPanel = new Panel(); 
Label angleLabel = new Label("Enter Angle"); 
TextField angleField = new TextField("000") ; 
Label distanceLabel = new Label("Enter Distance") ; 
TextField distanceField = new TextField("000") ; 
Button moveButton = new Button("Move") ; 
Button quitButton = new Button("Quit") ; 


int angle = 0; 
int distance = 0; 


Table 4.301 
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References to the GUI components are saved in instance variables with descriptive names. 

GUI component initialization 

Except for the Panel object, each GUI component is initialized with information that is appropriate 
to the type of component. Compare the initialization values in Listing 2 (p. 1767) with the image in Figure 
1 (p. 1758) for a better understanding of what I mean by this. 

Brief description of the GUI components 

You are encouraged to visit the Sun Java documentation and read about the following AWT components: 


e Panel : A panel provides space in which an application can attach any other components, including 
other panels. 

e Label : A Label object is a component for placing text in a container. A label displays a single line 
of read-only text. The text can be changed by the application, but a user cannot edit it directly. 

e TextField : A text component that allows for the editing of a single line of text. 

e Button : This class creates a labeled button. The application can cause some action to happen 
when the button is pushed. 


Figure 1 (p. 1758) contains a Panel object at the bottom. The panel contains two Label objects (shown 
as orange) ,two TextField objects (white) , and two Button objects (gray) . Those seven objects 
are instantiated in Listing 2 (p. 1767) . 

The angle and distance variables 

Listing 2 (p. 1767) also declares and initializes two instance variables named angle and distance 

(Note that these two variables would be automatically initialized to zero if I didn’t initialize them, but I 

prefer to initialize them explicitly in order to make the code more self-documenting.) 

Beginning of the constructor 

The constructor for the class named Prob05Runner begins in Listing 3 (p. 1768) . 


Listing 3 . Beginning of the constructor. 


public Prob05Runner (){ 
System.out.println("Dick Baldwin"); 


mainPanel.setBackground(Color. ORANGE) ; 


mainPanel.setLayout (new GridLayout (0,2)); 
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The constructor begins by displaying my name on the command line screen. This is inconsequential 
insofar as the overall operation of the program is concerned. 

Set the panel background color to orange 

Then Listing 3 (p. 1768) sets the background color of the panel to orange. This is what causes the two 
labels in Figure 1 (p. 1758) to appear to be orange. They are actually transparent except for the text. The 
orange color shows through causing the labels to appear to be orange. 

Set the layout to GridLayout 

Setting the layout manager controls how the components that are placed in the panel will be arranged. 
A GridLayout causes all components to be the same size arranged in rows and columns. 

Overloaded constructors 

There are several overloaded versions of the GridLayout constructor. For the constructor used in 
Listing 3 (p. 1768) , the parameters specify the number of rows and the number of columns in that order. 
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Specifying the number of rows as 0 and the number of columns as 2 means that the layout manager will 
accept any number of rows but only two columns. 

The order of component placement 

The intersections of the rows and columns create cells . Components are placed in the cells in left to 
right, top to bottom order as they are added to the panel. 

Add the six GUI components to the panel 

Listing 4 (p. 1769) adds the six GUI components to the panel in the left to right, top to bottom order 
described above. 


Listing 4 . Add the six GUI components to the panel. 


mainPanel.add(angleLabe1) ; 
mainPanel.add(angleField) ; 
mainPanel.add(distanceLabel) ; 
mainPanel.add(distanceField) ; 
mainPanel.add(moveButton) ; 
mainPanel.add(quitButton) ; 
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At this point, the panel has been populated with GUI components, but the panel itself has not been 
added to the JFrame object that forms the World object. That is accomplished in Listing 5 (p. 1769) . 

Get the frame and add the panel to the frame 

Listing 5 (p. 1769) gets a reference to the World object’s frame and adds the panel to the SOUTH 
location in that frame. 


Listing 5 . Get the frame and add the panel to the frame. 


JFrame frame = world.getFrame() ; 
frame. getContentPane() .add( 
mainPanel , BorderLayout. SOUTH) ; 


frame. pack(); 
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You can surmise from the word SOUTH that the panel is added to the bottom of the frame. To learn 
more about this, visit the BorderLayout class in Sun’s Java documentation. 

Pack the frame 

As you learned in an earlier module, it is very important that you pack the frame at this point. Packing 
the frame causes the frame to adjust its dimensions in order to accommodate all of the components that 
have been added to it. In this case, the frame contains a Picture object (placed there when the World 
was constructed) anda Panel object placed there in Listing 5 (p. 1770) . 

What about the size of the panel? 

Exactly how the panel decides what size it needs to be to accommodate the six GUI components is a 
fairly complicated topic, so I won’t go into it here. However, if you do much work developing GUIs, you 
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definitely need to understand the process. I have explained the automatic sizing process in several tutorials 
on my website. 
Set the background to blue and add a turtle 
Listing 6 (p. 1770) sets the background color of the world to blue and adds a turtle to the world. 


Listing 6 . Set the background to blue and add a turtle. 


//Initialize the picture. 
picture = world.getPicture(); 
//Set picture background to BLUE 
picture. setAl1PixelsToAColor (Color .BLUE) ; 
//Display the student’s name on the picture. 
picture.addMessage("Dick Baldwin",10,20); 
//Add a turtle to the world. This causes the 
// world to be repainted. 
turtle = new Turtle(world); 
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There is nothing new in Listing 6 (p. 1770) . I have explained code very similar to this code in earlier 
modules. 

Could stop at this point 

If we were to stop programming at this point, the program would be executable, and would produce the 
output shown in Figure 1 (p. 1758) when it is run. However it would be completely passive. By that, I 
mean that entering values into the text fields and clicking the buttons at the bottom of Figure 1 (p. 1758) 
would have no effect. However, the buttons would appear to be active from a visual viewpoint because the 
animation behavior is built into objects of the Button class. 

Register listener objects 

In order to cause the buttons to impact the behavior of the program, we must instantiate and register 
listener object on the buttons. I will do that using anonymous classes. 

Define, instantiate, and register a listener on the Move button 

The code in Listing 7 (p. 1771) : 


e Defines an anonymous ActionListener class. 


e Instantiates an anonymous object of that class. 
e Registers that object on the Move button 
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Listing 7 . Define, instantiate, and register a listener on the Move button. 


moveButton.addActionListener ( 
new ActionListener () { 


public void actionPerformed(ActionEvent e){ 
angle = Integer.parseInt (angleField.getText()); 
distance = Integer.parseInt ( 
distanceField.getText()); 
turtle.turn(angle) ; 
turtle.forward (distance) ; 
}//end action performed 


}//end newActionListener 
);//end addActionListener 
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The actionPerformed method 

As you learned in an earlier module, the code in the actionPerformed method is executed each time 
the user presses the Move button. 

The actionPerformed method in Listing 7 (p. 1771) begins by getting the text from each of the text 
fields, converting the text to type int , and saving the int values in the variables named angle and 
distance 

Then Listing 7 (p. 1771) calls the turn and forward methods of the Turtle class to cause the 
turtle to turn by the specified angle and then move forward by the specified distance. 

Action listener to terminate the program 

Listing 8 (p. 1771) registers an action listener on the Quit button, which will cause the program to 

terminate when the user clicks the button. 


Listing 8 . Action listener to terminate the program. 


quitButton.addActionListener ( 
new ActionListener (){ 
public void actionPerformed(ActionEvent e){ 
System.exit (0); 
}//end action performed 
}//end newActionListener 


);//end addActionListener 


}//end constructor 


}//end class Prob05Runner 
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As you can see in Listing 8 (p. 1771) , this code causes the exit method of the System class to 
be called when the user clicks the Quit button. According to the Sun documentation, a call to the exit 
method "Terminates the currently running Java Virtual Machine." 

The end of the constructor and the end of the class 

Listing 8 (p. 1771) also shows the end of the constructor for the Prob05Runner class and the end of 

the class. 


4.4.2.1.5.5 Run the program 


I encourage you to copy the code from Listing 9 (p. 1774) . Compile the code and execute it. Experiment 
with the code, making changes and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


4.4.2.1.5.6 Summary 

In this module, you learned how to create and service a graphical user interface containing panels, labels, 
text fields, and buttons. 

4.4.2.1.5.7 What’s next? 


In the next module, you will learn about: 


Alpha transparency 

A buffered image of type TYPE_INT_ARGB 

The ability to use the getBasicPixel and setBasicPixel methods, 
The use of the bitwise AND and OR operators, 

The use of the drawImage method of the Graphics class. 


4.4.2.1.5.8 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Panels, Labels, Text Fields, and Buttons 
e File: Java3110.htm 
e Revised 12/23/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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4.4.2.1.5.9 Complete program listing 


A complete listing of the program discussed in this lesson is shown in Listing 9 (p. 1774) below. 
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Listing 9 . Source code for Prob05. 


/*File Prob05 Copyright 2008 R.G.Baldwin 
*Revised 12/31/08 
FE EEEE EEEE EEE EEEE EEE EE EE EEEE Kk EE 21 21 E E 21 21 E 4 2k E EE EE 2 2 E / 
import java.awt.BorderLayout ; 
import java.awt.GridLayout ; 
import java.awt.Panel; 
import java.awt.TextField; 
import java.awt.Label; 
import java.awt.Button; 


import java.awt.event.ActionListener; 
import java.awt.event.ActionEvent; 
import java.awt.Color; 


import javax.swing. JFrame; 


public class Prob05{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new ProbO5Runner () ; 
}//end main method 
}//end class Prob05 
//End program specifications. 


Fkk k ak ak ak akak 3k ak 3k k 2k ak 2k k ak ək 2k 222k ək ək 2k 3k ək 3k 2k ək ək 3k 2k ək ək 3k ək 2k 2k ək 2k əkək 2k 2k 2k ak 2k ÞK ak ak ae / 


class ProbO5Runner{ 
Turtle turtle = null; 
Picture picture = null; 
World world = new World(200,300) ; 
Panel mainPanel = new Panel(); 
Label angleLabel = new Label("Enter Angle"); 
TextField angleField = new TextField("000"); 
Label distanceLabel = new Label("Enter Distance") ; 
TextField distanceField = new TextField("000") ; 
Button moveButton = new Button("Move") ; 
Button quitButton = new Button("Quit") ; 
int angle = 0; 
int distance = 0; 


public Prob05Runner () { 
System.out.println("Dick Baldwin"); 


//Construct the GUI. 

mainPanel.setBackground(Color. ORANGE) ; 

mainPanel.setLayout (new GridLayout (0,2)); 
mainPanel.add(angleLabel1) ; 

mainPanel.add(angleField) ; 

mainPanel.add(distanceLabel) ; : 

nainPanel. aad vailable for ree al Connexions <http://cnx.org/content /col11441/1.181> 
mainPanel.add(moveButton) ; 

mainPanel.add(quitButton) ; 
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Table 4.308 


-end- 


4.4.2.2 Part 2 


3 


4.4.2.2.1 Java OOP: Using Alpha Transparency with Ericson’s Media Library” 
4.4,2.2.1.1 Table of Contents 
e Preface (p. 1775) 


Viewing tip (p. 1775) 


x Figures (p. 1775) 
x Listings (p. 1775) 


Preview (p. 1776) 

General background information (p. 1785) 
Discussion and sample code (p. 1787) 
Run the program (p. 1792) 

Summary (p. 1792) 

What’s next? (p. 1792) 

Miscellaneous (p. 1792) 

Complete program listing (p. 1793) 


4.4.2.2.1.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 134 . 


4.4.2.2.1.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.2.1.2.1.1 Figures 


e Figure 1 (p. 1778) . Image from file named Prob06a. 
e Figure 2 (p. 1782) . Image from file named Prob06b. 
e Figure 3 (p. 1784) . Processed output image. 

e Figure 4 (p. 1785) . Required text output. 


4.4.2.2.1.2.1.2 Listings 


e Listing 1 (p. 1786) . Modification of the SimplePicture class. 

e Listing 2 (p. 1787) . Beginning of the class named Prob06Runner. 
e Listing 3 (p. 1788) . The run method. 

e Listing 4 (p. 1789) . Beginning of the cropAndFlip method. 


133This content is available online at <http://cnx.org/content /m44911/1.2/>. 
134http://cnx.org/content /m44148/latest: / 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1771 


e Listing 5 (p. 1790) . Make the pixels partially transparent. 
e Listing 6 (p. 1791) . The copyPictureWithCrop method. 
e Listing 7 (p. 1794) . Complete program listing. 


4.4.2.2.1.3 Preview 


The primary objective of this module is to incorporate alpha transparency into the use of Ericson’s media 
library. 

Two approaches 

There are at least two ways to incorporate alpha transparency into Ericson’s media library, The easiest 
way, which is not necessarily the best way, is to make a relatively simple modification to a constructor in 
Ericson’s SimplePicture class. That is the approach used in this module. 

The second approach 

The second approach is more complicated, but does not require the modification of the classes in Ericson’s 
library. That is probably a better approach due simply to the fact that modifications to Ericson’s library 
are not required. However, that approach is not shown in this module. 

Outside research 

This program may require a significant amount of outside research on the part of the student in order to 

learn about: 


Alpha transparency 

A buffered image of type TYPE INT _ARGB 

The ability to use Ericson’s getBasicPixel and setBasicPixel methods, 
The use of the bitwise AND and OR operators, and 

The use of the drawImage method of the Graphics class. 


The getBasicPixel and setBasicPixel methods 

The program uses the getBasicPixel and setBasicPixel methods from Ericson’s library along with 
bitwise operations to set the alpha value for all the pixels in a cropped and flipped image of a butterfly to a 
hexadecimal value of 5F. 

Modification to the SimplePicture class 

The student must modify the SimplePicture class to cause the buffered image used to store the image 
tobe TYPE _INT_ARGB instead of TYPE INT_RGB , which is its normal type. 

Crop, flip, and set alpha values 

Then the student must write a method that will crop and flip an image of a butterfly and set the value 
of every alpha byte to a hexadecimal value of 5F. 

Draw a partially transparent image of a butterfly 

Finally, the student must use the standard drawImage method of the Graphics class to draw the 
image of the butterfly onto an image of a beach with transparency. 

Brief program specifications 

Write a program named Prob06 that uses the class definition for the class named Prob06 in 
Listing 7 (p. 1794) along with Ericson’s media library and the image files named Prob06a.jpg !°° and 
Prob06b.jpg '°° to produce the three graphic output images shown in Figure 1 (p. 1778) , Figure 2 (p. 
1782) , and Figure 3 (p. 1784) . 


135http://cnx.org/content /m44911/latest /Prob06a.jpg 
136http://cnx.org/content /m44911 /latest /Prob06b.jpg 
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Table 4.309 
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Prob01b.jpg 
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Prob01b.jpg 
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Prob01b.jpg 
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Table 4.310 
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EA prob01b.jpa 
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Table 4.311 


Define new classes 

You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named Prob06 given in Listing 7 (p. 1794) . 

A partially transparent image of a butterfly 

Just in case you haven’t noticed it, the final image of the beach contains a partially transparent image 
of a butterfly superimposed and centered on the beach image. 

Modification to the SimplePicture class 

In order to write this program, you will need to modify the class from Ericson’s media library named 
SimplePicture 

Your modifications must make it possible for you to display a partially transparent image on top of 
another image with the background image showing through. 

Transparency 

The degree of transparency can range from being completely transparent at one extreme to being totally 
opaque at the other extreme. In this case, the butterfly image shown in Figure 3 (p. 1784) is about 37-percent 
opaque (or 63-percent transparent) . 

Outside research 

You will probably need to do some outside research in order to write this program. For example, you 
will need to learn about the following topics and probably some other topics as well: 


Alpha transparency 

BufferedImage objects of TYPE _INT_ARGB 
The representation of a pixel as type int 

Bit manipulation of pixels 

The drawImage method of the Graphics class 


Required text output 
In addition to the output images described above, your program must produce the text output shown in 
Figure 4 (p. 1785) on the command- line screen. 


Figure 4 . Required text output. 


Dick Baldwin. 
Dick Baldwin 
Picture, filename Prob06a.jpg height 118 width 100 
Picture, filename Prob06b.jpg height 240 width 320 
Picture, filename None height 101 width 77 


Table 4.312 


You must substitute your name for my name wherever my name appears both in the images and on the 
command-line screen. 


4.4.2.2.1.4 General background information 


The image in a SimplePicture object is stored in an object of the BufferedImage class, which is a 
class in the standard Sun Java library. 
Image data formats 
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An examination of the documentation for the BufferedImage class shows that the red, green, blue, 
and alpha values for each pixel can be formatted in about fourteen different ways in an object of the 
BufferedImage class. 

No alpha data 

Some of those formats, including the way that information is stored ina SimplePicture object, don’t 
include an alpha value. 

Modification of the SimplePicture class 

One way to modify the SimplePicture class to force it to accommodate alpha transparency data is 
to modify one of the constructors for the SimplePicture class as shown in Listing 1 (p. 1786) . Note 
that BufferedImage.TYPE INT RGB was replaced by Bufferedimage. TYPE INT ARGB 
in Listing 1. (There are probably other ways that you can modify the class to achieve the same result as 
well.) 


Listing 1 . Modification of the SimplePicture class. 


/ ** 
* A constructor that takes the width and height desired 
* for a picture and creates a buffered image of that 
* size. This constructor doesn’t show the picture. 
*/ 
public SimplePicture(int width, int height){ 
//Disable the following statement 
//  bufferedImage = new BufferedImage ( 
// width, height, BufferedImage. TYPE_INT_RGB) ; 


//Modify constructor to support alpha transparency. 
System.out.println("Dick Baldwin"); 
bufferedImage = new BufferedImage( 

width, height, BufferedImage. TYPE_INT_ARGB) ; 


title = "None"; 

fileName = "None"; 

extension = "jpg"; 

setAll1PixelsToAColor (Color.white) ; 
}//end constructor 


Table 4.313 


Future Picture objects will accommodate alpha transparency 

Having made this modification, future objects instantiated from the SimplePicture class using this 
constructor will accommodate alpha transparency. (The SimplePicture class is the superclass of the 
Picture class.) 

Display the student’s name 

Note that the constructor in Listing 1 (p. 1786) is also modified to cause it to display the student’s name, 
which is a requirement of the program. 

No complete listing of SimplePicture provided 

Because of the simplicity of this modification, a complete listing of the modified SimplePicture class 
will not be provided in this module. 
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4.4.2.2.1.5 Discussion and sample code 
4.4.2.2.1.5.1 The class named Prob06 


You can view the driver class named Prob06 at the beginning of the source code in Listing 7 (p. 1794) . 
You are already familiar with the code in the main method of that class from earlier modules so I won’t 
spend any time explaining it. 
Briefly, the main method instantiates a new object of the class named Prob0O6Runner and calls the 
run method on that object. When the run method returns, the code in the main method displays 
some information about the three images and terminates. 
(Because there are images on the screen, the program does not actually terminate until the user forces 
it to terminate.) 


4.4.2.2.1.5.2 The class named Prob06Runner 


Will explain in fragments 

I will explain this program in fragments. A complete listing of the program is provided in Listing 7 (p. 
1794) near the end of the module 

The class named Prob06Runner begins in Listing 2 (p. 1787) , which shows the constructor for the 
class. 


Listing 2 . Beginning of the class named Prob06Runner. 


class Prob06Runner{ 


public Prob06Runner () {//constructor 
System.out.println("Dick Baldwin."); 
}//end constructor 


Table 4.314 


The constructor simply displays the student’s name to satisfy one of the requirements of the program. 

The run method 

The run method, which is called from the main method in Listing 7 (p. 1794) , is shown in its entirety 
in Listing 3 (p. 1788) . 
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Listing 3 . The run method. 


public Picture[] run(){ 
//Insert executable code here 
Picture picA = new Picture("Prob06a. jpg"); 
picA.explore(); 
Picture picB = new Picture("Prob06b. jpg"); 
picB.addMessage("Dick Baldwin.",10,20); 
picB.explore(); 


Picture picC = cropAndFlip(picA,4,5,80,105); 
copyPictureWithCrop(picC, picB,122,70); 
picB.show() ; 

Picture[] output = {picA,picB, picC}; 


return output; 
}//end run 


Table 4.315 


New material 


The only thing in Listing 3 (p. 1788) that is new to this module is the pair of calls to the following 


methods. I will explain these methods in the paragraphs that follow: 


e cropAndFlip 
e copyPictureWithCrop 


Beginning of the cropAndFlip method 


The cropAndFlip method begins in Listing 4 (p. 1789) . This method receives an incoming reference 
toa Picture object. It crops the picture to a set of specified coordinate values and flips it around a vertical 


line at its center. 
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Listing 4 . Beginning of the cropAndFlip method. 


private Picture cropAndFlip( 
Picture pic,int x1,int yl,int x2,int y2){ 
Picture output = new Picture(x2-x1+1,y2-y1+1); 


int width = output.getWidth() ; 
Pixel pixel = null; 
Color color = null; 
for(int col = x1;col < (x2+1);col++){ 
for(int row = yl;row < (y2+1);rowt+){ 
color = pic.getPixel(col, row) .getColor() ; 
pixel = output.getPixel (width-col+x1-1,row-y1); 
pixel.setColor(color) ; 
}//end inner loop 
}//end outer loop 


Table 4.316 


Receives a reference to the butterfly image 

Note from Listing 3 (p. 1788) that the cropAndFlip method receives a reference to the Picture 
object of the butterfly that is displayed in Figure 1 (p. 1778) . 

Also note that the butterfly in Figure 1 (p. 1778) is facing toward the right while the butterfly in the 
output image in Figure 3 (p. 1784) has been cropped to a smaller size and is facing toward the left. 

Crop and flip is not new 

The capability to crop and flip an image is not new to this module. However, the cropAndFlip method 
also makes the image partially transparent as shown in Figure 3 (p. 1784) . That capability is new to this 
module. I will explain how that is done shortly. 

A call to the modified SimplePicture constructor 

Although there is nothing new in the code in Listing 4 (p. 1789) , it is important to note that the first 
statement in Listing 4 (p. 1789) causes the SimplePicture constructor that was modified in Listing 1 (p. 
1786) to be called. 

As aresult, the Picture object referred to by the reference variable named output in Listing 4 (p. 
1789) will accommodate alpha transparency data. 

Make the pixels partially transparent 

The code in Listing 5 (p. 1790) uses a pair of nested for loops to iterate through all of the pixels in 
the picture referred to by output and modify each pixel. 

The four statements in the body of the inner loop in Listing 5 (p. 1790) cause the current pixel to become 
partially transparent. 
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Listing 5 . Make the pixels partially transparent. 


width = output.getWidthQ); 


int height = output.getHeight (); 


pixel = null; 


color = null; 
for(int col = 0;col < width;col++){ 
for(int row = O;row < height;row++){ 


int basicPixel = output.getBasicPixel(col,row) ; 


basicPixel = basicPixel & OxOOFFFFFF; 
basicPixel = basicPixel | 0x5F000000; 


output .setBasicPixel (col,row, basicPixel) ; 


}//end inner loop 
}//end outer loop 


return output; 
}//end crop and flip 


Table 4.317 


The getBasicPixel method 

According to Ericson’s documentation, the getBasicPixel method will "return the pixel value as an 
int for the given x and y location." In other words, a call to the getBasicPixel method will return an 
int value containing the red, green, blue, and alpha values for the pixel at the specified location. 

A bitwise AND operation 

Listing 5 (p. 1790) uses a bitwise AND operation (note the single ampersand) to force the eight 
most significant bits (the alpha byte) inthe int representation of the current pixel to zero while preserving 
the bit values stored in the least significant 24 bits. 

A bitwise OR operation 

Then Listing 5 (p. 1790) uses a bitwise OR operation (|) to store the hexadecimal value 5F in the 
eight most significant bits (the alpha byte) without changing the values stored in the 24 least significant 
bits. 

The alpha byte 

The value of the alpha byte can range from 0 to 255. When rendered using a mechanism that supports 
alpha transparency, an alpha value of zero causes the pixel to be totally transparent. 

Similarly, an alpha value of 255 causes the pixel to be totally opaque. 

Values between zero and 255 cause the pixel to be rendered as partially opaque or partially transparent, 
whichever terminology you prefer. 

Thirty-seven percent opaque 

If I did the arithmetic correctly, a hexadecimal value of 5F represents a decimal value of 95. Therefore, 
this value will cause the pixel to be about 37-percent opaque (or 63-percent transparent) . 

The setBasicPixel method 

As the name implies, the setBasicPixel method can be used to "set the value of a pixel in the picture 
from an int." 

Therefore, the last statement in the body of the inner loop in Listing 5 (p. 1790) replaces the value of 
the current pixel with the modified value containing a value of 95 in the alpha byte. 
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The end of the cropAndFlip method 

When the pair of nested for loops in Listing 5 (p. 1790) terminates, the cropAndFlip method 
returns control to the run method in Listing 3 (p. 1788) , returning a copy of the reference from the 
variable named output (see Listing 4 (p. 1789) ) in the process. 

Save the Picture object’s reference 

The returned reference is stored in the reference variable named picC in Listing 3 (p. 1788) . 

At this point, picC contains a reference to a butterfly image that has been cropped, flipped, and 
formatted into a buffered image that contains alpha transparency information. 

Call the copyPictureWithCrop method 

Listing 3 (p. 1788) immediately calls the copyPictureWithCrop method passing copies of the 
references stored in picC and picB along with a pair of integer coordinate values. 

The copyPictureWithCrop method 

The copyPictureWithCrop method is shown in its entirety in Listing 6 (p. 1791) . 


Listing 6 . The copyPictureWithCrop method. 


private void copyPictureWithCrop( 
Picture source,Picture dest,int xOff, 
int yOff){ 


Graphics destGraphics = dest.getGraphics() ; 
Image sourceImage = source.getImage() ; 
destGraphics.drawImage(sourceImage, 
xOff, 
yOff, 
null); 
}//end copyPictureWithCrop method 
}//end class Prob06Runner 


Table 4.318 


The purpose of the copyPictureWithCrop method is to copy a source picture onto a destination 
picture with an offset on each axis. 

An exercise for the student 

I won’t attempt to explain the code in Listing 6 (p. 1791) in this module. Instead, I will simply suggest 
that you go to Google and search for the following or similar keywords: 

baldwin java drawImage 

You will find many tutorials that I have written that deal with topics in this area. 

Modify the destination pixel colors 

I will tell you that the use of the drawImage method in Listing 6 (p. 1791) modifies the destination 
picture in such a way that the color of each pixel in the resulting image is a combination of the colors in the 
original destination image and the corresponding pixel in the source image. 

An illusion of transparency 

If a source pixel is totally transparent, it has no effect on the color of the destination pixel. 

If the source pixel is totally opaque, the color of the destination pixel is changed to the color of the source 
pixel. 

For alpha values between these two extremes, the final color of the destination pixel produces the illusion 
of a partially transparent image in front of the original destination image. 

Termination of the copyPictureWithCrop method 
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When the copyPictureWithCrop method terminates in Listing 6 (p. 1791) , control returns to the 
run method in Listing 3 (p. 1788) . 

Listing 3 (p. 1788) calls the show method to display the image in the now-modified Picture object 
referred to by picB , as shown in Figure 3 (p. 1784) . 

Return a reference to an array object 

Then the run method encapsulates references to each of the three images in an array object and returns 
control to the main method in Listing 7 (p. 1794) , returning a copy of the array object’s reference in the 
process. 

The main method in Listing 7 (p. 1794) displays information about each of the three Picture objects, 
producing the output shown in Figure 4 (p. 1785) . Then the main method terminates. 

Images don’t go away immediately 

Because there are images belonging to the program still on the screen, the program doesn’t return control 
to the operating system. It will simply wait until it is forced to terminate by the user before returning control 
to the operating system. 

Clicking the X-buttons in the upper-right corners of the images will simply hide the frames and won’t 
terminate the program. Some extra work is required to deal with this issue. 


4.4.2.2.1.6 Run the program 


I encourage you to copy the code from Listing 7 (p. 1794) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


4.4.2.2.1.7 Summary 


In this module, you learned about: 


Alpha transparency 

A buffered image of type TYPE_INT_ARGB 

The ability to use the getBasicPixel and setBasicPixel methods, 
The use of the bitwise AND and OR operators, 

The use of the drawImage method of the Graphics class. 


You modified the SimplePicture class to cause the buffered image used to store the image to be 
TYPE_INT_ARGB instead of TYPE_INT_RGB, which is its normal type. 

You wrote a method that cropped and flipped an image of a butterfly. 

You used the getBasicPixel and setBasicPixel methods from Ericson’s library along with bitwise 
operations to set the alpha value for all the pixels in the cropped and flipped image of the butterfly to a 
hexadecimal value of 5F. 

Finally, you used the standard drawImage method of the Graphics class to draw the image of the 
butterfly onto an image of a beach with transparency. 


4.4.2.2.1.8 What’s next? 


In the next module, you will learn how to use a slider to continuously change the opacity of an image and 
to draw that modified image onto a background image. 


4.4.2.2.1.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Using Alpha Transparency with Ericson’s Media Library 
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e File: Java3112.htm 
e Published: 05/13/12 
e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.2.1.10 Complete program listing 


A complete listing of the program discussed in this module is shown in Listing 7 (p. 1794) below. 
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Listing 7 . Complete program listing. 


/*File Prob06 Copyright 2008 R.G.Baldwin 
Revised 12/31/08 
FE IG EEE EEEE EEE EE EEE EEEE EEEE 21 21 EE 21 21 E EEE E EE EE 2 2k E / 
import java.awt.Color; 
import java.awt.Graphics; 
import java.awt.Image; 


public class Prob06{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
Picture[] pictures = new Prob06Runner() .run(); 
System. out.println(pictures[0]); 
System. out.println(pictures[1]) ; 
System. out.println(pictures[2]) ; 
}//end main method 
}//end class Prob06 


class Prob06Runner{ 


public Prob06Runner () {//constructor 
System.out.println("Dick Baldwin."); 
}//end constructor 


public Picture[] run(){ 
//Insert executable code here 
Picture picA = new Picture("Prob06a. jpg"); 
picA.explore(); 
Picture picB = new Picture("Prob06b. jpg"); 
picB.addMessage("Dick Baldwin.",10,20); 
picB.explore(); 


Picture picC = cropAndFlip(picA,4,5,80,105); 
copyPictureWithCrop(picC, picB,122,70); 


picB.show() ; 


Picture[] output = {picA,picB, picC}; 
return output; 
3//end run 


//Crops a picture to the specified coordinate values and 
// flips it around a vertical line at its center. 
//Also makes it partially transparent 
private Picture cropAndFlip( 
Picture pic,int x1,int yl,int x2,int y2){ 
Picture output = new Picture(x2-x1+1,y2-y1+1); 


gee wate outpnt pecuidth Qs i http: tent /col11441/1.181 
Pixel pixel = vate or free at Connexions <http://cnx.org/content/co /1.181> 
Color color null; 
for(int col = x1;col < (x2+1);col++){ 

for(int row = yl;row < (y2+1);rowt+){ 
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Table 4.319 
-end- 


4.4.2.2.2 Java OOP: Controlling Opacity with a Slider?” 


4.4.2.2.2.1 Table of Contents 
e Preface (p. 1795) 


Viewing tip (p. 1795) 


x Figures (p. 1795) 
x Listings (p. 1795) 


Preview (p. 1796) 

General background information (p. 1808) 
Discussion and sample code (p. 1809) 
Run the program (p. 1815) 

Summary (p. 1816) 

What’s next? (p. 1816) 

Miscellaneous (p. 1816) 

Complete program listing (p. 1816) 


4.4.2.2.2.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 138 . 


4.4.2.2.2.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.2.2.2.1.1 Figures 


e Figure 1 (p. 1800) . Screen output at startup. 
e Figure 2 (p. 1804) . Twenty-percent opacity. 
e Figure 3 (p. 1808) . Eighty-percent opacity. 


4.4.2.2.2.2.1.2 Listings 


Listing 1 (p. 1809) . Modification of the SimplePicture class. 
Listing 2 (p. 1810) . Beginning of the class named Prob07Runner. 
Listing 3 (p. 1811) . Beginning of the constructor. 

Listing 4 (p. 1812) . Display the initial image. 

Listing 5 (p. 1812) . Display the butterfly at 50-percent opacity. 
Listing 6 (p. 1813) . The setOpacity method. 


187This content is available online at <http://cnx.org/content /m44912/1.5/>. 
138http://cnx.org/content /m44148/latest / 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1791 


Listing 7 (p. 1814) . The drawPictureOnPicture method. 

Listing 8 (p. 1814) . Begin the registration of an event handler on the slider. 
Listing 9 (p. 1815) . Draw the butterfly and repaint. 

Listing 10 (p. 1817) . Complete program listing. 


4.4.2.2.2.3 Preview 


The primary objective of this module is to illustrate how to use a slider to continuously change the opacity 
of an image and to draw that image onto a background image. 

Two approaches 

This module builds on an earlier module involving transparency. In that module, you learned that there 
are at least two ways to incorporate alpha transparency into Ericson’s media library, The easiest way, which 
is not necessarily the best way, is to make a relatively simple modification to a constructor in Ericson’s 
SimplePicture class. That is the approach used in this module. 

The second approach 

The second approach is more complicated, but does not require the modification of the classes in Ericson’s 
library. That is probably a better approach due simply to the fact that modifications to Ericson’s library 
are not required. However, that approach is not shown in this module. 

Outside research 

As with the earlier module, the program that I will explain in this module may require a significant 
amount of outside research on the part of the student in order to learn about: 


Alpha transparency 

A buffered image of type TYPE INT _ARGB 

The ability to use Ericson’s getBasicPixel and setBasicPixel methods, 
The use of the bitwise AND, OR, and left-shift operators. 

The use of the drawImage method of the Graphics class. 


Modification to the SimplePicture class 
The student must modify the SimplePicture class to cause the buffered image used to store the image 
tobe TYPE_INT_ARGB instead of TYPE INT_RGB , which is its normal type. 


Generally speaking, this program: 


Instantiates a new visual object that extends the JFrame class and contains a JSlider object. 
Instantiates Picture objects from two image files (beach and butterfly) along with some blank 
Picture objects of the same size. 

e Defines a method named setOpacity that can be called to set the opacity of every pixel in a picture 
to a specified value. 

e Defines a method named drawPictureOnPicture that can be called to draw one picture onto 
another picture. 

e Registers a ChangeEvent handler on the slider to: 


Extract a percent-opacity value from the slider based on the position of the thumb. 
Apply that opacity value to the butterfly image. 
Draw the modified butterfly image on the beach image and display it. 


Brief program specifications 

Write a program named ProbO7 that uses the class definition for the class named Prob07 in Listing 
10 (p. 1817) along with Ericson’s media library and the image files named Prob07a.jpg 13° and Prob07b.jpg 
140 to produce the two output images shown in Figure 1 (p. 1800) . 


139http://cnx.org/content /m44912/latest /Prob07a.jpg 
40http://cnx.org/content /m44912/latest /Prob07b.jpg 
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Figure 1 . Screen output at startup. 
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Table 4.320 


Two output images 

Note that Figure 1 (p. 1800) actually consists of two output images, one positioned below the other. 

Move the thumb to the left 

When you move the thumb on the slider to the left, the butterfly becomes less opaque (more transparent) 
as shown in Figure 2 (p. 1804) with total transparency at the extreme left end of the slider. 
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Figure 2 . Twenty-percent opacity. 
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Table 4.321 


Move the thumb to the right 
When you move the thumb on the slider to the right, the butterfly becomes more opaque (less transparent) 
as shown in Figure 3 (p. 1808) with total opacity at the extreme right end of the slider. 
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Figure 3 . Eighty-percent opacity. 
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Table 4.322 


Define new classes 
You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named Prob07 given in Listing 10 (p. 1817) . 


4.4.2.2.2.4 General background information 


The image in a SimplePicture object is stored in an object of the BufferedImage class, which is a 
class in the standard Sun Java library. 

Image data formats 

An examination of the documentation for the BufferedImage class shows that the red, green, blue, 
and alpha values for each pixel can be formatted in about fourteen different ways in an object of the 
BufferedImage class. 

No alpha data 

Some of those formats, including the way that information is stored ina SimplePicture object, don’t 
include an alpha value. 

Modification of the SimplePicture class 
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One way to modify the SimplePicture class to force it to accommodate alpha transparency data is 
to modify one of the constructors for the SimplePicture class as shown in Listing 1 (p. 1809) . Note the 
change indicated by comments in Listing 1. (There are probably other ways that you can modify the class 
to achieve the same result as well.) 


Listing 1 . Modification of the SimplePicture class. 


/ ** 
* A constructor that takes the width and height desired 
* for a picture and creates a buffered image of that 
* size. This constructor doesn’t show the picture. 
*/ 
public SimplePicture(int width, int height){ 
//Disable the following statement 
// bufferedImage = new BufferedImage ( 
// width, height, BufferedImage. TYPE_INT_RGB) ; 


//Modify constructor to support alpha transparency. 
bufferedImage = new BufferedImage( 
width, height, BufferedImage. TYPE_INT_ARGB) ; 


title = "None"; 

fileName = "None"; 

extension = "jpg"; 

setAl1PixelsToAColor (Color. white) ; 
}//end constructor 


Table 4.323 


Future Picture objects will accommodate alpha transparency 

Having made this modification, future objects instantiated from the SimplePicture class using this 
constructor will accommodate alpha transparency. (The SimplePicture class is the superclass of the 
Picture class.) 

No complete listing of SimplePicture provided 

Because of the simplicity of this modification, a complete listing of the modified SimplePicture class 
will not be provided in this module. 


4.4.2.2.2.5 Discussion and sample code 
4.4.2.2.2.5.1 The class named Prob07 


You can view the driver class named Prob07 at the beginning of the source code in Listing 10 (p. 1817) . 
You are already familiar with the code in the main method of that class from earlier modules so I won’t 
spend any time explaining it. 
Briefly, the main method instantiates a new object of the class named Prob0O7Runner and calls the 
run method on that object. When the run method returns, the GUI shown in Figure 1 (p. 1800) has 
been displayed on the screen. 
At that point, the program simply goes into an idle state and waits for the user to take some action that 
causes an event to be fired. When an event is fired, it is handled and the program goes idle again waiting 
for another event. 
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(Because there are images on the screen, the program does not actually terminate until the user forces 
it to terminate.) 


4.4.2.2.2.5.2 The class named Prob07Runner 


Will explain in fragments 

I will explain this program in fragments. A complete listing of the program is provided in Listing 10 (p. 
1817) near the end of the module. 

Beginning of the class named Prob07Runner 

The class named Prob0O7Runner begins in Listing 2 (p. 1810) . 


Listing 2 . Beginning of the class named Prob0O7Runner. 


class ProbO7Runner extends JFrame{ 


private JPanel mainPanel = new JPanel(); 
private JPanel titlePanel = new JPanel(); 
private JSlider slider = new JSlider(); 


private Picture background = new Picture("Prob07b. jpg"); 
private Picture butterfly = new Picture("Prob07a. jpg"); 


private int backgroundWidth = background. getWidth() ; 
private int backgroundHeight = background. getHeight (); 
private int butterflyWidth = butterfly.getWidthQ); 
private int butterflyHeight = butterfly. getHeight () ; 


private Picture display = 
new Picture (backgroundWidth, backgroundHeight) ; 
private Picture tempPicture = 
new Picture(butterflyWidth, butterflyHeight) ; 


private Image image = null; 
private Graphics graphics = null; 


Table 4.324 


Class extends JFrame 

Note that this class extends JFrame . An object of this class forms the lower part of the image shown 
in Figure 1 (p. 1800) that contains the slider. 

The code in Listing 1 (p. 1809) is straightforward and shouldn’t require an explanation. 

When Listing 2 finishes executing... 

When the code in Listing 2 (p. 1810) has finished executing, four new Picture objects have been 
instantiated and referred to by the following reference variables: 


e background - The beach scene shown in the background in Figure 1 (p. 1800) . 
e butterfly - Contains an opaque image of the butterfly shown in Figure 1 (p. 1800) . 
e display - Empty picture the same size as the beach scene. 
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e tempPicture - Empty picture the same size as the butterfly. 


In addition, a pair of working variables named image and graphics of the types Image and Graphics 
have been declared. 

Finally, when the code in Listing 2 (p. 1810) has finished executing, two new JPanel objects and 
one new JSlider object have been instantiated and referred to by the variables named mainPanel 
titlePanel , and slider 

Beginning of the constructor 
The beginning of the constructor is shown in Listing 3 (p. 1811) . 


ki 


Listing 3 . Beginning of the constructor. 


public Prob07Runner (){//constructor 
//Do some initial setup. 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 


slider .setMajorTickSpacing(10) ; 
slider .setMinorTickSpacing (5) ; 
slider.setPaintTicks (true); 
slider.setPaintLabels (true); 


mainPanel.setLayout (new BorderLayout ()); 
titlePanel.add(new JLabel ( 

"Percent Opacity of Butterfly")); 
mainPanel.add(titlePanel , BorderLayout .NORTH) ; 
mainPanel.add(slider, BorderLayout .CENTER) ; 


getContentPane() .add(mainPanel1) ; 
setSize(backgroundWidth + 7,97); 


setLocation(0,backgroundHeight + 25); 
setVisible(true) ; 


Table 4.325 


Although it may be necessary for you to go to Sun’s Java documentation to learn about the detailed 
behavior of some of the methods that are called in Listing 3 (p. 1811) , the code in Listing 3 (p. 1811) is 
straightforward and should not require further explanation. 

Display the initial background image 

Listing 4 (p. 1812) displays the initial background image. 

Instantiating and destroying a lot of new Picture objects as the user moves the slider to change the 
opacity would be very inefficient. To avoid this inefficiency, this program gets images from existing Picture 
objects and draws them on existing Picture objects without modifying the originals. 
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Listing 4 . Display the initial image. 


graphics = display.getGraphics(); 
graphics.drawlmage (background. getImage() ,0,0,nul11) ; 


Table 4.326 


Display the butterfly at 50-percent opacity 

Listing 5 (p. 1812) calls the setOpacity and drawPictureOnPicture methods to set the opacity 
of the butterfly and draw it onto the display with 50-percent opacity. The image of the butterfly is centered 
on the background. 


Listing 5 . Display the butterfly at 50-percent opacity. 


butterfly = setOpacity(butterfly,50) ; 
drawPictureOnPicture ( 

butterfly, 

display, 

backgroundWidth/2 - butterflyWidth/2, 

backgroundHeight/2 - butterflyHeight/2) ; 
display.show(); 


Table 4.327 


Put the constructor on hold 

At this point, I will put the discussion of the constructor on hold and explain the setOpacity and 
drawPictureOnPicture methods. 

The setOpacity method 

The setOpacity method is shown in its entirety in Listing 6 (p. 1813) . 
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Listing 6 . The setOpacity method. 


private Picture setOpacity ( 
Picture pic,double percentOpacity) { 


int opacity = (int) (255*percentOpacity/100) ; 
int opacityMask = opacity < 24; 


for(int col = 0;col < butterflyWidth;col++){ 
for(int row = O;row < butterflyHeight;row++){ 
//Get the pixel in basic int format. 
int basicPixel = pic.getBasicPixel(col,row) ; 


//Set the alpha value for the pixel. 
basicPixel = basicPixel & OxOOFFFFFF; 
basicPixel = basicPixel | opacityMask; 


//Set the modified pixel into tempPicture. 
tempPicture.setBasicPixel (col, row, basicPixel) ; 
}//end inner loop 
}//end outer loop 


return tempPicture; 


}//end setOpacity 


Table 4.328 


This method copies an incoming picture into an existing temporary picture, setting the alpha value for 
every pixel to a specified value in the process. Then it returns the modified picture object’s reference where 
it is saved in the reference variable named butterfly in Listing 5 (p. 1812) , 

A bitwise left-shift operation 
The only thing in Listing 6 (p. 1813) that is new to this module is the use of a bitwise left-shift operation. 
A 24-bit left shift 

Listing 6 (p. 1813) converts the incoming percentOpacity value to an integer value ranging from 0 
to 255. This value resides in the least significant eight bits of an int variable named opacity 

Then Listing 6 (p. 1813) applies the bitwise left-shift operator (two left angle brackets) to shift 
those eight bits into the eight most significant bits and stores the result in another int variable named 
opacity Mask 

Apply the opacityMask to the pixels 

A pair of nested for loops is used to set the alpha value of every pixel to the value of opacityMask 

using an overall bit-masking methodology that I explained in an earlier module. 
The drawPictureOnPicture method 

After the alpha value for every pixel in the butterfly image has been set to the specified opacity, Listing 
5 (p. 1812) calls the method named drawPictureOnPicture to draw the modified butterfly image on 
the beach scene as shown in Figure 1 (p. 1800) . 
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The drawPictureOnPicture method is shown in its entirety in Listing 7 (p. 1814) . 


Listing 7 . The drawPictureOnPicture method. 


private void drawPictureO0nPicture( 
Picture source,Picture dest,int xOff, 
int yOff){ 


Graphics destGraphics = dest.getGraphics(); 
Image sourceImage = source. getImage() ; 
destGraphics.drawImage(sourceImage, 
xOff, 
yOff, 
null); 
}//end drawPictureOnPicture method 


Table 4.329 


This method draws the source picture onto the destination picture with an offset on both axes. There is 
nothing in Listing 7 (p. 1814) that I haven’t explained in an earlier module. 

Return to the explanation of the constructor 

You are already familiar with the use of anonymous inner classes to create and register listener objects 
on Java source objects. The slider is a source object. 

Listing 8 (p. 1814) begins the registration of an anonymous ChangeF vent. listener on the slider. 


Listing 8 . Begin the registration of an event handler on the slider. 


slider .addChangeListener ( 
new ChangeListener () { 

public void stateChanged(ChangeEFvent e){ 
//Draw a new copy of the background on the 
// display. 
graphics = display.getGraphics(); 
graphics. drawImage ( 

background. get Image() ,0,0,nul11); 


Table 4.330 


Restore the background image 

Each time the slider fires a ChangeEvent , this event handler draws a new background image on the 
display. This erases what was previously drawn there, restoring a pristine image of the beach scene. 

Draw a partially opaque butterfly image on the background 
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Then it uses the current value of the slider to set the opacity of the butterfly image and draws it centered 
on the display on top of the background image. 

A series of events 

The slider fires a series of ChangeEvents as the user moves the thumb on the slider. Listing 8 (p. 
1814) begins the definition of the event handler method named stateChanged_, which is registered on 
the slider. This method is called each time the slider fires a ChangeEvent 

Listing 8 (p. 1814) draws a new copy of the beach background image on the Picture object referred to 
by the reference variable named background . This image replaces the image that was previously drawn 
there. 

Draw the butterfly and repaint 

Listing 9 (p. 1815) calls the setOpacity and drawPictureOnPicture methods to: 


e Set the opacity of the butterfly to the value currently represented by the position of the thumb on the 
slider. This is the value returned by the slider’s getValue method. 
e Draw the butterfly image on the background image. 


Listing 9 . Draw the butterfly and repaint. 


//Set the opacity of butterfly and copy it onto 

// the display. Then repaint the display. 
butterfly = 

setOpacity (butterfly, slider.getValue()); 
drawPictureOnPicture ( 

butterfly, 

display, 

backgroundWidth/2 - butterflyWidth/2, 

backgroundHeight/2 - butterflyHeight/2) ; 


display.repaint(); 
}//end stateChanged 
}//end new ChangeListener 
);//end addChangeListener 


}//end constructor 


Table 4.331 


Repaint the image 

Then Listing 9 (p. 1815) calls the repaint method to cause the modified image to be rendered onto 
the computer screen. 

The end of the program 

Listing 9 (p. 1815) also signals the end of the constructor, the end of the class named Prob07Runner 
, and the end of the program. 


4.4.2.2.2.6 Run the program 


I encourage you to copy the code from Listing 10 (p. 1817) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 
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4.4.2.2.2.7 Summary 


In this module, you learned how to use a slider to continuously change the opacity of an image and draw 
that image onto a background image. 


4.4.2.2.2.8 What’s next? 


In the next module, you will learn how to use a slider to continuously change the threshold detection level 
of an edge detector and to draw the edge-detected image on the screen. 


4.4.2.2.2.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Controlling Opacity with a Slider 
e File: Java3114.htm 

e Published: 05/13/12 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.2.2.10 Complete program listing 


A complete listing of the program discussed in this module is shown in Listing 10 (p. 1817) below. 
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Listing 10 . Complete program listing. 


/*File Prob0O7 Copyright 2008 R.G.Baldwin 
FEO EEEE EEEE EEE EE EE EEEE I I EE 21 21 EE 21 21 21 4 2 E EE E 2k 2 2 E / 
import java.awt.Color; 
import java.awt.Graphics; 
import java.awt. Image; 
import java.awt.BorderLayout ; 


import javax.swing. JFrame; 

import javax.swing. JPanel; 

import javax.swing.JSlider; 

import javax.swing.JLabel; 

import javax.swing.event.ChangeListener ; 
import javax.swing.event.ChangeEvent; 


public class ProbO7{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new ProbO7Runner () ; 
}//end main method 
}//end class Prob07 


class ProbO7Runner extends JFrame{ 


private JPanel mainPanel = new JPanel(); 
private JPanel titlePanel = new JPanel(); 
private JSlider slider = new JSlider(); 


private Picture background = new Picture("Prob07b. jpg"); 
private Picture butterfly = new Picture("Prob07a. jpg"); 


private int backgroundWidth = background. getWidth() ; 
private int backgroundHeight = background. getHeight (); 
private int butterflyWidth = butterfly.getWidthQ); 
private int butterflyHeight = butterfly. getHeight () ; 


private Picture display = 
new Picture (backgroundWidth, backgroundHeight) ; 
private Picture tempPicture = 
new Picture(butterflyWidth, butterflyHeight) ; 


private Image image = null; 
private Graphics graphics = null; 


public Prob07Runner () {//constructor 
//Do some initial setup. 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
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slider.setPaintTicks (true); 


slider.setPaintLabels (true); 
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Table 4.332 
-end- 
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4.4.2.2.3 Java OOP: Controlling an Edge Detector with a Slider 
4.4.2.2.3.1 Table of Contents 
e Preface (p. 1818) 


Viewing tip (p. 1818) 


x Figures (p. 1818) 
x Listings (p. 1818) 


Preview (p. 1819) 

Discussion and sample code (p. 1826) 
Run the program (p. 1831) 
Summary (p. 1831) 

What’s next? (p. 1831) 
Miscellaneous (p. 1831) 

Complete program listing (p. 1832) 


4.4.2.2.3.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 1# . 


4.4.2.2.3.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.2.3.2.1.1 Figures 


e Figure 1 (p. 1821) . Contents of the file named Prob08.jpg. 
e Figure 2 (p. 1825) . Output images. 


4.4.2.2.3.2.1.2 Listings 


e Listing 1 (p. 1827) . Beginning of the class named Prob08Runner. 
e Listing 2 (p. 1828) . Beginning of the constructor. 

e Listing 3 (p. 1828) . Beginning of the edgeDetector method. 

e Listing 4 (p. 1830) . Detect using adjacent pixels in each column. 
e Listing 5 (p. 1831) . Register a ChangeEvent listener on the slider. 
e Listing 6 (p. 1833) . Complete program listing. 


141This content is available online at <http://cnx.org/content /m44913/1.4/>. 
142http://cnx.org/content /m44148/latest / 
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4.4.2.2.3.3 Preview 


An earlier module (see 3D Displays, Color Distance, and Edge Detection ‘43 ) explained how to implement 
an edge detection algorithm for a fixed detection threshold. 

The primary objective of this module is to illustrate how to use a slider to continuously change the 
detection threshold of an edge detector and to draw the edge-detected image on the screen. 

Brief program specifications 

Write a program named Prob08 that uses the class definition for the class named Prob08 shown in 
Listing 6 (p. 1833) and Ericson’s media library along with the image file named Prob08.jpg 144 (shown in 
Figure 1 (p. 1821) ) to produce the two graphic output images shown in Figure 2 (p. 1825) . 


M43http://www.developer.com/java/other/article.php/3798646/3D-Displays-Color-Distance-and-Edge-Detection.htm 
M44h¢ttp://cnx.org/content /m44913/latest /Prob08.jpg 
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Figure 1 . Contents of the file named Prob08.jpg. 
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Figure 2 . Output images. 


Edge Detection Threshold 
$l 


0 10 20 30 40 50 60 70 80 90700 


Table 4.334 


Note that Figure 2 (p. 1825) consists of two separate output images. The image containing the slider is 
positioned directly below the image of the butterfly. 

New classes 

You may define new classes as necessary to cause your program to behave as required, but you may not 
modify the class definition for the class named Prob08 given in Listing 6 (p. 1833) . 

The output images 

The top image shown in Figure 2 (p. 1825) is an image of a butterfly to which an edge detection algorithm 
has been applied. 

The bottom image in Figure 2 (p. 1825) is a slider that is used to control the edge-detection threshold. 

Detect by rows and by columns 

The edge-detection algorithm performs edge detection on a Picture object by rows and also by columns. 

All edges that are detected by processing adjacent pixels on a row are marked in red. All edges that are 
detected by processing adjacent pixels on a column are marked in black. 

If a pixel is determined to be on an edge using both approaches, it ends up being black. If an edge is not 
detected, the corresponding pixel is marked in white. 
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Program behavior 

At startup, the thumb on the slider is positioned at the 50-percent mark and the image has been edge- 
detected using a threshold value of 50. 

As you move the slider to the right, the threshold value increases up to a value of 100, which in turn 
causes the amount of white area in the image to increase. 

As you move the slider to the left, the threshold value decreases down to a value of zero, which in turn 
causes the amount of white area in the image to decrease. 

The program must terminate and return control to the operating system when you click the large X in 
the upper-right corner of the GUI containing the slider. 

In addition to the output images described above, your program must display your name on the command- 
line screen. 


4.4.2.2.3.4 Discussion and sample code 
4.4.2.2.3.4.1 The class named Prob08 


You can view the driver class named Prob08 at the beginning of the source code in Listing 6 (p. 1833) . 
You are already familiar with the code in the main method of that class from earlier modules so I won’t 
spend any time explaining it. 
Brief description 
Briefly, the main method instantiates a new object of the class named ProbO8Runner and calls the 
run method on that object. When the run method returns, the GUI shown in Figure 2 (p. 1825) has 
been displayed on the screen. 

At that point, the program simply goes into an idle state and waits for the user to take some action that 
causes an event to be fired. When an event is fired, it is handled and the program goes idle again waiting 
for another event. 

(Because there are images on the screen, the program does not terminate until the user forces it to 
terminate.) 


4.4.2.2.3.4.2 The class named Prob08Runner 


Will explain in fragments 

I will explain this program in fragments. A complete listing of the program is provided in Listing 6 (p. 
1833) near the end of the module. 

Beginning of the class named Prob0&8Runner 

The class named ProbO8Runner begins in Listing 1 (p. 1827) . 
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Listing 1 . Beginning of the class named Prob0O8Runner. 


class ProbOSRunner extends JFrame{ 


private JPanel mainPanel = new JPanel(); 
private JPanel titlePanel = new JPanel(); 
private JSlider slider = new JSlider(); 


private Picture butterfly = 
new Picture("Prob08. jpg"); 


private int butterflyWidth = 
butterfly.getWidth() ; 
private int butterflyHeight = 
butterfly. getHeight (); 


private Picture display = 
new Picture (butterflyWidth, butterflyHeight) ; 


private Pixel pix1; 
private Pixel pix2; 


private Pixel displayPixel; 


private double distance = 0; 


Table 4.335 


There is nothing in Listing 1 (p. 1827) that I haven’t explained in earlier modules, so I won’t repeat 


those explanations here. 
Beginning of the constructor 
The constructor begins in Listing 2 (p. 1828) . 
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Listing 2 . Beginning of the constructor. 


public Prob08Runner (){//constructor 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 


slider .setMajorTickSpacing(10) ; 
slider .setMinorTickSpacing (5) ; 
slider.setPaintTicks (true); 
slider.setPaintLabels (true); 


mainPanel.setLayout (new BorderLayout ()); 
titlePanel.add(new JLabel ( 

"Edge Detection Threshold")); 
mainPanel.add(titlePanel , BorderLayout .NORTH) ; 
mainPanel.add(slider, BorderLayout .CENTER) ; 


getContentPane() .add(mainPanel1) ; 


setSize(butterflyWidth + 7,97); 
setLocation(0,butterflyHeight + 25); 
setVisible(true) ; 


//Produce the initial display with a threshold 
// value of 50, which matches the initial 

// position of the pointer on the slider. 
display = edgeDetector (butterfly, 50); 


display.show(); 


Table 4.336 


Put the constructor on hold 

The only thing that is new in Listing 2 (p. 1828) is the call to the method named edgeDetector . I 
will put the explanation of the constructor on hold while I explain the method named edgeDetector 

Beginning of the edgeDetector method 

The edgeDetector method begins in Listing 3 (p. 1828) . 

This method performs edge detection on a Picture object by rows and also by columns. 

As mentioned earlier, all edges that are detected by processing adjacent pixels on a row are marked in 
red. 

All edges that are detected by processing adjacent pixels on a column are marked in black. 

If a pixel is determined to be on an edge using both approaches, it ends up being black. 


Listing 3 . Beginning of the edgeDetector method. 


continued on next page 
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private Picture edgeDetector( 
Picture picture,int threshold) { 
for(int row = 0;row < butterflyHeight - 1;rowt+){ 
for(int col = 0;col < butterflyWidth - 1;col++){ 
pixi = picture.getPixel(col,row) ; 
displayPixel = display.getPixel(col,row); 


//First process two adjacent pixels on the 
// same row. 
pix2 = picture.getPixel(col + 1,row); 


//Get and save the color distance between the 
// two pixels. 
distance = pix1.colorDistance(pix2.getColor()); 


//Compare the color distance to the threshold 

// and set the color of the pixel in the 

// display picture accordingly. 

if (distance > threshold) { 
displayPixel.setColor(Color.RED) ; 

}else{ 
displayPixel.setColor(Color.WHITE) ; 

3//end else 


Table 4.337 


A pair of nested for loops 

Listing 3 (p. 1828) shows the beginning of a pair of nested for loops that I used to detect the edges in 
the image of the butterfly. The code in Listing 3 (p. 1828) detects edges using adjacent pixels on each row 
and sets the color of the corresponding pixel in the output picture to red if an edge is detected. 

(Note that the output picture referred to by display was instantiated as an instance variable in Listing 
1 (p. 1827) .) 

I explained an edge-detection algorithm in great detail in an earlier module titled 3D Displays, Color 
Distance, and Edge Detection 145 . The code in Listing 3 (p. 1828) is essentially an implementation of that 
algorithm where the detection threshold is an input parameter to the method. 

Detect using adjacent pixels in each column 
Listing 4 (p. 1830) detects edges using adjacent pixels on the columns. 


'45http://www.developer.com/java/other/article_php/3798646/3D-Displays-Color-Distance-and-Edge-Detection.htm 
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Listing 4 . Detect using adjacent pixels in each column. 


//Now process two adjacent pixels in the same 
// column using the same approach. 
pix2 = picture.getPixel(col,row + 1); 
distance = pix1.colorDistance(pix2.getColor()); 
//Compare the color distance to the threshold 
// and change pixel color accordingly. 
if (distance > threshold) { 
displayPixel.setColor(Color.BLACK) ; 
}//end if 


}//end inner loop 
}//end outer loop 


return display; 
}//end edgeDetector 


Table 4.338 


If an edge is detected in Listing 4 (p. 1830) , the color of the corresponding pixel in the output picture 
is set to black. 

Return the output picture and terminate 

The edgeDetector method returns a reference to the output picture and terminates in Listing 4 (p. 
1830) . 

(While writing this, I realized that because the variable named display is an instance variable, the 

program would also work properly if the edgeDetector method were to return void.) 

Returning to the constructor... 

Returning to where we left off in Listing 2 (p. 1828) , the show method is called on the output picture 
referred to by display causing an image similar to that shown in Figure 2 (p. 1825) to be displayed. 

Register a ChangeEvent listener on the slider 

Listing 5 (p. 1831) registers an anonymous listener object on the slider. Each time the slider fires a 
ChangeEvent , the method named stateChanged is executed. 
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Listing 5 . Register a ChangeEvent listener on the slider. 


slider .addChangeListener ( 
new ChangeListener () { 
public void stateChanged(ChangeEvent e){ 


display = edgeDetector( 
butterfly,slider.getValue()); 
display.repaint(); 


}//end stateChanged 


}//end new ChangeListener 
);//end addChangeListener 


}//end class ProbO08Runner 


Table 4.339 


Call the edgeDetector method 

The stateChanged method calls the edgeDetector method to get a new edge-detected image for 
which the threshold is the current value of the slider. 

Then the display is repainted showing the new image on the screen. 

The end of the program 

Listing 5 (p. 1831) also signals the end of the constructor, the end of the class, and the end of the 
program. 


4.4.2.2.3.5 Run the program 


I encourage you to copy the code from Listing 6 (p. 1833) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


4.4.2.2.3.6 Summary 


In this module, you learned how to use a slider to continuously change the threshold detection level of an 
edge detector and to draw the edge-detected image on the screen. 


4.4.2.2.3.7 What’s next? 


In the next module, you will learn how to use a slider to continuously change the size of an image and to 
draw the scaled image onto a background image. 


4.4.2.2.3.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Controlling an Edge Detector with a Slider 
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e File: Java3116.htm 
e Published: 05/13/12 
e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.2.3.9 Complete program listing 


A complete listing of the program discussed in this module is shown in Listing 6 (p. 1833) . 
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Listing 6 . Complete program listing. 


/*File Prob08 Copyright 2008 R.G.Baldwin 
*Revised 12/31/08 


FE AG EEEE EEEE EEE IGG I ICI I I I A 1 21 21 EE 21 21 E EEE E 2 EE 2 2 E / 
import javax.swing. JFrame; 

import javax.swing. JPanel; 

import javax.swing.JSlider; 

import javax.swing.JLabel; 

import javax.swing.event.ChangeListener ; 

import javax.swing.event.ChangeEvent; 

import java.awt.BorderLayout ; 

import java.awt.Color; 


public class Prob08{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
new ProbO8Runner () ; 
}//end main method 
}//end class Prob08 


class ProbOSRunner extends JFrame{ 


private JPanel mainPanel = new JPanel(); 
private JPanel titlePanel = new JPanel(); 
private JSlider slider = new JSlider(); 


private Picture butterfly = new Picture("Prob08. jpg"); 


private int butterflyWidth = butterfly.getWidthQ; 
private int butterflyHeight = butterfly. getHeight () ; 


private Picture display = 
new Picture (butterflyWidth, butterflyHeight) ; 


private Pixel pix1; 
private Pixel pix2; 
private Pixel displayPixel; 


private double distance = 0; 


public Prob08Runner () {//constructor 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 


slider .setMajorTickSpacing(10) ; 
slider .setMinorTickSpacing (5) ; 
slider.setPaintTicks (true); 
slider.setPaintLabels (true); 


mainPanel.setLayout (new BorderLayout ()); 

titlePanel. ada ioe Teapot é Connexions <http://cnx.org/content/col11441/1.181> 
"Edge Detection Threshold")) ; 

mainPanel.add(titlePanel , BorderLayout .NORTH) ; 

mainPanel.add(slider, BorderLayout .CENTER) ; 
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Table 4.340 
-end- 


6 


4.4.2.2.4 Java OOP: Controlling an Image-Scaling Program with a Slider” 
4.4.2.2.4.1 Table of Contents 
e Preface (p. 1834) 


Viewing tip (p. 1834) 


x Figures (p. 1834) 
x Listings (p. 1834) 


Preview (p. 1835) 

General background information (p. 1843) 
Discussion and sample code (p. 1843) 
Run the program (p. 1845) 

Summary (p. 1845) 

What’s next? (p. 1846) 

Miscellaneous (p. 1846) 

Complete program listing (p. 1846) 


4.4.2.2.4.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 147 . 


4.4.2.2.4.2.1 Viewing tip 
I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.2.4.2.1.1 Figures 


e Figure 1 (p. 1837) . Prob09a.jpg. 
e Figure 2 (p. 1839) . Prob09b.jpg. 
e Figure 3 (p. 1843) . Output images. 


4.4.2.2.4.2.1.2 Listings 


e Listing 1 (p. 1844) . Register a listener object on the slider. 
e Listing 2 (p. 1845) . The method named drawScaledPictureOnPicture. 
e Listing 3 (p. 1847) . Complete program listing. 


146 This content is available online at <http://cnx.org/content /m44914/1.4/>. 
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4.4.2.2.4.3 Preview 


The primary objective of this module is to illustrate how to use a slider to continuously change the size of 
an image and to draw the scaled image onto a background image. 

Brief program specifications 

Write a program named Prob09 that uses the class definition for the class named Prob09 shown 
in Listing 3 (p. 1847) and Ericson’s media library along with the image files named Prob09a.jpg 148 (see 
Figure 1 (p. 1837) ) and Prob09b.jpg 14° (see Figure 2 (p. 1839) ) to produce the graphic output images 
shown in Figure 3 (p. 1843) . 


M48http://cnx.org/content /m44914/latest /Prob09a.jpg 
M49http://cnx.org/content /m44914 /latest /Prob09b.jpg 
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Figure 1 . Prob09a.jpg. 
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Figure 2 . Prob09b.jpg. 


Table 4.342 
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Figure 3 . Output images. 
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Table 4.343 


4.4.2.2.4.4 General background information 


The overall structure of this program is very similar to a program that I explained in an earlier module titled 
Controlling an Edge Detector with a Slider °° . The only significant difference between the two programs 
is the code that is executed when the slider fires a ChangeEvent 

I will explain the code that is new and different in this program and refer you back to the earlier module 
for an explanation of the remainder of the code. You can view the entire program in Listing 3 (p. 1847) 
near the end of the module. 


4.4.2.2.4.5 Discussion and sample code 


Register a listener object on the slider 
The code in Listing 1 (p. 1844) registers an anonymous listener object on the slider. 


150h¢tp://cnx.org/content /m44913/latest 
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Listing 1 . Register a listener object on the slider. 


slider .addChangeListener ( 
new ChangeListener () { 
public void stateChanged(ChangeEvent e){ 


//Restore the background image of the butterfly. 
graphics = display.getGraphics(); 
graphics. drawImage ( 

butterfly.getImage() ,0,0,nul1); 


drawScaledPictureOnPicture(beach, 
display, 
slider .getValue()); 
display.repaint(); 
}//end stateChanged 
}//end new ChangeListener 
);//end addChangeListener 


Table 4.344 


Each time the slider fires a ChangeEvent , the method named stateChanged is executed. 
Behavior of the stateChanged method 

The stateChanged method restores the background image of the butterfly. Then it calls the method 
named drawScaledPictureOnPicture to draw a scaled version of the beach on top of the background 
image using the slider value as the scale factor. 

The slider value ranges from 0 to 100. This represents a scale factor as a percent of 1.0. In other words, 
the beach image is never scaled to a size that is larger than the size of the original beach image. 

The image of the beach is always aligned with the center of the contentPane of the JFrame 

When the drawScaledPictureOnPicture method returns, the repaint method is called to cause 
the new image to be rendered on the computer screen. 

The method named drawScaledPictureOnPicture 

The method named drawScaledPictureOnPicture is shown in its entirety in Listing 2 (p. 1845) . 
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Listing 2 . The method named drawScaledPictureOnPicture. 


private void drawScaledPictureOnPicture( 
Picture source, 
Picture dest, 
double scaleFactor) { 


transform = new AffineTransform() ; 


double translateX = dest.getWidth() /2 
- source. getWidth() *scaleFactor/100/2; 
double translateY = dest.getHeight () /2 
- source.getHeight () *scaleFactor/100/2; ; 
transform. translate(translateX,translateY) ; 
transform.scale(scaleFactor/100.0,scaleFactor/100.0); 


//Get the Graphics2D object used to draw on the 
// destination picture. 
g2 = (Graphics2D)dest.getGraphics() ; 


//Scale and draw the source image on the destination 
// image. 


g2.drawIlmage (source. getImage() ,transform,nul1); 


3//end drawScaledPictureOnPicture method 


Table 4.345 


Use an affine transform 

This method uses an affine transform to first translate and then scale the source picture and draws the 
scaled source picture onto the center of the destination picture. 

I have published numerous tutorials that explain the use of Affine transforms in Java, including Applying 
Affine Transforms to Picture Objects 15! . I won’t repeat those explanations in this module, but will simply 
refer you to the earlier tutorials. 

Keywords for a Google search 

You can find my other tutorials that explain Affine transforms by using Google to search for the following 

keywords: 


richard baldwin java affine transform 


4.4.2.2.4.6 Run the program 


I encourage you to copy the code from Listing 3 (p. 1847) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


4.4.2.2.4.7 Summary 


In this module, you learned how to use a slider to continuously change the size of an image and to draw the 
scaled image onto a background image. 
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4.4.2.2.4.8 What’s next? 


In the next module, you will learn how to use a JSlider object along with Affine Transforms to control the 
rotation of an image. 


4.4.2.2.4.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Controlling an Image-Scaling Program with a Slider 
e File: Java3118.htm 

e Published: 05/13/12 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.2.4.10 Complete program listing 


A complete listing of the program discussed in this module is shown in Listing 3 (p. 1847) below. 
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Listing 3 . Complete program listing. 


/*File Prob09 Copyright 2008 R.G.Baldwin 
Revised 09/13/10 


FE EEEE EEEE IO I IAAI IOI AI AI I I I I I I A E 21 2k EE 21 21 E 4 24 E EE EE 2 2 E / 
import java.awt.geom.AffineTransform; 
import java.awt.Graphics2D; 


import java.awt.Color; 

import java.awt.Graphics; 
import java.awt.Image; 

import java.awt.BorderLayout ; 


import javax.swing. JFrame; 

import javax.swing. JPanel; 

import javax.swing. JSlider; 

import javax.swing.JLabel; 

import javax.swing.event.ChangeListener ; 
import javax.swing.event.ChangeEvent; 


public class Prob09{ 

//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 

public static void main(String[] args){ 

new ProbO9Runner () ; 

}//end main method 
}//end class Prob09 
//End program specifications. 
TILTTLLTTTLTTTT LTT TL LTTT TTT TST TTT TAT TTT TAT TTT TTT TTT TT TT 
VILTLLLTLTTLTTTL LTT LLL TTTTTL TTT TTT ST TTT TTT T TTT TTT TTT 


TET ak 2k ək akak 3K >K 3K K 2K ək 3K K 2K >K 3K ək ÞK ÞK 3K K 2K 3K 3K ÞK 3K K ək ÞK 3K K ÞK ÞK FK K 2K 3K 2K ÞK 2K K ÞK ÞK FK K ÞK ÞK 2K ÞK ÞK 2K 2K K / 
class ProbO9Runner extends JFrame{ 


private JPanel mainPanel = new JPanel(); 
private JPanel titlePanel = new JPanel(); 
private JSlider slider = new JSlider(0,100,0); 


private Picture beach = new Picture("Prob09a. jpg"); 
private Picture butterfly = new Picture("Prob09b. jpg"); 


private int beachWidth = beach.getWidth(); 
private int beachHeight = beach.getHeight(); 


private Picture display = 
new Picture (beachWidth, beachHeight) ; 


private Image image = null; 
private Graphics graphics = null; 
private AffineTransform transform = 


null; 
private Graphic SH ee for epp! Connexions <hitp://cnx.org/content /col11441/1.181> 


public Prob09Runner () {//constructor 
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Table 4.346 
-end- 
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4.4.2.2.5 Java OOP: Controlling Image Rotation with a Slider and Affine Transforms 
4.4,2.2.5.1 Table of Contents 
e Preface (p. 1848) 


Viewing tip (p. 1848) 


x Figures (p. 1848) 
x Listings (p. 1848) 


Preview (p. 1849) 

Discussion and sample code (p. 1863) 
Run the program (p. 1870) 
Summary (p. 1870) 

What’s next? (p. 1870) 
Miscellaneous (p. 1870) 

Complete program listing (p. 1870) 


4.4.2.2.5.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 1°? . 


4.4.2.2.5.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.2.5.2.1.1 Figures 


e Figure 1 (p. 1853) . Program output at startup. 
e Figure 2 (p. 1858) . Program output for slider at zero. 
e Figure 3 (p. 1862) . Program output for slider at 240. 


4.4.2.2.5.2.1.2 Listings 


Listing 1 (p. 1864) . Beginning of the class named Prob10Runner. 

Listing 2 (p. 1865) . Beginning of the constructor for the Prob10Runner class. 
Listing 3 (p. 1866) . Construct the GUI for the slider. 

Listing 4 (p. 1866) . Rotate and display the butterfly. 

Listing 5 (p. 1867) . Register a ChangeListener on the slider. 

Listing 6 (p. 1868) . Beginning of the rotatePicture method. 

Listing 7 (p. 1868) . Set up the translation transform. 


152This content is available online at <http://cnx.org/content/m44915/1.4/>. 
153http://cnx.org/content /m44148/latest / 
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e Listing 8 (p. 1869) . Concatenate the transforms. 
e Listing 9 (p. 1869) . Transform and draw the butterfly image. 
e Listing 10 (p. 1871) . Complete program listing. 


4.4.2.2.5.3 Preview 


In this lecture, I will explain a program that uses Affine Transforms to rotate an image by a specified 
angle around a specified anchor point. 
Then the program translates the image so as to center it ina JFrame object. 
Specification of the rotation angle 
A JSlider is used to specify the rotation angle. 
The range of the slider is from 0 to 360 degrees. 
The position of the thumb on the slider specifies a counter-clockwise rotation angle in degrees. 
Program output at startup 
The thumb on the slider is at 45 degrees when the program starts running. 
This causes the initial rotation angle of the butterfly image to be 45 degrees counter-clockwise as shown 
in Figure 1 (p. 1853) . 
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Figure 1 . Program output at startup. 
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Corners barely graze inner-edges of the frame’s borders 

Note that for the initial rotation angle shown in Figure 1 (p. 1853) , the corners of the image almost 
touch the inner-edges of the borders on the frame. 

If you run the program and rotate the image, you will see that the size of the frame is such that the corners 
of the image barely graze the inner-edges for those cases where the diagonals of the image are horizontal and 
vertical. 

Program output for slider at zero degrees 

Figure 2 (p. 1858) shows the program output when the thumb on the slider has been moved to zero 

degrees at the far-left end of the slider. 
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Figure 2 . Program output for slider at zero. 


Table 4.348 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1854 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Program output for slider at 240 degrees 
Figure 3 (p. 1862) shows the result of positioning the thumb on the slider at 240 degrees. 


EX 


Rotation Angle in Degrees 
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Figure 3 . Program output for slider at 240. 


None 
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Brief program specifications 

Write a program named Prob10 that uses the Prob10 class definition shown in Listing 10 (p. 1871) 
and Ericson’s media library along with the image file named Prob10.jpg 154 to produce the graphic output 
images shown in Figure 1 (p. 1853) through Figure 3 (p. 1862) . 

The butterfly image rotates smoothly around its center as you move the slider back and forth. 

The program must terminate and return control to the operating system when you click the large X in 
the upper-right corner of the GUI containing the slider. 

General background information 

The overall structure of this program is very similar to programs that I explained in earlier lectures titled 


e Controlling an Edge Detector with a Slider 155 , and 
e Controlling an Image-Scaling Program with a Slider 158 . 


The most significant difference... 

Is the code that is executed when the slider fires a ChangeEvent . There are a few other differences 
as well. 

New and different code 

I will explain the code that is new and different in this program. 

I will refer you back to the earlier lectures for an explanation of the remainder of the code. 

You can view the entire program in Listing 10 (p. 1871) . 


4.4.2.2.5.4 Discussion and sample code 


Beginning of the class named Prob10Runner 

The code in the main method in Listing 10 (p. 1871) instantiates a new object of the class named 
Prob10Runner . 

Listing 1 (p. 1864) shows the beginning of the class named Prob10Runner . 

Listing 1 (p. 1864) declares several instance variables and initializes some of them. 

I will refer back to some of these variables in later paragraphs. 


154http://cnx.org/content /m44915 /latest /Prob10.jpg 
155http://cnx.org/content /m44913/latest 
156http://cnx.org/content /m44914 /latest 
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Listing 1 


. Beginning of the class named Prob10Runner. 


class 


private 
private 


Probi0Runner extends JFrame{ 


JPanel mainPanel = new JPanel(); 
JPanel titlePanel = new JPanel(); 


//Instantiate a new slider setting the limits and the 
// initial position of the thumb. 


private 


private 
private 


private 
private 


private 
private 
private 


private 
private 
private 
private 
private 


JSlider slider = new JSlider(0,360,45) ; 


Picture butterfly = new Picture("Prob10.jpg"); 
Picture background = null; 


int butterflyWidth = butterfly.getWidthQ); 
int butterflyHeight = butterfly.getHeight () ;s 


Picture display = null; 
int displayWidth = 0; 
int displayHeight = 0; 


Image image = null; 

Graphics graphics = null; 

AffineTransform rotateTransform = null; 
AffineTransform translateTransform = null; 
Graphics2D g2 = null; 


Beginning of the constructor for the Prob10Runner class 
Listing 2 (p. 1865) shows the beginning of the constructor for the class named 


Table 4.350 
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Listing 2 . Beginning of the constructor for the Prob10Runner class. 


public Prob10Runner (){//constructor 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 


//Compute the minimum dimensions allowed for the 

// display window that will contain the butterfly 

// image rotated at any angle. This turns out to 

// be a square with the length of each side equal 

// to the diagonal length of the butterfly picture. 

//The length of each side was increased by one 

// pixel to guard against loss of precision when 

// converting from double to int. 

int diagonal = 1 + (int) (Math.sqrt( 
butterflyWidth*butterflyWidth + 
butterflyHeight*butterflyHeight) ) ; 


//Instantiate the picture in which the rotated 
// butterfly image will be displayed. 

display = new Picture(diagonal,diagonal) ; 
displayWidth = displayHeight = diagonal; 


//This picture provides a white background the same 
// size as the display picture. 
background = new Picture(diagonal, diagonal) ; 


Table 4.351 


Not much that is new here 

The only thing that might be considered new in Listing 2 (p. 1864) is the code that computes the 
minimum dimensions for a display window that will contain the butterfly image rotated by any angle. 

The rationale for this computation is explained in the comments. 

Construct the GUI for the slider 

The code in Listing 3 (p. 1866) constructs the GUI that contains the slider shown in Figure 1 (p. 1853) . 

Although the code in Listing 3 (p. 1866) is a little tedious, there are no new concepts associated with 
that code. 
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Listing 3 . Construct the GUI for the slider. 


//Construct the GUI for the slider. 
slider .setMajorTickSpacing (60) ; 
slider .setMinorTickSpacing(15) ; 
slider.setPaintTicks (true); 
slider.setPaintLabels (true); 


mainPanel.setLayout (new BorderLayout ()); 
titlePanel.add(new JLabel ( 

"Rotation Angle in Degrees")) ; 
mainPanel.add(titlePanel , BorderLayout .NORTH) ; 
mainPanel.add(slider,BorderLayout .CENTER) ; 


getContentPane() .add(mainPanel1) ; 
pack();//Adjust the size of the slider GUI. 


//Compute an improved size and location for the 
// GUI containing the slider. 
setSize(displayWidth + 2 * getInsets().left, 
mainPanel.getHeight() + slider.getHeight()); 
setLocation(0,displayHeight + getInsets() .top 
+ getInsets().bottom + 1); 
setVisible(true) ; 


Table 4.352 


Rotate and display the butterfly 

The code in Listing 4 (p. 1866) calls the method named rotatePicture , passing the initial value of 
the thumb on the slider as a parameter to cause the initial display of the butterfly to be properly rotated. 

Then Listing 4 (p. 1866) calls the show method on the display to cause the rotated butterfly image to 
be displayed as shown in Figure 1 (p. 1853) . 


Listing 4 . Rotate and display the butterfly. 


rotatePicture(slider.getValue()); 


display.show(; 


Table 4.353 


Register a ChangeListener on the slider 
The code in Listing 5 (p. 1867) registers an anonymous ChangeListener object on the slider. 
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Listing 5 . Register a ChangeListener on the slider. 


slider .addChangeListener ( 
new ChangeListener () { 

public void stateChanged(ChangeEvent e){ 
//Restore the background image of the display 
// to all white. 
graphics = display.getGraphics(); 
graphics. drawImage ( 

background. get Image() ,0,0,nul11); 


//Rotate the butterfly image, draw it on the 
// display, and repaint the display on the 
// screen.. 
rotatePicture(slider.getValue()); 
display.repaint(); 

}//end stateChanged 

}//end new ChangeListener 
);//end addChangeListener 


}//end constructor 


Table 4.354 


Each time the slider fires a ChangeEvent , the stateChanged method in Listing 5 (p. 1867) is 
executed. 

The stateChanged method begins by restoring the background image of thedisplay. 

Then the stateChanged method calls the rotatePicture method to draw a rotated version of 
thebutterfly on top of the background image using theslider value, (which ranges from 0 to +360) , asthe 
rotation angle in degrees. 

The image of thebutterfly (see Figure 1 (p. 1853) ) is always centered in the displaypicture. 

Finally, the stateChanged method causes the display to be repainted to force the rotated image to 
appear on the screen. 

End of the constructor 

Listing 5 (p. 1867) signals the end of the constructor for the class named Prob10Runner 
Beginning of the rotatePicture method 

The rotatePicture method begins in Listing 6 (p. 1868) . 
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Listing 6 . Beginning of the rotatePicture method. 


private void rotatePicture(double angle){ 


//Set up the rotation transform 

rotateTransform = new AffineTransform() ; 

//Negate the angle for counter-clockwise rotation. 

rotateTransform.rotate(-Math.toRadians (angle), 
butterflyWidth/2, 
butterflyHeight/2) ; 


Table 4.355 


The rotatePicture method accepts a rotation angle in degrees as an incoming parameter. 
The rotatePicture method 


e rotates a butterfly image by that angle around its center, 
e translates the rotated image, and 
e draws the rotated image in the center of a display picture. 


Set up the rotation transform 
Listing 6 (p. 1868) begins by instantiating a new object of the AffineTransform class. 
Then it calls the rotate method on the transform object to configure that object for use in rotating 
the image of the butterfly. 
Overloaded versions of the rotate method 
There are several overloaded versions of the rotate method. 
The version called in Listing 6 (p. 1868) requires three parameters: 


e The rotation angle in radians 
e The X coordinate of the anchor point (point around which the rotation will take place) . 
e The Y coordinate of the anchor point. 


A positive rotation value indicates a clockwise rotation. 
Convert from degrees to radians 
Listing 6 (p. 1868) converts the incoming angle in degrees to radians 
The code in Listing 6 (p. 1868) applies a minus sign to convert the angle from a positive value to a 
negative value for counter-clockwise rotation, and passes that value as the rotation parameter. 
Specify the rotation anchor point 
Listing 6 (p. 1868) also specifies the center of the butterfly image as the anchor point. 
Set up the translation transform 
Listing 7 (p. 1868) sets up the translation transform that will be used to translate the rotated image to 
the center of the new Picture object. 


Listing 7 . Set up the translation transform. 


continued on next page 
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translateTransform = new AffineTransform(); 
translateTransform. translate ( 
(displayWidth - butterflyWidth)/2, 
(displayHeight - butterflyHeight) /2); 


Table 4.356 


Listing 7 (p. 1868) instantiates a new AffineTransform object. 

Then it calls the translate method to configure that object for use in translating (moving) the rotated 
image of the butterfly. 

The translation transform object will be concatenated with the rotation object from Listing 6 (p. 1868) 
to produce an AffineTransform object that can rotate and translate „in that order. 

Concatenate the transforms 

Listing 8 (p. 1869) concatenates the AffineTransform object referred to by translateTransform 
with the transform object referred to by rotateTransform 


Listing 8 . Concatenate the transforms. 


translateTransform. concatenate (rotateTransform) ; 


Table 4.357 


The resulting composite transform 

The concatenation in Listing 8 (p. 1869) results in an Affine Transform object referred to by 
translateTransform that will first rotate the image around its center and then translate the rotated image 
to the center of the new Picture object. 

The order of operations is very important 

When rotating and translating images, it is important that the two operations be performed in the correct 
order. 

Otherwise, the results might not be what you want. 

Transform and draw the butterfly 

Listing 9 (p. 1869) applies the composite transform to the butterfly image and draws the transformed 
image on the output picture as shown in Figure 1 (p. 1853) , Figure 2 (p. 1858) , and Figure 3 (p. 1862) . 


Listing 9 . Transform and draw the butterfly image. 


Graphics2D g2 = (Graphics2D)display.getGraphics() ; 
g2.drawImage (butterfly.getImage(), 
translateTransform, 
null); 


}//end rotatePicture 


}//end class Probi0Runner 
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Table 4.358 


The end of the program 
Listing 9 (p. 1869) also signals the end of the rotatePicture method, the end of the Prob10Runner 
class, and the end of the program. 


4.4.2.2.5.5 Run the program 


I encourage you to copy the code from Listing 10 (p. 1871) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


4.4.2.2.5.6 Summary 


In this lecture, you learned how to use a JSlider object along with Affine Transforms to control the 
rotation of an image. 


4.4.2.2.5.7 What’s next? 


In the next module, you will learn how to open an image file (specified by a string in a text field) in a 
PictureExplorer object. 


4.4.2.2.5.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Controlling Image Rotation with a Slider and Affine Transforms 
e File: Java3120.htm 

e Published: 09/07/12 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.2.5.9 Complete program listing 


A complete listing of the program discussed in this lecture is shown in Listing 10 (p. 1871) below. 
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Listing 10 . Complete program listing. 


/*File Prob10 Copyright 2008 R.G.Baldwin 
Revised 09/14/10 


FE AG EEE EEEE EEE EEEE AI I IC I I EE 21 21 E E 21 21 E 4 2 E EE 4 2k 2 2 E / 
import java.awt.geom.AffineTransform; 
import java.awt.Graphics2D; 


import java.awt.Color; 

import java.awt.Graphics; 
import java.awt.Image; 

import java.awt.BorderLayout ; 


import javax.swing. JFrame; 

import javax.swing. JPanel; 

import javax.swing. JSlider; 

import javax.swing.JLabel; 

import javax.swing.event.ChangeListener ; 
import javax.swing.event.ChangeEvent; 


public class Prob10{ 
public static void main(String[] args){ 
new Probi0Runner () ; 
}//end main method 
}//end class Prob10 
DOB COCO OOO OSORIO RISA SOCIO III I I I II I I I ISI A ak kf ak ak ak ka 4 / 


class Probi0Runner extends JFrame{ 


private JPanel mainPanel = new JPanel(); 
private JPanel titlePanel = new JPanel(); 


//Instantiate a new slider setting the limits and the 
// initial position of the thumb. 
private JSlider slider = new JSlider (0,360, 45); 


private Picture butterfly = new Picture("Prob10.jpg"); 
private Picture background = null; 


private int butterflyWidth = butterfly.getWidthQ); 
private int butterflyHeight = butterfly. getHeight () ; 


private Picture display = null; 
private int displayWidth = 0; 
private int displayHeight = 0; 


private Image image = null; 
private Graphics graphics = null; 
private AffineTransform rotateTransform = null; 
private AffineTransform translateTransform = null; 
private Graphics2p g? = null; F , 
vailaBle for free at Connexions <http://cnx.org/content/col11441/1.181> 


public Prob10Runner () {//constructor 


setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
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-end- 


4.4.2.3 Part 3 
4.4.2.3.1 Java OOP: Opening an Image File in a PictureExplorer Object 
4.4.2.3.1.1 Table of Contents 

e Preface (p. 1872) 


Viewing tip (p. 1872) 


x Figures (p. 1872) 
x Listings (p. 1872) 


Preview (p. 1873) 

Complete program listing (p. 1877) 

Will explain the code in fragments (p. 1880) 
Run the program (p. 1882) 

What’s next? (p. 1882) 

Miscellaneous (p. 1883) 


4.4.2.3.1.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 158 . 


4.4.2.3.1.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.3.1.2.1.1 Figures 


e Figure 1 (p. 1873) . Program output at startup. 
e Figure 2 (p. 1877) . Screen shot after the image is loaded. 


4.4.2.3.1.2.1.2 Listings 


e Listing 1 (p. 1879) . Complete program listing. 

e Listing 2 (p. 1880) . The driver class. 

e Listing 3 (p. 1880) . Beginning of the Prob11 Runner class. 

e Listing 4 (p. 1881) . Beginning of the constructor. 

e Listing 5 (p. 1881) . Beginning of anonymous listener class. 

e Listing 6 (p. 1882) . Completion of the anonymous listener class. 


157This content is available online at <http://cnx.org/content /m44916/1.3/>. 
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4.4.2.3.1.3 Preview 


This program demonstrates how to specify an image file in a text field, and open the image in a new 
PictureExplorer object. 

Program output at startup 

Figure 1 (p. 1873) shows the program output at startup. 
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File name: |Probiidajpo | 
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Figure 1 . Program output at startup. 
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Pre-loaded image file name 

For convenience, the text field is pre-loaded with the name of an image file that is located in the current 
directory. 

Press Enter to load the image 

Pressing the Enter key while the text field has the focus will cause the image to be loaded into a 
PictureExplorer object, and will cause the PictureExplorer object to be displayed as shown in Figure 


2 (p. 1877) . 
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Dick Baldwin 
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Figure 2 . Screen shot after the image is loaded. 
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Control panel is relocated 

Note in Figure 2 (p. 1877) that the control panel containing the text field has been automatically 
relocated to a position immediately below the PictureExplorer object. 

Another image file in the current directory 

Entering the path and name of any jpeg file will cause that file to be loaded into anew PictureExplorer 
object. 


4.4.2.3.1.4 Complete program listing 


A complete listing of the program discussed in this lecture is shown in Listing 1 (p. 1879) below. 
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Listing 1 . Complete program listing. 


/*File Prob11 Copyright 2012 R.G.Baldwin 
The purpose of this program is to demonstrate the use of 
a JTextField object to specify the name of an image file, 
which is then loaded and displayed in a PictureExplorer 
object. 


The text field is pre-loaded with the name of an image 
file that is in the current directory (Probila. jpg). 


An image file named Probiib.jpg is also in the current 
directory and can be loaded and displayed by entering 
the name in the text field. 


Any image file on the disk can be loaded and displayed 
by entering the path and name of the image file. 
FEA EEE EEEE EEE EE EEEE EEE I I A 1 21 2k E E 21 21 24 4 2 E 2 ff 2k 2 2  / 


import javax.swing. JFrame; 

import javax.swing. JPanel; 

import javax.swing.JTextField; 

import javax.swing.JLabel; 

import java.awt.event.ActionEvent; 
import java.awt.event.ActionListener; 
import javax.swing.WindowConstants; 


public class Probii{ 
public static void main(String[] args){ 
new ProbiiRunner () ; 
}//end main method 
}//end class Probi1 


class ProbiiRunner extends JFrame{ 
private ProbiiRunner jFrameObj = null; 
private PictureExplorer explorer = null; 
private Picture pix; 


private JPanel fileNamePanel = new JPanel(); 
private JTextField inputFileNameField = 
new JTextField("Probliia. jpg", 20) ; 


private String fileName = "no file specified"; 


public Prob11Runner () {//constructor 
fileNamePanel.add(new JLabel("File name: ")); 
fileNamePanel .add(inputFileNameField) ; 


//Add the fileNamePanel to the content pane, adjust 

// to the Barer! size, and set the title, i 
getContentPang a able | PE tee gt Cs peas <http://cnx.org/content /col11441/1.181> 
pack(); 

setTitle("Dick Baldwin"); 
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4.4.2.3.1.5 Will explain the code in fragments 


As usual, I will break the code down, and explain it in fragments. 
The driver class 
The driver class is shown in Listing 2 (p. 1880) . 
There is nothing new in Listing 2 (p. 1880) . 


Listing 2 . The driver class. 


public class Prob11{ 
public static void main(String[] args){ 
new ProbiiRunner () ; 
}//end main method 
}//end class Probi1 


Table 4.363 


Beginning of the Prob11Runner class 

The Prob11Runner class begins in Listing 3 (p. 1880) . 

Listing 3 (p. 1880) declares several instance variables that will be used later in the program, initializing 
some of them. 

Note that the class extends JFrame , so an object of the class "isa" JFrame object. 


Listing 3 . Beginning of the Prob11Runner class. 


class ProbiiRunner extends JFrame{ 
private ProbiiRunner jFrameObj = null; 
private PictureExplorer explorer = null; 
private Picture pix; 


private JPanel fileNamePanel = new JPanel(); 
private JTextField inputFileNameField = 
new JTextField("Probiia. jpg", 20) ; 


private String fileName = "no file specified"; 


Table 4.364 


Beginning of the constructor 
The constructor for the Prob11Runner class begins in Listing 4 (p. 1881) . 
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The code in Listing 4 (p. 1881) performs the physical construction of the GUI show in Figure 1 (p. 1873) 


The code in Listing 4 (p. 1881) saves a reference to the object so that it can be accessed later from within 
a listener object. 


Listing 4 . Beginning of the constructor. 


public Prob11Runner(){//constructor 
fileNamePanel.add(new JLabel("File name: ")); 
fileNamePanel .add(inputFileNameField) ; 


//Add the fileNamePanel to the content pane, adjust 
// to the correct size, and set the title. 
getContentPane() .add(fileNamePanel) ; 

pack(); 

setTitle("Dick Baldwin"); 


//Make the GUI visible, set the focus, and establish 
// a reference to the GUI object. 

setVisible(true) ; 

inputFileNameField.requestFocus() ; 

jFrameObj = this; 


Table 4.365 


Register a listener on the text field 
Listing 5 (p. 1881) shows the beginning of code that instantiates an ActionListener object of an 
anonymous listener class, and registers the listener object on the text field shown in Figure 1 (p. 1873) . 


Listing 5 . Beginning of anonymous listener class. 


inputFileNameField.addActionListener ( 
new ActionListener (){ 
public void actionPerformed(ActionEvent e){ 
fileName = inputFileNameField.getText() ; 


pix = new Picture(fileName) ; 
pix.addMessage("Dick Baldwin",10,20); 


explorer = new PictureExplorer (pix); 


Table 4.366 
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Get image and create Picture object 

Listing 5 (p. 1881) begins by getting the name of the image file from the text field, using that image file 
to create anew Picture object, and adding a name in the upper-left corner of the picture. 

Create new PictureExplorer object 

Then Listing 5 (p. 1881) instantiates a new PictureExplorer object that encapsulates the Picture 
object that was created from the image file. 

Completion of the anonymous listener class 

Listing 6 (p. 1882) shows the completion of the anonymous listener class, as well as the end of the 
constructor, and the end of the class named Prob11Runner 


Listing 6 . Completion of the anonymous listener class. 


setLocation(0,pix.getHeight() + 128); 


jFrame0bj . setDefaultClose0peration( 
WindowConstants.EXIT_ON_CLOSE) ; 
}//end action performed 
}//end newActionListener 
);//end addActionListener 


}//end class ProbiiRunner 


Table 4.367 


Relocate the GUI 

Listing 6 (p. 1882) begins by setting the location of the GUI to a location that is immediately below the 
PictureExplorer object. 

Relocate the GUI (cont’d) 

Note that the value of 128 pixels was experimentally determined to be the approximate difference between 
the height of the PictureExplorer object and the height of the Picture object that it encapsulates. 

(This difference may not be correct for different display options on different operating systems.) 

Set the default close operation 

Listing 6 (p. 1882) ends by setting the behavior of the X-button in the GUI to a value that will cause it 
to terminate the program when the button is clicked. 


4.4.2.3.1.6 Run the program 


I encourage you to copy the code from Listing 1 (p. 1879) and download the image file named Prob11la.jpg 
159 . Compile the code and execute it. Experiment with the code, making changes, and observing the results 
of your changes. Make certain that you can explain why your changes behave as they do. 


4.4.2.3.1.7 What’s next? 


In the next module, you will learn how to extract color data from a selected pixel in a PictureExplorer 
object, and how to display a color value in a text field. You will also learn how to disable the X-button in 
the PictureExplorer object, and how to use a reference to the JFrame object that serves as a container 
for the PictureExplorer object. 


159http://cnx.org/content /m44916/latest /Problla.jpg 
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4.4.2.3.1.8 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Opening an Image File in a PictureExplorer Object 
e File: Java3122.htm 

e Published: 09/08/12 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 

I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 

In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


4.4.2.3.2 Java OOP: Extracting pixel color data from a PictureExplorer object” 
4.4.2.3.2.1 Table of Contents 
e Preface (p. 1883) 
Viewing tip (p. 1884) 
x Figures (p. 1884) 
x Listings (p. 1884) 


Preview (p. 1884) 

Discussion and sample code (p. 1893) 
Run the program (p. 1897) 
Summary (p. 1897) 

What’s next? (p. 1897) 
Miscellaneous (p. 1897) 

Complete program listings (p. 1898) 


4.4.2.3.2.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 161 . 


160This content is available online at <http://cnx.org/content/m44917/1.3/>. 
161http://cnx.org/content /m44148/latest / 
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4.4.2.3.2.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.3.2.2.1.1 Figures 


e Figure 1 (p. 1888) . Program output at startup. 
e Figure 2 (p. 1892) . Program output after clicking the button. 


4.4.2.3.2.2.1.2 Listings 


e Listing 1 (p. 1893) . Addition of getter methods. 

e Listing 2 (p. 1894) . Disabled the call to setDefaultCloseOperation method. 
e Listing 3 (p. 1894) . The driver class for Prob12. 

e Listing 4 (p. 1894) . Beginning of the class named Prob12Runner. 

e Listing 5 (p. 1895) . Beginning of the constructor. 

e Listing 6 (p. 1895) . Construct a Picture object. 

e Listing 7 (p. 1896) . Construct a PictureExplorer object. 

e Listing 8 (p. 1896) . Set the size and location of the GUI control panel. 
e Listing 9 (p. 1897) . Register a listener object on the button. 

e 

e 


P 
Listing 10 (p. 1899) . Prob12.java. 
Listing 11 (p. 1901) . Modified PictureExplorer.java. 


4.4.2.3.2.3 Preview 


In this module, I will show you how to extract color data from a selected pixel in a PictureExplorer 
object, and how to display the value in a text field. 

I will also show you how to disable the X-button in the PictureExplorer object, and how to get 
and use a reference to the JFrame object that serves as a container for the PictureExplorer object. 

Program output at startup 

Figure 1 (p. 1888) shows a screen shot of the program output at startup. 

Note that the text field in the red panel near the bottom contains all zeros. 
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Figure 1 . Program output at startup. 
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Table 4.368 


Program output after clicking the button 

Figure 2 (p. 1892) shows the screen output after moving the PictureExplorer crosshair cursor to the 
brown door immediately above the penguin, and clicking the button labeled "Get and Display Red Color 
Value." 
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Figure 2 . Program output after clicking the button. 
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Table 4.369 
The red color value 


The text field near the bottom of Figure 2 (p. 1892) displays the red color value of the pixel at the 
location of the crosshair cursor on the door in the image. 
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Compare this value with the value of the red color value displayed near the top of the PictureExplorer 
object. You will see that they match. 


4.4.2.3.2.4 Discussion and sample code 


Two source code files are required for this program: 


e The file named Prob12.java 
e A modified version of Ericson’s file named PictureExplorer.java 


A complete listing of Prob12.java is shown in Listing 10 (p. 1899) . 
A complete listing of the modified PictureExplorer.java file is shown in Listing 11 (p. 1901) . 
Modifications to PictureExplorer.java 
The modifications that I made can be found by searching the source code in Listing 11 (p. 1901) for the 
word "Baldwin". 
The modifications were: 


e JT added a getter method to cause the red color value to be accessible from outside the PictureEx- 
plorer object. 

e JT added a getter method that returns a reference to the JFrame object containing the Picture- 
Explorer object. 

e I disabled the call to the setDefaultCloseOperation method for the PictureExplorer object. 


Addition of getter methods 
The code for the each of the new getter methods is shown in Listing 1 (p. 1893) . 
These two methods simply return values that already exist in the PictureExplorer object. 


Listing 1 . Addition of getter methods. 


//===Methods added by Baldwin on 05/15/12===============// 
//Method to get the red color value as text. 
public String getRValue(){ 

return rValue.getText (); 
}//end getRValue 


//Method to get a reference to the JFrame containing 
// the PictureExplorer object. 
public JFrame getFrame(){ 
return pictureFrame; 
}//end getFrame() 
//===End methods added by Baldwin on 05/15/12===========// 


Table 4.370 


Disabled the call to setDefaultCloseOperation method 

Comment indicators were used to disable the call to the setDefaultCloseOperation method as shown 
in Listing 2 (p. 1894) . 

This code was replaced by code that you will see later that causes the JFrame to do nothing when 
the X-button on the PictureExplorer object is clicked. 
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Listing 2 . Disabled the call to setDefault CloseOperation method. 


/*Disabled by Baldwin on 5/15/12 
pictureFrame.setDefaultCloseOperation( 
JFrame .DISPOSE_ON_CLOSE) ; 
*/ 


Table 4.371 


No more modifications 

That concludes the discussion of modifications to Ericson’s PictureExplorer source code. 
The driver class named Prob12 

The driver class is shown in Listing 3 (p. 1894) . 

There is nothing new here. 


Listing 3 . The driver class for Prob12. 


public class Prob12{ 
public static void main(String[] args){ 
new Prob12Runner(); 
}//end main method 
}//end class Prob12 


Table 4.372 


Beginning of the class named Prob12Runner 
The class named Prob12Runner begins in Listing 4 (p. 1894) . 


The code in Listing 4 (p. 1894) declares several instance variables and initializes some of them. 


Listing 4 . Beginning of the class named Prob12Runner. 


class Probi2Runner extends JFrame{ 
private JFrame explorerFrame = null; 
private PictureExplorer explorer = null; 
private Picture pix; 


private JPanel controlPanel = new JPanel(); 
private JPanel colorPanel = new JPanel(); 
private JPanel buttonPanel = new JPanel(); 


private JTextField redField = new JTextField("000000") ; 
private JButton getDataButton = new JButton( 


"Get and Display Red Color Value"); 
private String fileName = "Prob1i2.jpg"; 
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Table 4.373 


Beginning of the constructor 

The constructor for the class named Prob12Runner begins in Listing 5 (p. 1895) . 

The code in Listing 5 (p. 1895) performs the physical construction of the GUI control panel at the 
bottom of Figure 1 (p. 1888) . 

The final position of the GUI control panel will be established after the size of the PictureExplorer 
objects JFrame is known. 


Listing 5 . Beginning of the constructor. 


controlPanel.setLayout (new GridLayout(2,1)); 
controlPanel .add(colorPanel) ; 
controlPanel .add(buttonPanel) ; 


colorPanel .setBackground (Color. RED) ; 
colorPanel.add(new JLabel ( 

"Red pixel Color at Cursor: ")); 
colorPanel .add(redField) ; 


buttonPanel . setBackground (Color .BLUE) ; 
buttonPanel .add(getDataButton) ; 


getContentPane() .add(controlPanel) ; 
setTitle("Dick Baldwin"); 


setVisible(true) ; 


Table 4.374 


Construct a Picture object 
Listing 6 (p. 1895) creates anew Picture object, and adds a name to the picture before using it to 
construct a PictureExplorer object. 


Listing 6 . Construct a Picture object. 


pix = new Picture(fileName) ; 
pix.addMessage("Dick Baldwin",10,20) ; 


Table 4.375 


Construct a PictureExplorer object 

Listing 7 (p. 1896) begins by constructing a new PictureExplorer object that encapsulates the 
Picture object instantiated in Listing 6 (p. 1895) , and by saving a reference to the PictureExplorer 
object in the instance variable named explorer 
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Listing 7 . Construct a PictureExplorer object. 


explorer = new PictureExplorer (pix) ; 
explorerFrame = explorer.getFrame() ; 


explorerFrame. setDefaultClose0peration( 
WindowConstants.DO_NOTHING_ON_CLOSE) ; 


Table 4.376 


Get and use a reference to the JFrame object 

Then Listing 7 (p. 1896) calls the PictureExplorer object’s new getFrame method to get a 
reference to the JFrame object that contains the PictureExplorer 

This reference is used in Listing 7 (p. 1896) to call the setDefaultCloseOperation method to cause 
the JFrame to do nothing when the X-button on the JFrame is clicked. 

The reference is also used in Listing 8 (p. 1896) to establish the size and location of the GUI control 
panel. 

Set the size and location of the GUI control panel 

Now that the PictureExplorer object exists, Listing 8 (p. 1896) sets the size and location of the GUI 
control panel as shown in Figure 1 (p. 1888) . 


Listing 8 . Set the size and location of the GUI control panel. 


//Set the size of the control GUI. 
setSize(explorerFrame.getWidth() ,110); 


//Set the location for the control GUI 
setLocation(0,explorerFrame.getHeight ()); 


//Set the default close operation for the control GUI. 
setDefaultCloseOperation( 
WindowConstants.EXIT_ON_CLOSE) ; 


Table 4.377 


Note that it isn’t necessary to guess about the actual height of the JFrame as was the case in an earlier 
module. The reference to the JFrame object provides that information. 

Set the default close operation for the control GUI 

Finally, Listing 8 (p. 1896) sets the default close operation on the control GUI to cause the program to 
terminate when the user clicks the X-button on the GUI. 

Register a listener object on the button 

Listing 9 (p. 1897) registers an ActionListener object on the button to cause it to call the Pic- 
tureExplorer object’s new getRValue method to get the red color value for the pixel at the current 
PictureExplorer crosshair cursor position, and to display that value in the text field as shown in Figure 
2 (p. 1892) when the user clicks the button. 
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Listing 9 . Register a listener object on the button. 


getDataButton.addActionListener ( 
new ActionListener (){ 
public void actionPerformed(ActionEvent e){ 


redField.setText (explorer. getRValue()); 
}//end action performed 


}//end newActionListener 
);//end addActionListener 


}//end constructor 
}//end class Probi2Runner 


Table 4.378 


End of the program 
Listing 9 (p. 1897) also signals the end of the constructor and the end of the class named Prob12Runner 


4.4.2.3.2.5 Run the program 


I encourage you to copy the code from Listing 10 (p. 1899) and Listing 11 (p. 1901) and download the image 
file named Prob12.jpg 16? . Compile the code and execute it. Experiment with the code, making changes, 
and observing the results of your changes. Make certain that you can explain why your changes behave as 
they do. 


4.4.2.3.2.6 Summary 


You learned how to extract color data from a selected pixel in a PictureExplorer object, and to display 
the value in a text field. 

You also learned how to disable the X-button in the PictureExplorer object, and how to use a 
reference to the JFrame object that serves as a container for the PictureExplorer object. 
4.4.2.3.2.7 What’s next? 
In the next module, you will learn how to handle document events on text fields containing color values. 
You will also learn how to create a color swatch. 


4.4.2.3.2.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Extracting pixel color data from a PictureExplorer object 
e File: Java3124.htm 


162http://cnx.org/content /m44917 /latest /Prob12.jpg 
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e Published: 09/08/12 
e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.3.2.9 Complete program listings 


Complete listings of the source code discussed in this module are shown in Listing 10 (p. 1899) and Listing 
11 (p. 1901) below. 
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Listing 10 . Prob12.java. 


/*File Prob12 Copyright 2012 R.G.Baldwin 
The purpose of this program is to demonstrate how to get 
a color value from a PictureExplorer object and to display 
it in JTextField object. 


It also demonstrates how to access and use a reference 
to a JFrame object that serves as the container for a 
PictureExplorer object. 


Finally, it demonstrates how to disable the X-button in 
a PictureExplorer object. 


Note that this program requires access to a modified 
version of the PictureExplorier class. 
FE AO EEE EEEE EEE IGA ICI GI AI I A 1 1 2k E E 21 21 21 4 24 E a 4 2k 2 24 E / 


import javax.swing. JFrame; 

import javax.swing.JButton; 

import javax.swing. JPanel; 

import javax.swing.JTextField; 

import javax.swing.JLabel; 

import javax.swing.WindowConstants; 
import java.awt.event.ActionEvent; 
import java.awt.event.ActionListener; 
import java.awt.GridLayout ; 

import java.awt.Color; 


public class Prob1i2{ 
public static void main(String[] args){ 
new Probi2Runner () ; 
}//end main method 
}//end class Prob12 


class Probi2Runner extends JFramef{ 
private JFrame explorerFrame = null; 
private PictureExplorer explorer = null; 
private Picture pix; 


private JPanel controlPanel = new JPanel(); 
private JPanel colorPanel = new JPanel(); 
private JPanel buttonPanel = new JPanel(); 


private JTextField redField = new JTextField("000000") ; 


private JButton getDataButton = new JButton( 
"Get and Display Red Color Value"); 
private String fileName = "Prob1i2.jpg"; 


e eS Ae Oe SEs ea // 
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public Prob12Runner () {//constructor 


controlPanel.setLayout (new GridLayout(2,1)); 
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Table 4.379 
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Listing 11 . Modified PictureExplorer.java. 


import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 
import java.awt.image.*; 
import javax.swing. border. *; 


/* 

05/15/12 

Modified by Baldwin to add getter methods to cause 

the following values to be accessible from outside the 
PictureExplorer object: 


Red color value 


Reference to the JFrame containing the PictureExplorer 
object. 


Also disabled the call to setDefaultCloseOperation 


*/ 
/** 
* Displays a picture and lets you explore the picture by displaying the x, y, red, 
* green, and blue values of the pixel at the cursor when you click a mouse button or 
* press and hold a mouse button while moving the cursor. It also lets you zoom in or 
* out. You can also type in a x and y value to see the color at that location. 
* 
* Originally created for the Jython Environment for Students (JES). 
* Modified to work with DrJava by Barbara Ericson 
* 
* Copyright Georgia Institute of Technology 2004 
* @author Keith McDermottt, gte047w@cc.gatech.edu 
* @author Barb Ericson ericson@cc.gatech.edu 


*/ 
public class PictureExplorer implements MouseMotionListener, ActionListener, MouseListener 


{ 


// current x and y index 
private int xIndex = 0; 
private int yIndex = 0; 


//Main gui variables 

g 

private JFrame pictureFrame; 
private JScrollPane scrollPane; 


//information bar variables 
private JLabel xLabel; 
private JButton xPrevButton; 
private JButton yPrevButton; 
private JButton xNextButton; 
private JButton yNextButton; . 

private JLabel yeaa for free at Connexions <http://cnx.org/content/col11441/1.181> 
private JTextField xValue; 

private JTextField yValue; 


private JLabel rValue; 
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Table 4.380 
-end- 


4.4.2.3.3 Java OOP: Handling document events on a text field and creating a color swatch ”” 


4.4.2.3.3.1 Table of Contents 
e Preface (p. 1902) 


Viewing tip (p. 1902) 


x Figures (p. 1902) 
x Listings (p. 1902) 


Preview (p. 1903) 

Discussion and sample code (p. 1906) 
Run the program (p. 1913) 
Summary (p. 1913) 

What’s next? (p. 1913) 
Miscellaneous (p. 1913) 

Complete program listing (p. 1914) 


4.4.2.3.3.2 Preface 

This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

4.4.2.3.3.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.3.3.2.1.1 Figures 


e Figure 1 (p. 1904) . Program output at startup. 
e Figure 2 (p. 1905) . Program output after clicking the button. 
e Figure 3 (p. 1906) . Program output after entering color values. 


4.4.2.3.3.2.1.2 Listings 


e Listing 1 (p. 1906) . The driver class. 

e Listing 2 (p. 1907) . Beginning of the class named Prob13Runner. 

e Listing 3 (p. 1908) . Beginning of constructor for Prob13Runner. 

e Listing 4 (p. 1909) . Continue the constructor. 

e Listing 5 (p. 1910) . Register a listener object on the button. 

e Listing 6 (p. 1911) . Beginning of DocumentListener on Red text field. 
e Listing 7 (p. 1911) . The removeUpdate method. 

e Listing 8 (p. 1912) . The insertUpdate method. 

e Listing 9 (p. 1913) . The paintColorSwatch method. 

e Listing 10 (p. 1915) . Complete program listing. 
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4.4.2.3.3.3 Preview 


In this module, I will show you how to handle document events on text fields containing color values. 

Į will also show you how to create a color swatch that displays the color indicated by the color values in 
the Red, Green, and Blue text fields. 

Program output at startup 

Figure 1 (p. 1904) shows the program output at startup. 

Note that the color values in the Red, Green, and Blue text fields are all zero, the color of the square at 
the right end of the Green panel is black. 

Recall that black is represented by Red, Green, and Blue color values of zero. 


Dick Baldwin 


popp 000000 000000] 
Set Green Color 


Dick Baldwin -loj x! 


200000] 


Set Green Color 


O00 000| 
Set Green Color 
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Figure 1 . Program output at startup. 
Dick Baldwin 


000000 jo00000| 


Set Green Color 


Table 4.381 


Program output after clicking the button 
Figure 2 (p. 1905) shows the program output after clicking the button labeled "Set Green Color." 


25s | 


55 


Set Green Color 
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Figure 2 . Program output after clicking the button. 


Dick Baldwin 


255 


Set Green Color 


Table 4.382 


Note that in Figure 2 (p. 1905) , 


the color values in the Red and Blue text fields are zero, 

the color value in the Green text field is 255, 

the square (color swatch) at the right end of the green panel is green with a black outline 
the square is not transparent. 


Recall that pure green is represented by Red and Blue color values of zero, with a Green color value of 255. 
Program output after entering color values 
Figure 3 (p. 1906) shows the program output after manually entering a value of 255 in the Red text field. 
Note that 


e the color values in the Red and Green text fields are 255, 


e the color value in the Blue text field is 0, and 
e the square at the right end of the green panel is yellow with a black outline. 


Dick Baldwin 


= =n 


Set Green Color 
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255 | 
Set Green Color 


Figure 3 . Program output after entering color values. 


Dick Baldwin 
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Set Green Color 
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Recall that pure yellow is represented by Red and Green color values of 255, with a Blue color value of 
Zero. 

Color of square tracks color values in text fields 

The square (color swatch) always has a black outline as shown in Figure 3 (p. 1906) . 

The color in the swatch always tracks the color values in the text fields regardless of whether those values 
are changed manually, or they are changed by program code. 


4.4.2.3.3.4 Discussion and sample code 


A complete listing of the program discussed in this module is provided in Listing 10 (p. 1915) . 
Will explain in fragments 
I will break this program down and explain it in fragments. 
The driver class 
The driver class named Prob13 is shown in Listing 1 (p. 1906) . There is nothing new here. 


Listing 1 . The driver class. 


public class Prob1i3{ 
public static void main(String[] args){ 
new Probi3Runner () ; 
}//end main method 
}//end class Prob13 
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Table 4.384 


Beginning of the class named Prob13Runner 
The class named Prob13Runner begins in Listing 2 (p. 1907) , which declares several instance 
variables and initializes some of them. 


Listing 2 . Beginning of the class named Prob13Runner 


class Probi3Runner extends JFrame{ 


private JPanel controlPanel = new JPanel(); 
private JPanel colorPanel = new JPanel(); 

private JPanel buttonPanel = new JPanel(); 
private JPanel colorIndicatorPanel = new JPanel(); 


private JTextField redField = new JTextField("000000") ; 
private JTextField greenField = 

new JTextField("000000") ; 
private JTextField blueField = new JTextField("000000") ; 


private int redInt = 0; 
private int greenInt = 0; 
private int blueInt = 0; 


private JButton setColorButton = 
new JButton("Set Green Color"); 
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Beginning of constructor for Prob13Runner 

The constructor begins in Listing 3 (p. 1908) . The last two statements in Listing 3 (p. 1908) may be 
new to you. 

The JPanel referred to by colorIndicatorPanel is the color swatch shown in Figure 3 (p. 1906) . 

The last two statements in Listing 3 (p. 1908) control the border color, and the size of the JPanel 
(color swatch) object. 
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Listing 3 . Beginning of constructor for Prob13Runner. 


public Prob13Runner(){//constructor 


setDefaultCloseOperation( 
WindowConstants.EXIT_ON_CLOSE) ; 


controlPanel.setLayout (new GridLayout(2,1)); 
controlPanel .add(colorPanel) ; 
controlPanel .add(buttonPanel) ; 


colorPanel.setBackground (Color .GREEN) ; 
colorPanel.add(new JLabel("Red = ")); 
colorPanel .add(redField) ; 
colorPanel.add(new JLabel(" Green = ")); 
colorPanel .add(greenField) ; 
colorPanel.add(new JLabel(" Blue = ")); 
colorPanel.add(blueField) ; 
colorPanel.add(colorIndicatorPanel1) ; 


colorIndicatorPanel .setBorder ( 
new LineBorder(Color.black,1)); 
colorIndicatorPanel .setPreferredSize( 
new Dimension(20,20)); 
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The constructor continues in Listing 4 (p. 1909) . 

There is nothing new in Listing 4 (p. 1909) with the possible exception of the call to the method named 
paintColorSwatch 

I will explain the method named paintColorSwatch later. 
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Listing 4 . Continue the constructor. 


buttonPanel . setBackground (Color . BLUE) ; 
buttonPanel.add(setColorButton) ; 


//Color the swatch for the first time. 
paintColorSwatch() ; 


//Add the controlPanel to the content pane, adjust to 
// the correct size, and set the title. 
getContentPane() .add(controlPanel) ; 

pack(); 

setTitle("Dick Baldwin"); 


//Make the GUI visible 
setVisible(true) ; 
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Register listeners on the user input components 

This program registers event listener objects on four input components: 

One component is the button at the bottom of Figure 3 (p. 1906) labeled Set Green Color. 

The other three components are the three text fields labeled Red , and Blue shown in 
Figure 3 (p. 1906) . 

The three event listeners that are registered on the text fields are very similar. Therefore, I will explain 
only one of them. You can view the code for the other two in Listing 10 (p. 1915) . 

Register a listener object on the button 

Listing 5 (p. 1910) registers an ActionListener object on the JButton object referred to by setCol- 
orButton 

You have seen code like this in numerous previous modules. Therefore, a detailed explanation of Listing 
5 (p. 1910) should not be required here. 


, Green 
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Listing 5 . Register a listener object on the button. 


setColorButton. addActionListener ( 
new ActionListener () { 
public void actionPerformed(ActionEvent e){ 
//Set the color to green. 
redInt = 0; 
greenInt = 255; 
blueInt = 0; 


//Show the color values in the text fields. 
redField.setText("" + redInt); 
greenField.setText("" + greenInt) ; 
blueField.setText("" + blueInt) ; 


}//end action performed 
}//end new ActionListener 
);//end addActionListener 
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The DocumentListener interface 

The DocumentListener interface can be described briefly as follows: 

"Interface for an observer to register to receive notifications of changes to a text document." 

This interface is implemented by numerous classes including the JTextField class. As mentioned 
earlier, the Red , Green ,and Blue text fields in Figure 3 (p. 1906) are objects of the JTextField 
class and therefore implement the DocumentListener interface. 

DocumentListener methods 
The DocumentListener interface declares the follow three methods: 


e changedUpdate 

Gives notification that an attribute or set of attributes changed. 
e insertUpdate 

Gives notification that there was an insert into the document. 
e removeUpdate 


Gives notification that a portion of the document has been removed. 


Only the insertUpdate and removeUpdate methods are of interest in this program. Therefore, the 
changedUpdate method will be implemented as an empty method. 

Beginning of DocumentListener 

Listing 6 (p. 1911) shows the beginning of the definition, instantiation, and registration of a Docu- 
mentListener object on the object of type Document that is encapsulated in the Red text field. 
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Listing 6 . Beginning of DocumentListener on Red text field. 


redField.getDocument () .addDocumentListener ( 
new DocumentListener () { 


public void changedUpdate(DocumentEvent e){ 
//Empty method - not needed 
}//end changedUpdate 
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Note that registration of the listener object in this case has an additional level of indirection (getDocu- 
ment) as compared to the registration of the listener on the JButton in Listing 5 (p. 1910) . In other words, 
the listener is not registered on the text field. Instead, it is registered on the document encapsulated in the 
text field. 

This listener will respond when the contents of the text field are modified, either by the program, or by 
the user. 

(As explained earlier, the changedUpdate method is defined as an empty method.) 
The removeUpdate method 
Listing 7 (p. 1911) shows the removeUpdate method in its entirety. 


Listing 7 . The removeUpdate method. 


public void removeUpdate(DocumentEvent e){ 
try{ 
redInt = Integer.parseInt ( 
redField.getText()); 
if((redInt >= 0) && (redInt <= 255)){ 
paintColorSwatch(); 
}//end if 
}catch(Exception ex){ 
//do nothing on exception 
}//end catch 
}//end removeUpdate 
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Behavior of the removeUpdate method 

Listing 7 (p. 1911) calls the static parseInt method of the Integer class to convert the String 
contents of the Red text field into a value of type int 

The parseInt method can throw a NumberFormatException if the string does not contain a 
parsable integer. 

The possibility of a NumberFormatException , (which is a checked exception) requires that the 
call to the parseInt method be enclosed in a try-catch block. 

In this program, the catch block causes the removeUpdate method to do nothing if the 
contents of the text field cannot be converted into an int , which causes a NumberFormatException 
to be thrown 
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Ifa NumberFormatException exception is not thrown, the return value from the parseInt method 
is stored in an instance variable named redInt 

If the value of redInt is between 0 and 255 inclusive, Listing 7 (p. 1911) calls the method named 
paintColorSwatch , causing the color swatch to be repainted, using the Red value, along with the 
Green and Blue values computed elsewhere. 

The insert Update method 

The insertUpdate method is shown in Listing 8 (p. 1912) . 

The behavior of the insertUpdate method is essentially the same as the behavior of the remove- 
Update method explained earlier. Therefore, an explanation of the insertUpdate method should not 
be needed. 


Listing 8 . The insertUpdate method. 


public void insertUpdate(DocumentEvent e){ 
try{ 
redInt = Integer.parseInt ( 
redField.getText()); 
if((redInt >= 0) && (redInt <= 255)){ 
paintColorSwatch(); 
}//end if 
}catch(Exception ex){ 
//do nothing on exception 
}//end catch 
}//end insertUpdate 


}//end new DocumentListener 
);//end addDocumentListener 
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The end of the class definition 

Listing 8 (p. 1912) also signals the end of the anonymous class definition that began in Listing 6 (p. 
1911) . 

The Green and Blue text fields 

The Green and Blue text fields are processed using very similar DocumentListener objects as used 
for the Red text field. You can view that code in Listing 10 (p. 1915) . 

That ends the discussion of the constructor for the class named Prob13Runner 

The method named paintColorSwatch 

There were earlier references to a method named paintColorSwatch . The code for the paintCol- 
orSwatch method is shown in Listing 9 (p. 1913) . 


Listing 9 . The paintColorSwatch method. 


continued on next page 
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private void paintColorSwatch() { 
colorIndicatorPanel . setBackground ( 
new Color(redInt,greenInt,blueInt)) ; 
}//end paintColorSwatch 


}//end class Probi3Runner 
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The paintColorSwatch method sets the background color for the JPanel object that represents 
the color swatch, using values of red, green, and blue that are computed elsewhere in the program. 

The end of the program 

Listing 9 (p. 1913) also signals the end of the class named Prob13Runner and the end of the program. 


4.4.2.3.3.5 Run the program 


I encourage you to copy the code from Listing 10 (p. 1915) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


4.4.2.3.3.6 Summary 


In this lesson, you learned how to handle document events on text fields containing color values. You also 
learned how to create a color swatch. 


4.4.2.3.3.7 What’s next? 


In the next module, you will learn how to use a JColorChooser object to specify a color in any one of five 
different ways. 


4.4.2.3.3.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Handling document events on a text field and creating a color 
swatch 

e File: Java1326.htm 

e Published: 09/11/12 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 

Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.3.3.9 Complete program listing 


A complete listing of the source code discussed in this module is shown in Listing 10 (p. 1915) . 
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Listing 10 . Complete program listing. 


/*File Prob13 Copyright 2012 R.G.Baldwin 


This program handles document events on the contents of 
text fields containing color values. 


The values are used to create a color swatch that displays 
the color indicated by the color values in the red, green, 
and blue text fields. 

BEGG ak ak ak ak 2K I 3K ak aK I 3K 3K 3K 3K K I I I I I II I I I I 2K 3K a a a a ÞK ÞK ÞK ÞK ÞK 34 34 // 
import java.awt.event.ActionEvent; 

import java.awt.event.ActionListener; 

import javax.swing.JButton; 

import javax.swing. JFrame; 

import javax.swing. JPanel; 

import javax.swing. JTextField; 

import javax.swing.JLabel; 

import javax.swing.WindowConstants; 

import javax.swing.event.DocumentListener; 

import javax.swing.event .DocumentEvent ; 

import javax.swing.border.LineBorder; 

import java.awt.Color; 

import java.awt.GridLayout ; 

import java.awt.Dimension; 


public class Probi3{ 
public static void main(String[] args){ 
new Probi3Runner () ; 
}//end main method 
}//end class Prob13 


class Probi3Runner extends JFrame{ 


private JPanel controlPanel = new JPanel(); 
private JPanel colorPanel = new JPanel(); 

private JPanel buttonPanel = new JPanel(); 

private JPanel colorIndicatorPanel = new JPanel(); 


private JTextField redField = new JTextField("000000") ; 
private JTextField greenField = 

new JTextField("000000") ; 
private JTextField blueField = new JTextField("000000") ; 


private int redInt = 0; 
private int greenInt = 0; 
private int blueInt = 0; 


private JButton setColorButton = 
new JButton("Set Green Color"); 


UF E I Nas ees eee // 
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public Prob13Runner () {//constructor 


setDefaultCloseOperation( 
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-end- 


4.4.2.3.4 Java OOP: Using a JColorChooser object 
4.4,2.3.4.1 Table of Contents 
e Preface (p. 1916) 


Viewing tip (p. 1916) 


x Figures (p. 1916) 
x Listings (p. 1916) 


Preview (p. 1917) 

Discussion and sample code (p. 1925) 
Run the program (p. 1928) 
Summary (p. 1928) 

What’s next? (p. 1928) 
Miscellaneous (p. 1928) 

Complete program listing (p. 1928) 


4.4.2.3.4.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 


4.4.2.3.4.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.3.4.2.1.1 Figures 


e Figure 1 (p. 1918) . Program output at startup. 

e Figure 2 (p. 1922) . Program output after clicking the Choose Color button. 

e Figure 3 (p. 1923) . Program output after selecting a reddish color and clicking the OK button. 
e Figure 4 (p. 1924) . Program output after clicking the Darker button. 

e Figure 5 (p. 1926) . The showDialog method. 


4.4.2.3.4.2.1.2 Listings 


Listing 1 (p. 1925) . Event handler for the Choose Color button. 
Listing 2 (p. 1926) . Show the JColorChooser object. 

Listing 3 (p. 1927) . Darkening the color. 

Listing 4 (p. 1929) . Complete program listing. 
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4.4.2.3.4.3 Preview 


In this module, you will learn how to use a JColorChooser object to specify a color in any one of five 
different ways: 


Swatches 
HSV 
HSL 
RGB 
CMYK 


The details regarding the five different ways are not explained. Instead, an understanding of the five ways 
for specifying a color is left as an exercise for the student. 

This module concentrates on the programming aspects of the color chooser as opposed to the aesthetic 
aspects of the color chooser. 

You will also learn how to create brighter and darker shades of a given color. 

What is a JColorChooser object? 

According to the Java documentation, 

"JColorChooser provides a pane of controls designed to allow a user to manipulate and select a color." 

Program output at startup 

A complete listing of the program discussed in this module is provided in Listing 4 (p. 1929) near the 
end of the module. 

Figure 1 (p. 1918) shows the program output at startup. 

The program output is a GUI containing 


three text fields, one each for red, green, and blue color values 

three labels that identify the contents of each text field 

a button labeled Choose Color 

two buttons labeled Brighter and Darker 

a square color swatch whose color reflects the color specified by the color component values in 
the text fields 


E Dick Baldwin | -loj x| 


000000. 000000 000000 
Choose Color Brighter 


E Dick Baldwin oe M 


Choose Color Brighter 
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E Dick Baldwin 7 1 ols 
000000 


Choose Color Brighter 


Figure 1 . Program output at startup. 


E Dick Baldwin oe oll 
000000 


Choose Color Brighter 
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Program output after clicking the Choose Color button. 
Figure 2 (p. 1922) shows the result of clicking the Choose Color button shown in Figure 1 (p. 1918) . 
The bottom image in Figure 2 (p. 1922) is an object of the JColorChooser class. 
(The color chooser object doesn’t actually appear below the GUI as shown in Figure 2 (p. 1922) 
. Instead, it appears in the upper-left corner of the screen and hides the GUI. I manually dragged it down 
below the GUI to produce this image.) 
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Dick Baldwin 


Choose Color | Brighter | Darker | 


£3 choose color x| 
(Swatches | HSV [ HSL | RGB [ CMYK | 


Recent: 


Preview 


n| =] E Sample Text Sample Text 


a E a Sample Text Sample Text 
Cancel Reset 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1916 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 
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Figure 2 . Program output after clicking the Choose Color button. 
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The initial color selection 

Note in Figure 2 (p. 1922) that the selected color when the color chooser appears matches the color of 
the square color swatch in Figure 1 (p. 1918) (black) 

Program output after selecting a reddish color and clicking the OK button. 

Figure 3 (p. 1923) shows the result of 


e selecting a reddish color in the color chooser, and 
e clicking the OK button in the color chooser. 


[é] Dick Baldwin 


Choose Color Brighter 
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Figure3 . Program output after selecting a reddish color and clicking the OK button. 
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New color in the GUI 
Note in Figure 3 (p. 1923) that 


e the color selected in the color chooser now appears in the square color swatch in Figure 3 (p. 1923) 
e the color swatch in Figure 3 (p. 1923) has a black border 
e the color values in the three text fields describe the color showing in the swatch 


(The color in the swatch is based on the three color values in the text fields.) 


Program output after clicking the Darker button. 
Figure 4 (p. 1924) shows the result of clicking the Darker button once. 
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Choose Color Brighter 


Figure 4 . Program output after clicking the Darker button. 
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A darker color 
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The color swatch in Figure 4 (p. 1924) shows a darker version of the color swatch shown in Figure 3 (p. 


1923) . 
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The numeric color values in Figure 4 (p. 1924) describe the color in the color swatch, and are lower than 
the corresponding color values in Figure 3 (p. 1923) 

A brighter color 

Although not demonstrated here, the color in the swatch could be made brighter by clicking the Brighter 
button. 

If you click the Darker button enough times, the color will go to black. Similarly, if you click the 
Brighter button enough times, the color will go to white. 


4.4.2.3.4.4 Discussion and sample code 


A complete listing of the program is provided in Listing 4 (p. 1929) . 
Much of the code in this program is very similar to code that I explained in earlier modules. Therefore, 
I won’t repeat those explanations here. Instead, I will concentrate on the code that is new and different. 
Given that caveat, I will skip all the way down to the event handler for the Choose Color button. 
Event handler for the Choose Color button 
Listing 1 (p. 1925) defines, instantiates, and registers an ActionListener object on the Choose 
Color button. 


Listing 1 . Event handler for the Choose Color button. 


chooseButton.addActionListener ( 
new ActionListener () { 
public void actionPerformed(ActionEvent e){ 
Color selColor = JColorChooser.showDialog( 
chooseButton, "Choose color",new Color ( 
redInt,greenInt,blueInt)) ; 
if(selColor != null){ 
//Don’t change the color if the user cancels 
// out. 
redField.setText("" + selColor.getRed()) ; 
greenField.setText("" + selColor.getGreen()); 
blueField.setText("" + selColor.getBlue()); 
}//end if 


}//end action performed 
}//end new ActionListener 
);//end addActionListener 


Table 4.398 


Show the JColorChooser object 
Listing 2 (p. 1926) shows the code, (extracted from Listing 1 (p. 1925) ) that causes the color 
chooser to appear on the screen. 
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Listing 2 . Show the JColorChooser object. 


Color selColor = JColorChooser.showDialog( 
chooseButton, 
"Choose color", 
new Color(redInt,greenInt,blueInt)); 


Table 4.399 


Call the static showDialog method 
Listing 2 (p. 1926) calls the static showDialog method of the JColorChooser class. 
Figure 5 (p. 1926) provides information for the showDialog method. 


Figure 5 . The showDialog method. 


public static Color showDialog( 
Component component, 
String title, 
Color initialColor) 
throws HeadlessException 


Shows a modal color-chooser dialog and blocks 
until the dialog is hidden. If the user presses 
the "OK" button, then this method hides/disposes 
the dialog and returns the selected color. If 

the user presses the "Cancel" button or closes 
the dialog without pressing "0K", then this 
method hides/disposes the dialog and returns null. 


Parameters: 
component - the parent Component for the dialog 
title - the String containing the dialog’s title 
initialColor - the initial Color set when the 
color-chooser is shown 
Returns: 
the selected color or null if the user opted out 


Table 4.400 


A straightforward explanation 

The behavior of the dialog is explained in Figure 5 (p. 1926) and shouldn’t require further explanation. 

Parameters to the showDialog method 

A comparison of Listing 2 (p. 1926) and Figure 5 (p. 1926) shows how the color chooser is integrated 
into the program. 

Perhaps the most important aspects of that integration are the third parameter and the return value 


The third parameter 
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The third parameter is an anonymous Color object that matches the color specified by the text fields 
in the GUI, which determine the color of the swatch. 

Thus, the initial color for the color chooser matches the color of the swatch in the GUI when the color 
chooser first appears. 

The return value 

The return value from the color chooser is a reference to an object of type Color , which is saved in a 
variable named selColor 

Processing the return value 

Returning to the code in Listing 1 (p. 1925) , 


e if the return value is not null, 
e the color components of the return value are converted to strings and 
e stored in the red, green, and blue text fields. 


What happens next? 

You learned in an earlier module that if the values stored in any of the three text fields changes for any 
reason, DocumentListener objects registered on the three text fields cause the color of the swatch to 
change to match the new values of the color components. 

Thus, the color that is chosen by the user from the color chooser modifies the values in the text fields 
causing the color of the swatch in the GUI to match the chosen color. 

Darkening and brightening the color 

Listing 3 (p. 1927) shows an ActionListener object being registered on the button labeled Darker 

in Figure 1 (p. 1918) . 


Listing 3 . Darkening the color. 


darkerButton.addActionListener ( 
new ActionListener () { 
public void actionPerformed(ActionEvent e){ 
Color color = new Color( 
redInt ,greenInt, blueInt) .darker(); 
redField.setText("" + color.getRed()) ; 
greenField.setText("" + color.getGreen()); 
blueField.setText("" + color.getBlue()); 
}//end action performed 
}//end newActionListener 
);//end addActionListener 


Table 4.401 


The darkening action listener 

This code creates anew Color object that matches the color values in the three text fields. 

Then it calls the darker method on that Color object causing its color to be darkened. 

Then it extracts the color components from the darker Color object and stores those values in the text 
fields. 

This, in turn, causes the color swatch to change to match the new color values. 

A brightening event handler 

A similar event handler is registered on the button labeled Brighter in Figure 1 (p. 1918) . 

This code, which you can view in Listing 4 (p. 1929) calls the brighter method instead of the darker 
method on the Color object. 
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End of story 
That concludes the explanation of material that is new and different in this program. 


4.4.2.3.4.5 Run the program 


I encourage you to copy the code from Listing 4 (p. 1929) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


4.4.2.3.4.6 Summary 


In this module, you will learned how to use a JColorChooser object to specify a color in any one of five 
different ways. 
You also learned how to create brighter and darker shades of a given color. 


4.4.2.3.4.7 What’s next? 


In the next module, you will learn how to write an editor program that you can use to modify the colors in 
an image on a pixel-by-pixel basis. 


4.4.2.3.4.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: Using a JColorChooser object 
e File: Java3128.htm 

e Published: 09/11/12 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.3.4.9 Complete program listing 


A complete listing of the source code discussed in this module is shown in Listing 4 (p. 1929) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1924 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Listing 4 . Complete program listing. 


/*File Prob14 Copyright 2012 R.G.Baldwin 


Old material: 
This program services document events on the contents of 
text fields containing color values. 


The values are used to create a color swatch that displays 
the color indicated by the color values in the red, green, 
and blue text fields. 


New material: 

Demonstrates how to create and use a JColorChooser dialog. 
Also demonstrates use of the darker and brighter methods. 
Also demonstrates how to cause JTextField objects to be 
non-editable. 

aKa a 3k 3K 3K 3K 3K ak ak ak ak ək aK aK aK aK 3K 3K 3K 3K 3K ak ak ak ak II I I I I I I I I 3K I 3K 3K 3K a a K K ÞK ÞK ÞK ÞK ÞK 34 34 / 
import java.awt.event.ActionEvent; 

import java.awt.event.ActionListener; 

import javax.swing.JButton; 

import javax.swing.JFrame; 

import javax.swing.JPanel; 

import javax.swing.JTextField; 

import javax.swing.JLabel; 

import javax.swing.WindowConstants; 

import javax.swing.event .DocumentListener; 

import javax.swing.event .DocumentEvent; 

import javax.swing.border.LineBorder; 

import java.awt.Color; 

import java.awt.GridLayout ; 

import java.awt.Dimension; 

import javax.swing.JColorChooser ; 


public class Prob14{ 
public static void main(String[] args){ 
new Probi4Runner () ; 
}//end main method 
}//end class Prob14 


class Probi4Runner extends JFrame{ 


private JPanel controlPanel = new JPanel(); 
private JPanel colorPanel = new JPanel(); 

private JPanel buttonPanel = new JPanel(); 

private JPanel colorIndicatorPanel = new JPanel(); 


private JTextField redField = new JTextField("000000") ; 
private JTextField greenField = 
new JTextField("000000") ; 
private JTextField blueField = new JTextField("000000") ; 
Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
private int redInt = 0; 
private int greenInt = 0; 
private int blueInt = 0; 


-end- 


4.4.2.3.5 Java OOP: A Pixel Color Editor” 


Table 4.402 
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4.4.2.3.5.1 Table of Contents 


e Preface (p. 1930) 
Viewing tip (p. 1930) 


x Figures (p. 1930) 
x Listings (p. 1930) 


Preview (p. 1931) 

Discussion and sample code (p. 1943) 
Run the program (p. 1948) 
Summary (p. 1948) 

Miscellaneous (p. 1949) 

Complete program listing (p. 1949) 
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This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 


using Java. 


The program described in this module requires the use of the Guzdial-Ericson multimedia class library. 
You will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 166 . 


4.4.2.3.5.2.1 Viewing tip 


I recommend that you open another copy of this document in a separate browser window and use the 


following links to easily find and view the figures and listings while you are reading about them. 


4.4.2.3.5.2.1.1 Figures 


e Figure 1 (p. 1935) . Program output at startup. 
e Figure 2 (p. 1939) . Program output after zooming the image. 
e Figure 3 (p. 1943) . Program output after changing the pixel color to yellow. 


4.4.2.3.5.2.1.2 Listings 


( 
( 
( 
Listing 4 ( 
Listing 5 (p 
Listing 6 (p 
( 

( 

( 


Listing 9 


Listing 1 (p. 
Listing 2 (p. 
Listing 3 (p. 
p- 


Listing 7 (p. 
Listing 8 (p. 
p- 
Listing 10 (p. 1952) . Complete listing of modified PictureExplorer class. 


1944) . Code for methods that were added. 
1945) . Modified setDefaultCloseOperation method. 
1945) . Beginning of ActionListener registered on update button. 
1946) . Convert zoom factor to type String. 
. 1946) . Set pixel color in original image. 
. 1947) . Create and populate a new PictureExplorer object. 
1947) . Call the mousePressed method. 
1948) . Set the zoom state. 
) 


1950) . Complete listing of Prob15. 


165This content is available online at <http://cnx.org/content /m44926/1.3/>. 
166http://cnx.org/content /m44148/latest / 
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4.4.2.3.5.3 Preview 


In this module, you will learn how to write an editor program that you can use to modify the colors in an 
image on a pixel-by-pixel basis. 

Such a program could be useful, for example, for manually correcting "red eye" problems in digital 
images. 

Program output at startup 

Figure 1 (p. 1935) shows the program output at startup. 

The output consists of 


e an Ericson PictureExplorer object displaying an image of a penguin, and 
e a color manipulation GUI similar to those discussed in earlier modules. 
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Probi5.jpa 


Dick Baldwin 


o00000 
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Probi5.jpa 


Dick Baldwin 
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Figure 1 . Program output at startup. 
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Table 4.403 


Program output after zooming the image 

Figure 2 (p. 1939) shows the program output after placing the PictureExplorer cursor on the 
penguin’s nose, and zooming the PictureExplorer image by 500% 

If you look carefully, you should be able to see the crosshair cursor on the penguin’s nose. 
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Figure 2 . Program output after zooming the image. 
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Program output after changing the pixel color to yellow 

Figure 3 (p. 1943) shows the result of selecting the color yellow with the GUI, and clicking the button 
labeled Update Pixel Color 

If you look carefully, you should see that the pixel next to the crosshair cursor on the penguin’s nose has 
changed from black to yellow. 
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Figure 3 . Program output after changing the pixel color to yellow. 
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4.4.2.3.5.4 Discussion and sample code 


This program requires modifications to Ericson’s PictureExplorer class. I will deal with that issue first. 
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A complete listing of the modified version of the PictureExplorer class is shown in Listing 10 (p. 
1952) . 

Changes to Ericson’s PictureExplorer class 

The PictureExplorer class was modified to add getter methods to cause the following values to be 
accessible from outside the object: 


int xIndex 

int yIndex 

double zoomFactor 
JFrame pictureFrame 


Also the call to the setDefaultCloseOperation method was disabled. 
Code for methods that were added 
Listing 1 (p. 1944) shows the code for the methods that were added to the PictureExplorer class. 


Listing 1 . Code for methods that were added. 


//Method to get the xIndex value. 
public int getXIndex(){ 
return xIndex; 
}//end getXIndex 


//Method to get the yIndex value. 
public int getYIndex(){ 

return yIndex; 
}//end getYIndex 


//Method to get the zoomFactor value. 

public double getZoomFactor (){ 
return zoomFactor; 

}//end getZoomFactor 


//Method to get a reference to the frame 
public JFrame getFrame(){ 

return pictureFrame; 
}//end getFrame() 


Table 4.406 


Modified set Default CloseOperation method 
Listing 2 (p. 1945) shows the modified version of the setDefaultCloseOperation method. 
Note the parameter that is passed to the method when it is called. 
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Listing 2 . Modified setDefaultCloseOperation method. 


explorerFrame.setDefaultClose0peration( 
WindowConstants .DO_NOTHING_ON_CLOSE) ; 


Table 4.407 


Similar to previous code 

Much of the code in this program is similar to code that I explained in earlier modules, and I won’t 
repeat those explanations. 

I will skip down to the event handler registered on the button labeled Update Pixel Color in Figure 
1 (p. 1935) . That code begins in Listing 3 (p. 1945) . 


Listing 3 . Beginning of ActionListener registered on update button. 


updateButton. addActionListener ( 
new ActionListener (){ 
public void actionPerformed(ActionEvent e){ 


//Get properties of PictureExplorer object. 
xIndex = explorer. getXIndex() ; 

yIndex = explorer. getYIndex() ; 

zoomFactor = explorer.getZoomFactor() ; 


Table 4.408 


Important to preserve properties 

The only thing that changes when you click the update button is the color of the pixel at the crosshair 
cursor. 

Therefore, the program must preserve the state of the explorer object including such items as the zoom 
factor and the location of crosshair cursor. 

Listing 3 (p. 1945) gets and saves the property values that determine the state of the explorer object. 

Convert zoom factor to String 

The getZoomFactor method returns the zoom factor as type double . However, we need the zoom 
factor as type String . The code in Listing 4 (p. 1946) converts the zoom factor to type String 
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Listing 4 . Convert zoom factor to type String. 


//Save zoom factor as a string. 
String zoomString = "100%"; 
if (zoomFactor == 0.25){ 
zoomString = "25%"; 

}else if(zoomFactor == 0.50){ 
zoomString = "50%"; 

}else if(zoomFactor == 0.75){ 
zoomString = "75%"; 

}else if(zoomFactor == 1.0){ 
zoomString = "100%"; 

}else if(zoomFactor == 1.5){ 
zoomString = "150%"; 

}else if(zoomFactor == 2.0){ 
zoomString = "200%"; 


}else if(zoomFactor == 5.0){ 
zoomString = "500%"; 
}else{ 
zoomString = "100%";//in case no match 


}//end else 


Table 4.409 


Set pixel color in original image 
The code in Listing 5 (p. 1946) 


e creates anew Color object based on the values in the text fields of Figure 3 (p. 1943) , and 
e changes the color of the corresponding pixel in the original image to the new color. 


At this point, the color of the pixel in the original image has been modified. 


Listing 5 . Set pixel color in original image. 


Color newColor = new Color( 
redInt,greenInt,blueInt) ; 
pix. getPixel (xIndex, yIndex) .setColor(newColor) ; 


Table 4.410 


Create and populate a new PictureExplorer object 

Listing 6 (p. 1947) begins by disposing of the original PictureExplorer object. Then Listing 6 (p. 
1947) creates anew PictureExplorer object containing the modified image. 

Finally Listing 6 (p. 1947) calls the setDefaultCloseOperation onthe JFrame that houses the 
PictureExplorer object disabling the X-button in the upper-right corner. 
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Listing 6 . Create and populate a new PictureExplorer object. 


//Dispose of the existing explorer and create a 
// new one. 
explorerFrame.dispose() ; 


explorer = new PictureExplorer (pix); 


//Get reference to the new frame 

explorerFrame = explorer. getFrame() ; 

explorerFrame.setDefaultClose0peration( 
WindowConstants.DO_NOTHING_ON_CLOSE) ; 


Table 4.411 


Set the state of the PictureExplorer object 

You will probably need to study the event handling code in the PictureExplorer class to fully 
understand the remaining code in this discussion. 

When you click the image in the PictureExplorer object, a MouseListener object registered on 
the PictureExplorer object calls the mousePressed method belonging to that object 

Simulate a physical click 

We can simulate a physical click on that image by calling the same method from outside the Picture- 
Explorer object. 

Call the mousePressed method 

Listing 7 (p. 1947) calls the mousePressed method on the PictureExplorer object passing the 
crosshair coordinates as parameters. Other parameters are also passed to satisfy the requirements of the 
mousePressed method. 

(I will leave it as an exercise for the student to investigate those other parameters.) 


Listing 7 . Call the mousePressed method. 


//Now set the state of the new explorer. 


//Simulate a mouse pressed event in the picture 
// to set the cursor and the text in the 
// coordinate fields. 
explorer .mousePressed(new MouseEvent ( 
new JButton("dummy component"), 
MouseEvent .MOUSE_PRESSED, 
(long)0, 
0, 
xIndex, 
yIndex, 
0, 
false)); 


Table 4.412 
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PictureExplorer object handles crosshair cursor 
The code in Ericson’s mousePressed method takes care of all the requirements that result from setting 
the location of the crosshair cursor, such as setting the coordinate values in the PictureExplorer object’s 
text fields shown in Figure 3 (p. 1943) . 
Set the zoom state 
Manually selecting a zoom level from the Zoom menu in the PictureExplorer object causes the 
actionPerformed method belonging to an ActionListener object registered on the PictureExplorer 
object to be executed. 
As before, we can simulate the manual selection of a Zoom menu value by calling that actionPer- 
formed method from outside the object. 
Set the zoom state 
Listing 8 (p. 1948) calls Ericson’s actionPerformed method, passing the String representation of 
the zoom factor as a parameter. 
(I will leave it as an exercise for the student to investigate the other parameters.) 


Listing 8 . Set the zoom state. 


//Simulate an action event on the zoom menu to 
// set the zoom. 
explorer.actionPerformed(new ActionEvent ( 
explorer, 
ActionEvent .ACTION_PERFORMED, 
zoomString) ) ; 


}//end actionPerformed 
}//end newActionListener 
);//end addActionListener 
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Conclusion of discussion 

That concludes the discussion of the ActionListener object registered on the button labeled Update 
Pixel Color in Figure 1 (p. 1935) . 

It also concludes the discussion of the program. 


4.4.2.3.5.5 Run the program 


I encourage you to copy the code from Listing 9 (p. 1950) and Listing 10 (p. 1952) and download the image 
file named Prob15.jpg 167 . Compile the code and execute it. Experiment with the code, making changes, 
and observing the results of your changes. Make certain that you can explain why your changes behave as 
they do. 


4.4.2.3.5.6 Summary 


In this module, you learned how to write an editor program that you can use to modify the colors in an 
image on a pixel-by-pixel basis. 


167http://cnx.org/content /m44926 /latest /Prob15.jpg 
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4.4.2.3.5.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: A Pixel Color Editor 
e File: Java3130.htm 

e Published: 09/11/12 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.4.2.3.5.8 Complete program listing 


Complete listings of the source code discussed in this module are shown in Listing 9 (p. 1950) and Listing 
10 (p. 1952) below. 
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Listing 9 . Complete listing of Prob15. 


/*File Prob15 Copyright 2012 R.G.Baldwin 


The purpose of this program is demonstrate one way to 
change the color of a pixel in a Picture object that is 
encapsulated in a PictureExplorer object. 


The pixel to be modified is selected by placing the 
cursor in the PictureExplorer object. 
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import java.awt.event .MouseEvent ; 

import java.awt.event.ActionEvent; 

import java.awt.event.ActionListener; 

import javax.swing.JButton; 

import javax.swing. JFrame; 

import javax.swing. JPanel; 

import javax.swing.JTextField; 

import javax.swing.JLabel; 

import javax.swing.WindowConstants; 

import javax.swing.event .DocumentListener; 

import javax.swing.event .DocumentEvent; 

import javax.swing.border.LineBorder; 

import java.awt.Color; 

import java.awt.GridLayout ; 

import java.awt.Dimension; 

import javax.swing.JColorChooser; 


public class Probib5{ 
public static void main(String[] args){ 
new Probi5Runner () ; 
}//end main method 
}//end class Prob15 


class Probi5Runner extends JFramef 
private Probi5Runner jFrameObj = null; 
private PictureExplorer explorer = null; 
private Picture pix; 
private JFrame explorerFrame; 


private JPanel controlPanel = new JPanel(); 
private JPanel colorPanel = new JPanel(); 

private JPanel buttonPanel = new JPanel(); 

private JPanel colorIndicatorPanel = new JPanel(); 


private JTextField redField = new JTextField("000000") ; 
private JTextField greenField = 

new JTextField("000000") ; 
private JTextField blueField = new JTextField("000000") ; 


private int redInt = 0; . 
; i vajlable fop free at Connexions <http://cnx.org/content/col11441/1.181> 
private int greenInt = 0; 


private int blueInt = 0; 


//Copies of properties of the PictureExplorer object 
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Listing 10 . Complete listing of modified PictureExplorer class. 


import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 
import java.awt.image.*; 
import javax.swing. border. *; 


/* 

05/16/12 Modified by Baldwin to add getter methods to 
cause the following values to be accessible from 
outside the object: 


int xIndex 

int yIndex 

double zoomFactor 
JFrame pictureFrame 


Also disabled the call to setDefaultCloseOperation 


*/ 
/** 
* Displays a picture and lets you explore the picture by displaying the x, y, red, 
* green, and blue values of the pixel at the cursor when you click a mouse button or 
* press and hold a mouse button while moving the cursor. It also lets you zoom in or 
* out. You can also type in a x and y value to see the color at that location. 
* 
* Originally created for the Jython Environment for Students (JES). 
* Modified to work with DrJava by Barbara Ericson 
* 
* Copyright Georgia Institute of Technology 2004 
* @author Keith McDermottt, gte047w@cc.gatech.edu 
* @author Barb Ericson ericson@cc.gatech.edu 


*/ 
public class PictureExplorer implements MouseMotionListener, ActionListener, MouseListener 


{ 


// current x and y index 
private int xIndex = 0; 
private int yIndex = 0; 


//Main gui variables 

g 

private JFrame pictureFrame; 
private JScrollPane scrollPane; 


//information bar variables 
private JLabel xLabel; 
private JButton xPrevButton; 
private JButton yPrevButton; 
private JButton xNextButton; 
private JButton yNextButton; . 

private JLabel yeaa for free at Connexions <http://cnx.org/content/col11441/1.181> 
private JTextField xValue; 

private JTextField yValue; 


private JLabel rValue; 
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4.4.2.4 Practice Programs 
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4.4.2.4.1 Java OOP: ITSE 2317 Practice Programs hei 
4.4,2.4.1.1 ITSE2317 - Java Programming (Intermediate) - Practice Test 1 


Java and Media Library Version Requirements (p. 1955) 
Input Image Files (p. 1955) 

Solution source code files (p. 1955) 

Output Images (p. 1955) 

New Classes (p. 1955) 

Hints (p. 1956) 

Testing Your Programs (p. 1956) 

Program Specifications (p. 1957) 


Program 1 (p 
Program 2 (p. 1961) 
Program 3 (p. ) 
Program 4 (p. 1974) 
Program 5 (p. 1982) 


e Miscellaneous Information (p. 1995) 


4.4.2.4.1.1.1 Java and Media Library Version Requirements 


Your programs must be compatible with Sun’s Standard Edition JDK Version 1.7 or later. 

Some of the programs on this test require you to use the Guzdial-Ericson multimedia class library. You 
will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 16° . 


4.4.2.4.1.1.2 Input Image Files 
Links are provided within the individual program specifications for downloading zip files that contain any 
image files that may be required to write, compile, and test your programs. 


4.4.2.4.1.1.3 Solution source code files 


The downloadable zip files mentioned above also contains source code files for the programming solutions. 
You can compile and execute those programs using procedures described in Java OOP: The Guzdial-Ericson 
Multimedia Class Library !7° . 


4.4.2.4.1.1.4 Output Images 


Your output image(s) must match my output image(s) in every respect including color, size, position, etc. 
Don’t forget to display your name in the output image(s) as shown. 


4.4.2.4.1.1.5 New Classes 


You may define new classes and add import directives as needed to cause your programs to behave as 
required, but you may not modify the class definitions for the given classes named ProbXX when such class 
definitions are provided. 


168 This content is available online at <http://cnx.org/content /m44264/1.3/>. 
169http://cnx.org/content /m44148/latest / 
'70http://cnx.org/content /m44148/latest: / 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1951 


4.4.2.4.1.1.6 Hints 


For some of the programs, you may first need to deduce the algorithm used to transform the input image 
into the output image, and then write a working program that implements that algorithm. In some cases, 
you may need to compare numeric color values for corresponding pixels in the input and output images in 
order to deduce the algorithm. 

You can obtain those color values using the following procedure: 


1. 


2. 


3. 


Click the download link for the zip files that contain input image files and solution source code files. 
Use the capabilities of your browser to download and save the contents of those zip files. 

If necessary, replace calls to the show method in my source code with calls to the explore method 
to force the program to display the output images in a PictureExplorer window. 

Compile and run the source code. 

Write, compile, and run a simple Java program that will display each input image file in a Picture- 
Explorer window. 


. Use the input and output PictureExplorer windows to compare the input and output color values 


on a pixel by pixel basis. 


You may find other useful hints in my online tutorials and slides for this course. 


4.4.2.4.1.1.7 Testing Your Programs 


You can compile and execute your program by following the instructions given at Java OOP: The Guzdial- 


Ericson Multimedia Class Library 


171 
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4.4.2.4.1.1.8 Program Specifications 
4.4.2.4.1.1.8.1 Program 1 


Listing 1 . Write the Java application described below. 


/*File Prob01 Copyright 2012 R.G.Baldwin 

Write a program named Prob01 that uses the class definition shown below and Ericson’s media library 
along with the image file named Prob01.jpg to produce the graphic output image shown in Figure 1 (p. 
1960) below. 

Click here 17? to download a zip file containing the required image file along with the source code for a 
solution. 

Contrary to the general instructions given above, you may not define any new classes to cause your 
program to behave as required. 

You must copy and modify (if necessary) the media classes named World.java, Turtle.java, and Simple- 
Turtle.java to cause your program to produce the required output. Don’t forget to compile these classes 
after you modify them. 

In addition to the output image, your program must produce the following output on the command- line 
screen, and must substitute your name for mine wherever my name appears both in the image and on 
the command-line screen: 


Dick Baldwin 
Picture, filename Prob01.jpg height 274 width 365 
Dick Baldwin 
Dick Baldwin 
Dick Baldwin 
Dick Baldwin 
aE E k k kkk k kk kkk k kkk kk k kkk 3k kk k 3k k kk kk 3k kk k 3k kk 2K K k KK vi 


public class Prob01{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
World mars = new World(200,250); 
Turtle joe = new Turtle(mars); 
joe.forward(); 
Turtle bill = new Turtle (mars); 
bill.moveTo(50,125); 
Turtle sue = new Turtle(mars); 
sue .moveTo(150,125); 
Turtle tom = new Turtle(mars); 
tom.moveTo(100, 225) ; 
}//end main method 
}//end class Prob01 
//End program specifications. 
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Figure 1 . Required output images for Prob01. 
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4.4.2.4.1.1.8.2 Program 2 


CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Listing 2 . Write the Java application described below. 


/*File Prob02 Copyright 2012 R.G.Baldwin 

Write a program named Prob02 that uses the class definition shown below and Ericson’s media library 
to produce the graphic output image shown in Figure 2 (p. 1965) below. 

Click here 173 to download a zip file containing source code for a solution. 

Contrary to the general instructions given above, you may not define any new classes to cause your 


program to behave as required. 


You must copy and modify (if necessary) the media classes named Turtle.java, and SimpleTurtle.java 
to cause your program to produce the required output. Don’t forget to compile these classes after you 


modify them. 


In addition to the output image, your program must produce the following output on the command- line 
screen, and must substitute your name for mine wherever my name appears both in the image and on 


the command-line screen: 


Dick Baldwin 


My name is Joe the turtle. 


Fkk I A IA A I ak 3k 3k 2k ək 2k k ak ək 3k k əkək 2k 2k 2k 3k ək 3k k 2k ək 3k 2k əkək 3k ək 2k 2k 2k əkək 2k 2k 2k ək 2 2k ÞK 2K ak ake / 


import java.awt.Color; 


public class Prob02{ 


//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 

World mars = new World(200,300); 

Turtle joe = new Turtle(mars,"Joe"); 


joe.moveTo(20,280); 


joe.setInfoColor (Color.WHITE) ; 


joe.setShowInfo(true) ; 


System. out.println(joe); 


}//end main method 
}//end class Prob02 


//End program specifications. 
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Dick Baldwin 
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Figure 2 . Required output images for Prob02. 


Dick Baldwin 


ily name is Joe the turtle. 
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4.4.2.4.1.1.8.3 Program 3 


Write a program named Prob03 that uses Ericson’s media library to produce the graphic output images 
shown in Figure 3 (p. 1970) and Figure 4 (p. 1974) below. 

Click here 174 to download a zip file containing the source code for a solution. 

The image shown in Figure 3 (p. 1970) is the image that appears on the screen when the program starts 
running. The image shown in Figure 4 (p. 1974) is what you should see when you click the button at the 
bottom of the world. 

You must copy and modify (if necessary) the media class named World.java, to cause your program to 
produce the required output with the required behavior. Don’t forget to compile that class after you modify 
it. 

This program adds a JButton object to the SOUTH location of the World object as shown in Figure 3 
(p. 1970) . 

The program initially displays an empty white world. When the user clicks the button, the world’s 
background color changes to blue, a turtle appears in the center of the World, and the student’s name 
appears near the top of the world. 
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Write a program named Prob03 that uses Ericson’s media library to produce the graphic output images 
shown in Figure 3 (p. 1970) and Figure 4 (p. 1974) below. 

Click here 14 to download a zip file containing the source code for a solution. 

The image shown in Figure 3 (p. 1970) is the image that appears on the screen when the program starts 
running. The image shown in Figure 4 (p. 1974) is what you should see when you click the button at the 
bottom of the world. 

You must copy and modify (if necessary) the media class named World.java, to cause your program to 
produce the required output with the required behavior. Don’t forget to compile that class after you modify 
it. 

This program adds a JButton object to the SOUTH location of the World object as shown in Figure 3 
(p. 1970) . 

The program initially displays an empty white world. When the user clicks the button, the world’s 
background color changes to blue, a turtle appears in the center of the World, and the student’s name 
appears near the top of the world. 


Write a program named Prob03 that uses Ericson’s media library to produce the graphic output images 
shown in Figure 3 (p. 1970) and Figure 4 (p. 1974) below. 

Click here 175 to download a zip file containing the source code for a solution. 

The image shown in Figure 3 (p. 1970) is the image that appears on the screen when the program starts 
running. The image shown in Figure 4 (p. 1974) is what you should see when you click the button at the 
bottom of the world. 

You must copy and modify (if necessary) the media class named World.java, to cause your program to 
produce the required output with the required behavior. Don’t forget to compile that class after you modify 
it. 

This program adds a JButton object to the SOUTH location of the World object as shown in Figure 3 
(p. 1970) . 

The program initially displays an empty white world. When the user clicks the button, the world’s 
background color changes to blue, a turtle appears in the center of the World, and the student’s name 
appears near the top of the world. 


Listing 3 . Write the Java application described below. 


/*File Prob03 Copyright 2012 R.G.Baldwin Write a program named Prob03 that uses Ericson’s media library to produce 
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Figure 3 . The first of two required output images for Prob03. 
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Figure 4 . The second of two required output images for Prob03. 
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4.4.2.4.1.1.8.4 Program 4 


Write a program named Prob04 that uses Ericson’s media library to produce the graphic output images 
shown in Figure 5 (p. 1978) , Figure 6 (p. 1980) , and Figure 7 (p. 1982) below. 

Click here 17° to download a zip file containing the source code for a solution. 

Figure 5 (p. 1978) shows the image that appears on the screen when the program starts running. Figure 
6 (p. 1980) shows what you should see after you have clicked the button at the bottom of the world one 
time. Figure 6 (p. 1980) shows what you should see after you have clicked the button sixteen times. 

You must copy and modify the media classes named World.java and SimplePicture.java, to cause your 
program to produce the required output with the required behavior. Don’t forget to compile those classes 
after you modify them. 

This program adds a JButton object to the SOUTH location of the World object as shown in Figure 5 
(p. 1978) . 

The following description is intended to guide you in writing your program. However, you must run my 
version of the program and replicate it exactly. I recommend that you run the two programs side-by-side 
and compare their appearance and behavior each time you click both programs. 
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The program initially displays an empty white world with a button at the bottom. When the user clicks 
the button, the world’s background color changes to green, a turtle appears in the bottom right of the World, 
and the student’s name appears near the top of the world in blue. The turtle has a blue body and a red 
shell. 

When you click the button again, the background changes to yellow, the student’s name changes to red, 
and the turtle changes to a red body with a blue shell. The turtle turns 90 degrees left and moves forward 
100 pixels plus the value of a click counter. As a result, the turtle leaves a blue trail. 

On the next click, the colors revert to the same as before, the turtle turns 90 degrees left and moves 
forward 100 pixels plus the value of the click counter leaving a red trail. 

This cycle repeats on each click with the turtle’s trail drawing a square spiral of increasing size with red 
lines on the top and bottom of the spiral and blue lines on the right and left of the spiral. 


Write a program named Prob04 that uses Ericson’s media library to produce the graphic output images 
shown in Figure 5 (p. 1978) , Figure 6 (p. 1980) , and Figure 7 (p. 1982) below. 

Click here 175 to download a zip file containing the source code for a solution. 

Figure 5 (p. 1978) shows the image that appears on the screen when the program starts running. Figure 
6 (p. 1980) shows what you should see after you have clicked the button at the bottom of the world one 
time. Figure 6 (p. 1980) shows what you should see after you have clicked the button sixteen times. 

You must copy and modify the media classes named World.java and SimplePicture.java, to cause your 
program to produce the required output with the required behavior. Don’t forget to compile those classes 
after you modify them. 

This program adds a JButton object to the SOUTH location of the World object as shown in Figure 5 
(p. 1978) . 

The following description is intended to guide you in writing your program. However, you must run my 
version of the program and replicate it exactly. I recommend that you run the two programs side-by-side 
and compare their appearance and behavior each time you click both programs. 

The program initially displays an empty white world with a button at the bottom. When the user clicks 
the button, the world’s background color changes to green, a turtle appears in the bottom right of the World, 
and the student’s name appears near the top of the world in blue. The turtle has a blue body and a red 
shell. 

When you click the button again, the background changes to yellow, the student’s name changes to red, 
and the turtle changes to a red body with a blue shell. The turtle turns 90 degrees left and moves forward 
100 pixels plus the value of a click counter. As a result, the turtle leaves a blue trail. 

On the next click, the colors revert to the same as before, the turtle turns 90 degrees left and moves 
forward 100 pixels plus the value of the click counter leaving a red trail. 

This cycle repeats on each click with the turtle’s trail drawing a square spiral of increasing size with red 
lines on the top and bottom of the spiral and blue lines on the right and left of the spiral. 


Write a program named Prob04 that uses Ericson’s media library to produce the graphic output images 
shown in Figure 5 (p. 1978) , Figure 6 (p. 1980) , and Figure 7 (p. 1982) below. 

Click here 176 to download a zip file containing the source code for a solution. 

Figure 5 (p. 1978) shows the image that appears on the screen when the program starts running. Figure 
6 (p. 1980) shows what you should see after you have clicked the button at the bottom of the world one 
time. Figure 6 (p. 1980) shows what you should see after you have clicked the button sixteen times. 

You must copy and modify the media classes named World.java and SimplePicture.java, to cause your 
program to produce the required output with the required behavior. Don’t forget to compile those classes 
after you modify them. 

This program adds a JButton object to the SOUTH location of the World object as shown in Figure 5 
(p. 1978) . 
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The following description is intended to guide you in writing your program. However, you must run my 
version of the program and replicate it exactly. I recommend that you run the two programs side-by-side 
and compare their appearance and behavior each time you click both programs. 

The program initially displays an empty white world with a button at the bottom. When the user clicks 
the button, the world’s background color changes to green, a turtle appears in the bottom right of the World, 
and the student’s name appears near the top of the world in blue. The turtle has a blue body and a red 
shell. 

When you click the button again, the background changes to yellow, the student’s name changes to red, 
and the turtle changes to a red body with a blue shell. The turtle turns 90 degrees left and moves forward 
100 pixels plus the value of a click counter. As a result, the turtle leaves a blue trail. 

On the next click, the colors revert to the same as before, the turtle turns 90 degrees left and moves 
forward 100 pixels plus the value of the click counter leaving a red trail. 

This cycle repeats on each click with the turtle’s trail drawing a square spiral of increasing size with red 
lines on the top and bottom of the spiral and blue lines on the right and left of the spiral. 


Listing 4 . Write the Java application described below. 


/*File Prob04 Copyright 2012 R.G.Baldwin Write a program named Prob04 that uses Ericson’s media library to produce 
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Figure 5 . Required output image for Prob04. 
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Figure 6 . Required output image for Prob04. 
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Figure 7 . Required output image for Prob04. 
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4.4.2.4.1.1.8.5 Program 5 


Write a program named Prob05 that uses Ericson’s media library to produce the graphic output image shown 
in Figure 8 (p. 1987) , Figure 9 (p. 1991) , and Figure 10 (p. 1995) below. 

Click here 176 to download a zip file containing the source code for a solution. 

Figure 8 (p. 1987) shows the image that appears on the screen when the program starts running. Figure 
9 (p. 1991) shows what you should see after you have entered numeric values into the angle and distance 
fields and have clicked the Move button. Figure 10 (p. 1995) is similar to what you should see after doing 
the above several times for different numeric values. 

You must copy and modify the media class named World.java to cause your program to produce the 
required output with the required behavior. Don’t forget to compile World.java after you modify it. 

This program adds two buttons, two labels, and two text fields to form a GUI at the bottom of the World 
object. 

If you enter numeric values into the angle and distance fields and then click the Move button, the turtle 
will turn by that angle in degrees and move by that distance in pixels. 

The program must terminate and return control to the operating system when you click the Quit button. 

Note that the GUI at the bottom of the World object is comprised of AWT components instead of Swing 
components. 


Write a program named Prob05 that uses Ericson’s media library to produce the graphic output image 
shown in Figure 8 (p. 1987) , Figure 9 (p. 1991) , and Figure 10 (p. 1995) below. 
Click here 176 to download a zip file containing the source code for a solution. 
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Figure 8 (p. 1987) shows the image that appears on the screen when the program starts running. Figure 
9 (p. 1991) shows what you should see after you have entered numeric values into the angle and distance 
fields and have clicked the Move button. Figure 10 (p. 1995) is similar to what you should see after doing 
the above several times for different numeric values. 

You must copy and modify the media class named World.java to cause your program to produce the 
required output with the required behavior. Don’t forget to compile World.java after you modify it. 

This program adds two buttons, two labels, and two text fields to form a GUI at the bottom of the World 
object. 

If you enter numeric values into the angle and distance fields and then click the Move button, the turtle 
will turn by that angle in degrees and move by that distance in pixels. 

The program must terminate and return control to the operating system when you click the Quit button. 

Note that the GUI at the bottom of the World object is comprised of AWT components instead of Swing 
components. 


Write a program named Prob05 that uses Ericson’s media library to produce the graphic output image 
shown in Figure 8 (p. 1987) , Figure 9 (p. 1991) , and Figure 10 (p. 1995) below. 

Click here 177 to download a zip file containing the source code for a solution. 

Figure 8 (p. 1987) shows the image that appears on the screen when the program starts running. Figure 
9 (p. 1991) shows what you should see after you have entered numeric values into the angle and distance 
fields and have clicked the Move button. Figure 10 (p. 1995) is similar to what you should see after doing 
the above several times for different numeric values. 

You must copy and modify the media class named World.java to cause your program to produce the 
required output with the required behavior. Don’t forget to compile World.java after you modify it. 

This program adds two buttons, two labels, and two text fields to form a GUI at the bottom of the World 
object. 

If you enter numeric values into the angle and distance fields and then click the Move button, the turtle 
will turn by that angle in degrees and move by that distance in pixels. 

The program must terminate and return control to the operating system when you click the Quit button. 

Note that the GUI at the bottom of the World object is comprised of AWT components instead of Swing 
components. 


Listing 5 . Write the Java application described below. 


/*File Prob05 Copyright 2012 R.G.Baldwin Write a program named Prob05 that uses Ericson’s media library to produce 
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Figure 8 . Required output image for Prob05. 
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Figure 9 . Required output image for Prob05. 


Dick Baldwin 


Table 4.429 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1987 


Dick Baldwin 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1988 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Dick Baldwin 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1989 


Dick Baldwin 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


1990 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Figure 10 . Required output image for Prob05. 
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4.4.2.4.1.2 Miscellaneous Information 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: ITSE 2317 Practice Test 1 
e File: PracticeTest01.htm 

e Published: August 9, 2012 

e Revised 12/24/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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4.4.2.4.2 Java OOP: ITSE 2317 Practice Programs 2 
4.4.2.4.2.1 ITSE2317 - Java Programming (Intermediate) - Practice Test 2 


Java and Media Library Version Requirements (p. 1997) 
Input Image Files (p. 1997) 

Solution source code files (p. 1997) 

Output Images (p. 1997) 

New Classes (p. 1997) 

Hints (p. 1998) 

Testing Your Programs (p. 1998) 

Program Specifications (p. 1999) 


Program 1 (p. 1999) 
Program 2 (p. 2008) 
Program 3 (p. 2013) 
Program 4 (p. 2018) 
Program 5 (p. 2027) 


e Miscellaneous Information (p. 2037) 


4.4.2.4.2.1.1 Java and Media Library Version Requirements 


Your programs must be compatible with Sun’s Standard Edition JDK Version 1.7 or later. 

Some of the programs on this test require you to use the Guzdial-Ericson multimedia class library. You 
will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 17° . 


4.4.2.4.2.1.2 Input Image Files 
Links are provided within the individual program specifications for downloading zip files that contain any 
image files that may be required to write, compile, and test your programs. 


4.4.2.4.2.1.3 Solution source code files 


The downloadable zip files mentioned above also contains source code files for the programming solutions. 
You can compile and execute those programs using procedures described in Java OOP: The Guzdial-Ericson 
Multimedia Class Library +° . 


4.4.2.4.2.1.4 Output Images 


Your output image(s) must match my output image(s) in every respect including color, size, position, etc. 
Don’t forget to display your name in the output image(s) as shown. 


4.4.2.4.2.1.5 New Classes 


You may define new classes and add import directives as needed to cause your programs to behave as 
required, but you may not modify the class definitions for the given classes named ProbXX when such class 
definitions are provided. 


177 This content is available online at <http://cnx.org/content /m44265/1.4/>. 
'78http://cnx.org/content /m44148/latest: / 
'79http://cnx.org/content /m44148/latest / 
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4.4.2.4.2.1.6 Hints 


For some of the programs, you may first need to deduce the algorithm used to transform the input image 
into the output image, and then write a working program that implements that algorithm. In some cases, 
you may need to compare numeric color values for corresponding pixels in the input and output images in 
order to deduce the algorithm. 

You can obtain those color values using the following procedure: 


1. 


2. 


3. 


Click the download link for the zip files that contain input image files and solution source code files. 
Use the capabilities of your browser to download and save the contents of those zip files. 

If necessary, replace calls to the show method in my source code with calls to the explore method 
to force the program to display the output images in a PictureExplorer window. 

Compile and run the source code. 

Write, compile, and run a simple Java program that will display each input image file in a Picture- 
Explorer window. 

Use the input and output PictureExplorer windows to compare the input and output color values 
on a pixel by pixel basis. 


You may find other useful hints in my online tutorials and slides for this course. 


4.4.2.4.2.1.7 Testing Your Programs 


You can compile and execute your program by following the instructions given at Java OOP: The Guzdial- 


Ericson Multimedia Class Library 


180 
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4.4.2.4.2.1.8 Program Specifications 
4.4.2.4.2.1.8.1 Program 1 


Listing 1 . Write the Java application described below. 


/*File Prob01 Copyright 2012 R.G.Baldwin 

Write a program named Prob01 that uses the class definition shown below and Ericson’s media library 
along with the image files named Prob0Ola.jpg and Prob0O1b.jpg to produce the graphic output images 
shown in Figure 1 (p. 2001) , Figure 2 (p. 2005) , and Figure 3 (p. 2007) below. 

Click here 18! to download a zip file containing the required image files along with the source code for a 
solution. 

Just in case you haven’t noticed it, the image in Figure 3 (p. 2007) contains a partially transparent image 
of a butterfly superimposed and centered on the beach image. 

In order to write this program, you must modify the class from Ericson’s media library named SimplePic- 
ture. Your modifications must make it possible for you to display a partially transparent image on top of 
another image with the background image showing through. The degree of transparency can range from 
being completely transparent at one extreme to being totally opaque at the other extreme. In this case, 
the butterfly image is about 37-percent opaque. Don’t forget to compile the SimplePicture class after you 
modify it. 

You will probably need to do some outside research in order to write this program. For example, you will 
need to learn about the following topics and probably some other topics as well: 


Alpha transparency 

BufferedImage objects of TYPE_INT_ARGB 
The representation of a pixel as type int. 

Bit manipulation of pixels. 

The drawImage method of the Graphics class. 


In addition to the output images described above, your program must produce the following output on 
the command-line screen, and must substitute your name for mine wherever my name appears both in 
the images and on the command-line screen: 


Dick Baldwin. 
Dick Baldwin 
Picture, filename Prob0la.jpg height 118 width 100 
Picture, filename Prob01b.jpg height 240 width 320 
Picture, filename None height 101 width 77 
FA EEEE EEEE EEE EEEE EEE EE EEE EEEE I I A 1 21 21 EE 21 21 2k 4 2 E EE EE 2 2 E / 
import java.awt.Color; 
import java.awt.Graphics; 
import java.awt. Image; 


public class Prob01{ 
//DO NOT MODIFY THE CODE IN THIS CLASS DEFINITION. 
public static void main(String[] args){ 
Picture[] pictures = new Prob01Runner() .run(); 
System. out.println(pictures[0]) ; 
System. out.println(pictures[1]) ; 
System. out.println(pictures[2]) ; 
}//end main method 
3//end class Prob01 


//End program specifications. 
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Figure 1 


. The first of three required output images for Prob01. 
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Figure 2 . The second of three required output images for Prob01. 
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Figure 3 . The third of three required output images for Prob01. 
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4.4.2.4.2.1.8.2 Program 2 


Write a program named Prob02 that uses Ericson’s media library along with the image files named 
Prob02a.jpg and Prob02b.jpg to produce the graphic output images shown in Figure 4 (p. 2013) below. 

Click here 18? to download a zip file containing the required image files along with the source code for a 
solution. 

The top image shown in Figure 4 (p. 2013) is a beach scene with a partially opaque butterfly superimposed 
on the beach scene. The bottom image is a slider that is used to control the percent opacity of the butterfly 
image. 

At startup, the slider is positioned at the 50-percent mark and the opacity of the butterfly is 50 percent. 

As you move the slider to the right, the butterfly becomes more opaque, becoming totally opaque when 
the slider is positioned at 100 percent. As you move the slider to the left, the butterfly becomes less opaque, 
becoming totally transparent when the slider is positioned at 0 percent. 

In order to write this program, you must modify the class from Ericson’s media library named SimplePic- 
ture. Your modifications must make it possible for you to display a partially transparent image on top of 
another image with the background image showing through. 

Your modification must also make it possible to display your name in the dark blue banner at the top of 
the image of the beach scene. 

The program must terminate and return control to the operating system when you click the large X in 
the upper- right corner of the GUI containing the slider. 

In order to improve the responsiveness and memory utilization of the program, you should instantiate 
all of the Picture objects that the program needs at startup, and should not instantiate additional Picture 
objects when handling events fired by the slider. 


Write a program named Prob02 that uses Ericson’s media library along with the image files named 
Prob02a.jpg and Prob02b.jpg to produce the graphic output images shown in Figure 4 (p. 2013) below. 

Click here 18? to download a zip file containing the required image files along with the source code for a 
solution. 

The top image shown in Figure 4 (p. 2013) is a beach scene with a partially opaque butterfly superimposed 
on the beach scene. The bottom image is a slider that is used to control the percent opacity of the butterfly 
image. 

At startup, the slider is positioned at the 50-percent mark and the opacity of the butterfly is 50 percent. 

As you move the slider to the right, the butterfly becomes more opaque, becoming totally opaque when 
the slider is positioned at 100 percent. As you move the slider to the left, the butterfly becomes less opaque, 
becoming totally transparent when the slider is positioned at 0 percent. 

In order to write this program, you must modify the class from Ericson’s media library named SimplePic- 
ture. Your modifications must make it possible for you to display a partially transparent image on top of 
another image with the background image showing through. 

Your modification must also make it possible to display your name in the dark blue banner at the top of 
the image of the beach scene. 

The program must terminate and return control to the operating system when you click the large X in 
the upper- right corner of the GUI containing the slider. 

In order to improve the responsiveness and memory utilization of the program, you should instantiate 
all of the Picture objects that the program needs at startup, and should not instantiate additional Picture 
objects when handling events fired by the slider. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2004 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Write a program named Prob02 that uses Ericson’s media library along with the image files named 
Prob02a.jpg and Prob02b.jpg to produce the graphic output images shown in Figure 4 (p. 2013) below. 

Click here 183 to download a zip file containing the required image files along with the source code for a 
solution. 

The top image shown in Figure 4 (p. 2013) is a beach scene with a partially opaque butterfly superimposed 
on the beach scene. The bottom image is a slider that is used to control the percent opacity of the butterfly 
image. 

At startup, the slider is positioned at the 50-percent mark and the opacity of the butterfly is 50 percent. 

As you move the slider to the right, the butterfly becomes more opaque, becoming totally opaque when 
the slider is positioned at 100 percent. As you move the slider to the left, the butterfly becomes less opaque, 
becoming totally transparent when the slider is positioned at 0 percent. 

In order to write this program, you must modify the class from Ericson’s media library named SimplePic- 
ture. Your modifications must make it possible for you to display a partially transparent image on top of 
another image with the background image showing through. 

Your modification must also make it possible to display your name in the dark blue banner at the top of 
the image of the beach scene. 

The program must terminate and return control to the operating system when you click the large X in 
the upper- right corner of the GUI containing the slider. 

In order to improve the responsiveness and memory utilization of the program, you should instantiate 
all of the Picture objects that the program needs at startup, and should not instantiate additional Picture 
objects when handling events fired by the slider. 


Listing 2 . Write the Java application described below. 


/*File Prob02 Copyright 2012 R.G.Baldwin Write a program named Prob02 that uses Ericson’s media library along with į 
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4.4.2.4.2.1.8.3 Program 3 


Write a program named Prob03 that uses Ericson’s media library along with the image file named Prob3.jpg 
to produce the graphic output images shown in Figure 5 (p. 2018) below. 

Click here 183 to download a zip file containing the required image file along with the source code for a 
solution. 

The top image shown in Figure 5 (p. 2018) is an image of a butterfly to which an edge detection algorithm 
has been applied. The bottom image is a slider that is used to control the edge-detection threshold. 

The edge-detection algorithm performs edge detection on a Picture object by rows and also by columns. 
All edges that are detected by processing adjacent pixels on a row are marked in red. All edges that are 
detected by processing adjacent pixels on a column are marked in black. If a pixel is determined to be on 
an edge using both approaches, it ends up being black. If an edge is not detected, the corresponding pixel 
is marked in white. 

At startup, the slider is positioned at the 50-percent mark and the image has been edge-detected using 
a threshold value of 50. As you move the slider to the right, the threshold increases up to a value of 100, 
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which in turn causes the amount of white area in the image to increase. As you move the slider to the left, 
the threshold decreases down to a value of zero, which in turn causes the amount of white area in the image 
to decrease. 

The program must terminate and return control to the operating system when you click the large X in 
the upper- right corner of the GUI containing the slider. 


Write a program named Prob03 that uses Ericson’s media library along with the image file named 
Prob3.jpg to produce the graphic output images shown in Figure 5 (p. 2018) below. 

Click here 183 to download a zip file containing the required image file along with the source code for a 
solution. 

The top image shown in Figure 5 (p. 2018) is an image of a butterfly to which an edge detection algorithm 
has been applied. The bottom image is a slider that is used to control the edge-detection threshold. 

The edge-detection algorithm performs edge detection on a Picture object by rows and also by columns. 
All edges that are detected by processing adjacent pixels on a row are marked in red. All edges that are 
detected by processing adjacent pixels on a column are marked in black. If a pixel is determined to be on 
an edge using both approaches, it ends up being black. If an edge is not detected, the corresponding pixel 
is marked in white. 

At startup, the slider is positioned at the 50-percent mark and the image has been edge-detected using 
a threshold value of 50. As you move the slider to the right, the threshold increases up to a value of 100, 
which in turn causes the amount of white area in the image to increase. As you move the slider to the left, 
the threshold decreases down to a value of zero, which in turn causes the amount of white area in the image 
to decrease. 

The program must terminate and return control to the operating system when you click the large X in 
the upper- right corner of the GUI containing the slider. 


Write a program named Prob03 that uses Ericson’s media library along with the image file named 
Prob3.jpg to produce the graphic output images shown in Figure 5 (p. 2018) below. 

Click here 184 to download a zip file containing the required image file along with the source code for a 
solution. 

The top image shown in Figure 5 (p. 2018) is an image of a butterfly to which an edge detection algorithm 
has been applied. The bottom image is a slider that is used to control the edge-detection threshold. 

The edge-detection algorithm performs edge detection on a Picture object by rows and also by columns. 
All edges that are detected by processing adjacent pixels on a row are marked in red. All edges that are 
detected by processing adjacent pixels on a column are marked in black. If a pixel is determined to be on 
an edge using both approaches, it ends up being black. If an edge is not detected, the corresponding pixel 
is marked in white. 

At startup, the slider is positioned at the 50-percent mark and the image has been edge-detected using 
a threshold value of 50. As you move the slider to the right, the threshold increases up to a value of 100, 
which in turn causes the amount of white area in the image to increase. As you move the slider to the left, 
the threshold decreases down to a value of zero, which in turn causes the amount of white area in the image 
to decrease. 

The program must terminate and return control to the operating system when you click the large X in 
the upper- right corner of the GUI containing the slider. 


Listing 3 . Write the Java application described below. 


/*File Prob03 Copyright 2012 R.G.Baldwin Write a program named Prob03 that uses Ericson’s media library along with į 
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Figure 5 . Required output images for Prob03. 


iwin -(5] x} 
Edge Detection Threshold 


——— S e, 


0 10 20 30 40 50 60 70 30 90100 


Table 4.438 


4.4.2.4.2.1.8.4 Program 4 


Write a program named Prob04 that uses Ericson’s media library along with the image files named 
Prob04a.jpg and Prob04b.jpg to produce the graphic output images shown in Figure 6 (p. 2023) and 
Figure 7 (p. 2027) below. 

Click here 184 to download a zip file containing the required image files along with the source code for a 
solution. 

The top image shown in Figure 6 (p. 2023) is a butterfly image. The image immediately below that one 
is a slider that is used to control a scale factor that is applied to an image of a beach. 

At startup, the slider is positioned at the zero-percent mark (at the far left) and the beach image is too 
small to be seen in the upper-left corner of the butterfly image. 

As you move the slider to the right, an image of a beach emerges from the upper-left corner covering the 
image of the butterfly. 

Figure 7 (p. 2027) shows the result of moving the slider to the 50-percent mark. 
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The size of the beach image increases and decreases smoothly as you move the slider back and forth. The 
upper- left corner of the beach image is always in the upper- left corner of the butterfly image. The butterfly 
becomes completely covered by the beach image when the slider is positioned at 100 percent (the far right) 


The program must terminate and return control to the operating system when you click the large X in 
the upper- right corner of the GUI containing the slider. 


Write a program named Prob04 that uses Ericson’s media library along with the image files named 
Prob04a.jpg and Prob04b.jpg to produce the graphic output images shown in Figure 6 (p. 2023) and Figure 
7 (p. 2027) below. 

Click here 184 to download a zip file containing the required image files along with the source code for a 
solution. 

The top image shown in Figure 6 (p. 2023) is a butterfly image. The image immediately below that one 
is a slider that is used to control a scale factor that is applied to an image of a beach. 

At startup, the slider is positioned at the zero-percent mark (at the far left) and the beach image is too 
small to be seen in the upper-left corner of the butterfly image. 

As you move the slider to the right, an image of a beach emerges from the upper-left corner covering the 
image of the butterfly. 

Figure 7 (p. 2027) shows the result of moving the slider to the 50-percent mark. 

The size of the beach image increases and decreases smoothly as you move the slider back and forth. The 
upper- left corner of the beach image is always in the upper- left corner of the butterfly image. The butterfly 
becomes completely covered by the beach image when the slider is positioned at 100 percent (the far right) 


The program must terminate and return control to the operating system when you click the large X in 
the upper- right corner of the GUI containing the slider. 


Write a program named Prob04 that uses Ericson’s media library along with the image files named 
Prob04a.jpg and Prob04b.jpg to produce the graphic output images shown in Figure 6 (p. 2023) and Figure 
7 (p. 2027) below. 

Click here !8° to download a zip file containing the required image files along with the source code for a 
solution. 

The top image shown in Figure 6 (p. 2023) is a butterfly image. The image immediately below that one 
is a slider that is used to control a scale factor that is applied to an image of a beach. 

At startup, the slider is positioned at the zero-percent mark (at the far left) and the beach image is too 
small to be seen in the upper-left corner of the butterfly image. 

As you move the slider to the right, an image of a beach emerges from the upper-left corner covering the 
image of the butterfly. 

Figure 7 (p. 2027) shows the result of moving the slider to the 50-percent mark. 

The size of the beach image increases and decreases smoothly as you move the slider back and forth. The 
upper- left corner of the beach image is always in the upper- left corner of the butterfly image. The butterfly 
becomes completely covered by the beach image when the slider is positioned at 100 percent (the far right) 


The program must terminate and return control to the operating system when you click the large X in 
the upper- right corner of the GUI containing the slider. 
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Listing 4 . Write the Java application described below. 


/*File Prob04 Copyright 2012 R.G.Baldwin Write a program named Prob04 that uses Ericson’s media library along with i 
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Figure 7 . Required output image for Prob04. 
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4.4.2.4.2.1.8.5 Program 5 


Write a program named Prob05 that uses Ericson’s media library along with the image file named Prob05.jpg 
to produce the graphic output images shown in Figure 8 (p. 2032) and Figure 9 (p. 2036) below. 

Click here 185 to download a zip file containing the required image file along with the source code for a 
solution. 

The top image in Figure 8 (p. 2032) is a butterfly image. The image of the butterfly can be rotated in 
its picture by any angle ranging from -360 degrees to +360 degrees. 

The image immediately below that one is a slider that is used to control the rotation angle that is applied 
to the butterfly image. 

At startup, the slider is positioned at the zero-degrees mark (in the center) and the butterfly image is 
displayed with no rotation. As you move the slider to the right, the butterfly image rotates clockwise around 
its center through an angle that can be as large as 360 degrees. 

Figure 9 (p. 2036) shows the result of moving the slider to the +120-degree mark. 
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As you move the slider to the left, the butterfly image rotates counter-clockwise around its center through 
an angle that can be as large as -360 degrees. 

The butterfly image rotates smoothly around its center as you move the slider back and forth. 

The program must terminate and return control to the operating system when you click the large X in 
the upper- right corner of the GUI containing the slider. 


Write a program named Prob05 that uses Ericson’s media library along with the image file named 
Prob05.jpg to produce the graphic output images shown in Figure 8 (p. 2032) and Figure 9 (p. 2036) below. 

Click here 185 to download a zip file containing the required image file along with the source code for a 
solution. 

The top image in Figure 8 (p. 2032) is a butterfly image. The image of the butterfly can be rotated in 
its picture by any angle ranging from -360 degrees to +360 degrees. 

The image immediately below that one is a slider that is used to control the rotation angle that is applied 
to the butterfly image. 

At startup, the slider is positioned at the zero-degrees mark (in the center) and the butterfly image is 
displayed with no rotation. As you move the slider to the right, the butterfly image rotates clockwise around 
its center through an angle that can be as large as 360 degrees. 

Figure 9 (p. 2036) shows the result of moving the slider to the +120-degree mark. 

As you move the slider to the left, the butterfly image rotates counter-clockwise around its center through 
an angle that can be as large as -360 degrees. 

The butterfly image rotates smoothly around its center as you move the slider back and forth. 

The program must terminate and return control to the operating system when you click the large X in 
the upper- right corner of the GUI containing the slider. 


Write a program named Prob05 that uses Ericson’s media library along with the image file named 
Prob05.jpg to produce the graphic output images shown in Figure 8 (p. 2032) and Figure 9 (p. 2036) below. 

Click here 186 to download a zip file containing the required image file along with the source code for a 
solution. 

The top image in Figure 8 (p. 2032) is a butterfly image. The image of the butterfly can be rotated in 
its picture by any angle ranging from -360 degrees to +360 degrees. 

The image immediately below that one is a slider that is used to control the rotation angle that is applied 
to the butterfly image. 

At startup, the slider is positioned at the zero-degrees mark (in the center) and the butterfly image is 
displayed with no rotation. As you move the slider to the right, the butterfly image rotates clockwise around 
its center through an angle that can be as large as 360 degrees. 

Figure 9 (p. 2036) shows the result of moving the slider to the +120-degree mark. 

As you move the slider to the left, the butterfly image rotates counter-clockwise around its center through 
an angle that can be as large as -360 degrees. 

The butterfly image rotates smoothly around its center as you move the slider back and forth. 

The program must terminate and return control to the operating system when you click the large X in 
the upper- right corner of the GUI containing the slider. 


Listing 5 . Write the Java application described below. 


/*File Prob05 Copyright 2012 R.G.Baldwin Write a program named Prob05 that uses Ericson’s media library along with i 
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Figure 8 . Required output image for Prob05. 
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Figure 9 . Required output image for Prob05. 
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4.4.2.4.2.2 Miscellaneous Information 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java OOP: ITSE 2317 Practice Test 2 
e File: PracticeTest02.htm 

e Published: August 10, 2012 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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4.4.2.4.3 Java OOP: ITSE 2317 Practice Programs gr% 
4.4.2.4.3.1 ITSE2317 - Java Programming (Intermediate) - Practice Test 3 


Java and Media Library Version Requirements (p. 2038) 
Input Image Files (p. 2038) 

Solution source code files (p. 2038) 

Output Images (p. 2038) 

Hints (p. 2038) 

Testing Your Programs (p. 2039) 

Program Specifications (p. 2039) 


Program 1 (p. 2039) 
Program 2 (p. 2043) 
Program 3 (p. 2049) 
Program 4 (p. 2050) 
Program 5 (p. 2054) 


e Miscellaneous Information (p. 2059) 


4.4.2.4.3.1.1 Java and Media Library Version Requirements 


Your programs must be compatible with Sun’s Standard Edition JDK Version 1.7 or later. 

Some of the programs on this test require you to use the Guzdial-Ericson multimedia class library. You 
will find download, installation, and usage instructions for the library at Java OOP: The Guzdial-Ericson 
Multimedia Class Library 187 . 


4.4.2.4.3.1.2 Input Image Files 
Links are provided within the individual program specifications for downloading zip files that contain any 
image files that may be required to write, compile, and test your programs. 


4.4.2.4.3.1.3 Solution source code files 


The downloadable zip files mentioned above also contains source code files for the programming solutions. 
You can compile and execute those programs using procedures described in Java OOP: The Guzdial-Ericson 
Multimedia Class Library 188 . 


4.4.2.4.3.1.4 Output Images 


Your output image(s) must match my output image(s) in every respect including color, size, position, etc. 
Don’t forget to display your name in the output image(s) as shown. 


4.4.2.4.3.1.5 Hints 


For some of the programs, you may first need to deduce the algorithm used to transform the input image 
into the output image, and then write a working program that implements that algorithm. In some cases, 
you may need to compare numeric color values for corresponding pixels in the input and output images in 
order to deduce the algorithm. 

You can obtain those color values using the following procedure: 


186 This content is available online at <http://cnx.org/content /m44262/1.3/>. 
187http://cnx.org/content /m44148/latest / 
188http://cnx.org/content /m44148 /latest / 
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1. Click the download link for the zip files that contain input image files and solution source code files. 
Use the capabilities of your browser to download and save the contents of those zip files. 

2. If necessary, replace calls to the show method in my source code with calls to the explore method 
to force the program to display the output images ina PictureExplorer window. 

3. Compile and run the source code. 

4. Write, compile, and run a simple Java program that will display each input image file in a Picture- 
Explorer window. 

5. Use the input and output PictureExplorer windows to compare the input and output color values 
on a pixel by pixel basis. 


You may find other useful hints in my online tutorials and slides for this course. 


4.4.2.4.3.1.6 Testing Your Programs 


You can compile and execute your program by following the instructions given at Java OOP: The Guzdial- 
Ericson Multimedia Class Library 18° . 


4.4.2.4.3.1.7 Program Specifications 
4.4.2.4.3.1.7.1 Program 1 


Write a program named Prob01 that uses Ericson’s media library along with the image file named Prob0la.jpg 
to produce the graphic output image shown in Figure 1 (p. 2043) below. 

Click here 19° to download a zip file containing the required image file along with the source code for a 
solution. 

When the program first starts running, only the GUI containing the text field is visible. When you type 
the file name into the text field and press Enter, the image of the penguin appears and the GUI moves to 
a position below the image of the penguin. The program terminates and returns control to the operating 
system when you click the X in the upper-right corner of the GUI. 


Write a program named Prob01 that uses Ericson’s media library along with the image file named 
Prob01la.jpg to produce the graphic output image shown in Figure 1 (p. 2043) below. 

Click here 19° to download a zip file containing the required image file along with the source code for a 
solution. 

When the program first starts running, only the GUI containing the text field is visible. When you type 
the file name into the text field and press Enter, the image of the penguin appears and the GUI moves to 
a position below the image of the penguin. The program terminates and returns control to the operating 
system when you click the X in the upper-right corner of the GUI. 


Write a program named Prob01 that uses Ericson’s media library along with the image file named 
Prob0la.jpg to produce the graphic output image shown in Figure 1 (p. 2043) below. 

Click here 1°! to download a zip file containing the required image file along with the source code for a 
solution. 

When the program first starts running, only the GUI containing the text field is visible. When you type 
the file name into the text field and press Enter, the image of the penguin appears and the GUI moves to 
a position below the image of the penguin. The program terminates and returns control to the operating 
system when you click the X in the upper-right corner of the GUI. 


189http://cnx.org/content /m44148/latest / 
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Listing 1 . Write the Java application described below. 


/*File Prob01 Copyright 2012 R.G.Baldwin Write a program named Prob01 that uses Ericson’s media library along with | 


Table 4.445 
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Figure 1 . Required output images for Prob01. 
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4.4.2.4.3.1.7.2 Program 2 


Write a program named Prob02 that uses Ericson’s media library along with the image file named Prob02.jpg 
to produce the graphic output images shown in Figure 2 (p. 2048) below. 

Click here 1°! to download a zip file containing the required image file along with the source code for a 
solution. 
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Whenever you click the button in the GUI in the lower image, the green color component value at the 
location of the crosshair cursor in the upper image is displayed in the text field in the GUI. 


Write a program named Prob02 that uses Ericson’s media library along with the image file named 
Prob02.jpg to produce the graphic output images shown in Figure 2 (p. 2048) below. 

Click here 1°! to download a zip file containing the required image file along with the source code for a 
solution. 

Whenever you click the button in the GUI in the lower image, the green color component value at the 
location of the crosshair cursor in the upper image is displayed in the text field in the GUI. 


Write a program named Prob02 that uses Ericson’s media library along with the image file named 
Prob02.jpg to produce the graphic output images shown in Figure 2 (p. 2048) below. 

Click here 1°? to download a zip file containing the required image file along with the source code for a 
solution. 

Whenever you click the button in the GUI in the lower image, the green color component value at the 
location of the crosshair cursor in the upper image is displayed in the text field in the GUI. 


Listing 2 . Write the Java application described below. 


/*File Prob02 Copyright 2012 R.G.Baldwin Write a program named Prob02 that uses Ericson’s media library along with 1 
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Figure 2 . Required output images for Prob02. 
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4.4.2.4.3.1.7.3 Program 3 


Write a program named Prob03 that uses Ericson’s media library to produce the graphic output image shown 
in Figure 3 (p. 2050) below. 

Click here 19? to download a zip file containing the source code for a solution. 

Whenever you click the button in the GUI, the square in the upper right turns from black to yellow with 
a black border and the RGB color values for the color yellow appear in the three text fields. 


Write a program named Prob03 that uses Ericson’s media library to produce the graphic output image 
shown in Figure 3 (p. 2050) below. 

Click here 1°? to download a zip file containing the source code for a solution. 

Whenever you click the button in the GUI, the square in the upper right turns from black to yellow with 
a black border and the RGB color values for the color yellow appear in the three text fields. 


Write a program named Prob03 that uses Ericson’s media library to produce the graphic output image 
shown in Figure 3 (p. 2050) below. 

Click here 19? to download a zip file containing the source code for a solution. 

Whenever you click the button in the GUI, the square in the upper right turns from black to yellow with 
a black border and the RGB color values for the color yellow appear in the three text fields. 


Listing 3 . Write the Java application described below. 


/*File Prob03 Copyright 2012 R.G.Baldwin Write a program named Prob03 that uses Ericson’s media library to produce 
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Figure 3 . Required output image for Prob03. 
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4.4.2.4.3.1.7.4 Program 4 


Write a program named Prob04 that uses Ericson’s media library to produce the graphic output images 
shown in Figure 4 (p. 2054) below. 

Click here 19? to download a zip file containing the source code for a solution. 

Whenever you click the "Choose Color" button in the GUI in the upper image, the color chooser dialog 
shown in the lower image appears. When you select a color and click the OK button, the color chooser dialog 
disappears and that color appears in the square in the upper right portion of the GUI. In addition, the red, 
green, and blue color component values for that color appear in the corresponding text fields. 

Whenever you click the "Brighter" and "Darker" buttons, the color displayed in the square becomes 
brighter or darker and the color values in the text fields change accordingly. 


Write a program named Prob04 that uses Ericson’s media library to produce the graphic output images 
shown in Figure 4 (p. 2054) below. 

Click here 19? to download a zip file containing the source code for a solution. 

Whenever you click the "Choose Color" button in the GUI in the upper image, the color chooser dialog 
shown in the lower image appears. When you select a color and click the OK button, the color chooser dialog 
disappears and that color appears in the square in the upper right portion of the GUI. In addition, the red, 
green, and blue color component values for that color appear in the corresponding text fields. 

Whenever you click the "Brighter" and "Darker" buttons, the color displayed in the square becomes 
brighter or darker and the color values in the text fields change accordingly. 
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Write a program named Prob04 that uses Ericson’s media library to produce the graphic output images 
shown in Figure 4 (p. 2054) below. 

Click here 1°94 to download a zip file containing the source code for a solution. 

Whenever you click the "Choose Color" button in the GUI in the upper image, the color chooser dialog 
shown in the lower image appears. When you select a color and click the OK button, the color chooser dialog 
disappears and that color appears in the square in the upper right portion of the GUI. In addition, the red, 
green, and blue color component values for that color appear in the corresponding text fields. 

Whenever you click the "Brighter" and "Darker" buttons, the color displayed in the square becomes 
brighter or darker and the color values in the text fields change accordingly. 


Listing 4 . Write the Java application described below. 


/*File Prob04 Copyright 2012 R.G.Baldwin Write a program named Prob04 that uses Ericson’s media library to produce 
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Figure 4 . Required output images for Prob04. 
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4.4.2.4.3.1.7.5 Program 5 


Write a program named Prob05 that uses Ericson’s media library along with the image file named Prob05.jpg 
to produce the graphic output images shown in Figure 5 (p. 2059) below. 

Click here 194 to download a zip file containing the required image file along with the source code for a 
solution. 

The color in the square in the upper right of the GUI in the lower image is governed by the color values 
in the red, green, and blue text fields. 

Whenever you click the button in the GUI, the pixel at the crosshair cursor in the upper image is changed 
to reflect the color in the square in the GUI. This can best be seen when the upper image is zoomed to 500%. 


Write a program named Prob05 that uses Ericson’s media library along with the image file named 
Prob05.jpg to produce the graphic output images shown in Figure 5 (p. 2059) below. 

Click here 194 to download a zip file containing the required image file along with the source code for a 
solution. 

The color in the square in the upper right of the GUI in the lower image is governed by the color values 
in the red, green, and blue text fields. 
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Whenever you click the button in the GUI, the pixel at the crosshair cursor in the upper image is changed 
to reflect the color in the square in the GUI. This can best be seen when the upper image is zoomed to 500%. 


Write a program named Prob05 that uses Ericson’s media library along with the image file named 
Prob05.jpg to produce the graphic output images shown in Figure 5 (p. 2059) below. 

Click here 1°° to download a zip file containing the required image file along with the source code for a 
solution. 

The color in the square in the upper right of the GUI in the lower image is governed by the color values 
in the red, green, and blue text fields. 

Whenever you click the button in the GUI, the pixel at the crosshair cursor in the upper image is changed 
to reflect the color in the square in the GUI. This can best be seen when the upper image is zoomed to 500%. 


Listing 5 . Write the Java application described below. 


/*File Prob05 Copyright 2012 R.G.Baldwin Write a program named Prob05 that uses Ericson’s media library along with 1 
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Figure 5 . Required output image for Prob05. 
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4.4.2.4.3.2 Miscellaneous Information 


This section contains a variety of miscellaneous information. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2055 


Housekeeping material 


e Module name: Java OOP: ITSE 2317 Practice Test 3 
e File: PracticeTest03.htm 

e Published: August 9, 2012 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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4.4.3 Jy0037: Review Event Handling” 
4.4.3.1 Table of Contents 


e Preface (p. 2061) 
e Questions (p. 2061) 


1 (p. 2061) , 2 (p. 2061) , 3 (p. 2061) , 4 (p. 2062) , 5 (p. 2062) , 6 (p. 2062) , 7 (p. 2062) , 8 
(p. 2062) , 9 (p. 2062) , 10 (p. 2062) , 11 (p. 2062) , 12 (p. 2062) , 13 (p. 2063) , 14 (p. 2063) 
, 15 (p. 2063) , 16 (p. 2063) , 17 (p. 2065) , 18 (p. 2067) , 19 (p. 2067) , 20 (p. 2069) , 21 (p. 
2071) , 22 (p. 2073) , 23 (p. 2073) , 24 (p. 2075) , 25 (p. 2077) , 26 (p. 2077) , 27 (p. 2077) , 28 
(p. 2077) , 29 (p. 2079) , 30 (p. 2081) , 31 (p. 2083) , 32 (p. 2085) , 33 (p. 2087) , 34 (p. 2089) 
, 35 (p. 2091) , 36 (p. 2093) , 37 (p. 2095) 


e Listings (p. 2097) 
e Answers (p. 2098) 
e Miscellaneous (p. 2102) 


4.4.3.2 Preface 


This module contains a non-exhaustive set of review questions and answers keyed to the material in the 
Event Handling sub-collection. The questions are heavily weighted toward the tutorials listed in Jy0035: 
Java OOP: Preface to Event Handling !°° and the seven modules that begin with Java OOP: The AWT and 
Swing, A Preview 19” in the sub-collection titled Essence of OOP 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 

These questions are similar to many of the questions on the online Blackboard test for Event Handling in 
ITSE 2317. When you take the test in the testing center, you will only have access to the computer screen, a 
pencil, and a sheet of scratch paper. You might benefit by limiting yourself to only those tools as you study 
this material to get used to working under those limitations. 


4.4.3.3 Questions 

4.4.3.3.1 Question 1 

True or False: AWT is the abbreviation for Abstract Windows Toolkit . 
Answer 1 (p. 2102) 

4.4.3.3.2 Question 2 

True or False: GUI is the abbreviation for the Graphical User Interface. 
Answer 2 (p. 2102) 

4.4.3.3.3 Question 3 


True or False: There are two primary packages that are used for GUI programming in Java SE 7. 


e java.awt.* 
e com.sun.java.swing.* 


Answer 3 (p. 2102) 


195This content is available online at <http://cnx.org/content /m47927/1.4/>. 
196http://cnx.org/content /m47842/latest /?collection=col11441 /latest 
'97http://cnx.org/content /m44331 /latest /?collection=col11441/latest 
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4.4.3.3.4 Question 4 


True or False: When it was released, Swing was a replacement for the AWT. 
Answer 4 (p. 2102) 


4.4.3.3.5 Question 5 


True or False: A callback mechanism is a mechanism where a method in one object asks a method in 
another object to "call me back" or "notify me" when an interesting event happens. 
Answer 5 (p. 2102) 


4.4.3.3.6 Question 6 


True or False: Many different objects may ask one object to notify them when the interesting event happens. 
This is sometimes referred to as unicasting . 
Answer 6 (p. 2102) 


4.4.3.3.7 Question 7 


True or False: API is an abbreviation for Application Programming Interface. 
Answer 7 (p. 2102) 


4.4.3.3.8 Question 8 


Given: The event model that has been in use since Java version 1.1 is sometimes called the Delegation Event 
Model and is sometimes called the JavaBeans Event Model. (It may be called by other names as well.) 
Although there was an earlier model, the Delegation Event Model is the event model to which the questions 
in this review module apply. 

True or False: The event model makes use of event sources and event listeners 

Answer 8 (p. 2102) 


4.4.3.3.9 Question 9 


True or False: An event listener is an object that has the ability to determine when an interesting event 
has occurred, and to notify source objects of the occurrence of the event. 
Answer 9 (p. 2101) 


4.4.3.3.10 Question 10 


True or False: A listener object is an instance of a class (or instance of a subclass of a class) that 
implements a specific listener interface . 
Answer 10 (p. 2101) 


4.4.3.3.11 Question 11 


True or False: A number of listener interfaces are defined where each interface declares the methods ap- 
propriate for a specific class of events. Thus, there is natural pairing of classes of events and interface 
definitions. 

Answer 11 (p. 2101) 


4.4.3.3.12 Question 12 


True or False: There is a class of mouse events that includes most of the events normally associated with 
mouse action and there is a matching source definition that is used to define a listener class for those events. 
Answer 12 (p. 2101) 
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4.4.3.3.13 Question 13 


True or False: A listener object can be registered on a source object to be notified of the occurrence of all 
events of the specific class for which the listener object is designed. 
Answer 13 (p. 2101) 


4.4.3.3.14 Question 14 


True or False: Once a listener object is registered to be notified of all events of the specific class for which the 
listener object is designed, the occurrence of such an event will automatically invoke the matching method 
in the listener object. The code in the body of the method is designed by the programmer to perform the 
desired action when the event occurs. 

Answer 14 (p. 2101) 


4.4.3.3.15 Question 15 


True or False: In many cases, the same goal can be achieved by either implementing a listener interface or 
extending a corresponding adapter class. 
Answer 15 (p. 2101) 


4.4.3.3.16 Question 16 


True or False: The program shown below will compile and run successfully. When it starts running, it 
displays a small window and also displays the following on the command-line screen: 

WProcl windowActivated test msg 

WProcl windowOpened test msg 

Whenever the small window loses the focus, the following is displayed on the command-line screen: 

WProcl windowDeactivated test msg 

Whenever the small window gains the focus, the following is displayed on the command-line screen: 

WProcl windowActivated test msg 

Whenever the user clicks the X-button, the small window disappears and the following is displayed on 
the command-line screen. 

WProcl windowClosing test msg 

WProcl windowDeactivated test msg 

WProcl windowClosed test msg 
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Listing 1 . Question 16. 


/*File Q16.java 

FE AG EEE EEEE EEEE E EE EEEE AI I I I EE EEE 21 21 21 EEE E a 4 2k 2 a EE EA 
import java.awt.*; 

import java.awt.event.*; 


public class Q16 { 
public static void main(String[] args){ 
GUI gui = new GUI();//instantiate a GUInterface object 
}//end main 
}//end class Q16 


class GUI{ 
public GUI( {//constructor 
//Create a new Frame object 
Frame displayWindow = new Frame(); 
displayWindow. setSize (300, 200) ; 
displayWindow.setTitle("Q16") ; 


WProc1 winProcCmdi = new WProci(displayWindow) ; 
displayWindow.addWindowListener (winProcCmd1) ; 
displayWindow.setVisible(true) ; 
}//end constructor 
}//end class GUI definition 


class WProci implements WindowListener{ 
Frame displayWindowRef ; 


WProci(Frame windowIn){//constructor 
this.displayWindowRef = windowIn; 
3//end constructor 


public void windowClosed(WindowEvent e){ 
System.out.println("WProci windowClosed test msg"); 
}//end windowClosed() 


public void windowIconified(WindowEvent e){ 
System.out.println("WProci windowIconified test msg"); 
}//end windowIconified() 


public void windowOpened (WindowEvent e){ 
System.out.println("WProci windowOpened test msg"); 
}//end windowOpened () 


public void windowClosing(WindowEvent e){ 

System. out .println("WProc1 windowClosing test msg"); 

displayWindowRef .dispose() ;//generate WindowClosed 
}//end windowClosing() 

Available for free at Connexions <http://cnx.org/content/col11441/1.181> 

public void windowDeiconified(WindowEvent e){ 

System. out .print1n( 

"“WProci windowDeiconified test msg"); 

}//end windowDeiconified() 
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Table 4.455 


Answer 16 (p. 2101) 


4.4.3.3.17 Question 17 


True or False: The program shown below will compile and run successfully. When it starts running, it 
displays a small window and doesn’t display anything on the command-line screen. 

Whenever the small window is iconified to the system try, the following is displayed on the command-line 
screen: 

*AKEAAEK WI Proc2 windowlconified test msg 

Whenever the small window is deiconified from the system try, the following is displayed on the command- 
line screen: 

*AKKAAAK VWI Proc2 windowDeiconified test msg 

Nothing happens when the user clicks the X-button. The program does not terminate and does not 
return control to the operating system. 
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Listing 2 . Question 17. 


/*File Q17.java Copyright 1997, R.G.Baldwin 
FE AG EEE EEEE EEEE E EEEE EE aK I I 1 E 21 1 4 21 21 2 EEE E E EE 2 ak ak kak / 


import java.awt.*; 
import java.awt.event.*; 


public class Q17 { 
public static void main(String[] args){ 
GUI gui = new GUI();//instantiate a GUInterface object 
}//end main 
3//end class Q17 


class GUI{ 
public GUI(Q {//constructor 
//Create a new Frame object 
Frame displayWindow = new Frame(); 
displayWindow. setSize (300, 200) ; 
displayWindow.setTitle("Q17") ; 


WProc2 winProcCmd2 = new WProc2(); 
displayWindow.addWindowListener (winProcCmd2) ; 
displayWindow.setVisible(true) ; 


}//end constructor 
}//end class GUI definition 


class WProc2 extends WindowAdapter{ 


public void windowIconified(WindowEvent e){ 
System. out. print1n( 
"xkxkkkkkk WProc2 windowIconified test msg"); 
3//end windowIconified() 


public void windowDeiconified(WindowEvent e){ 
System. out .print1n( 
"xkkkkkkk WProc2 windowDeiconified test msg"); 
}//end windowDeiconified() 


}//end class WProc2 


Table 4.456 


Answer 17 (p. 2101) 
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4.4.3.3.18 Question 18 


True or False: The default layout manager for a Frame object is FlowLayout 
Answer 18 (p. 2101) 


4.4.3.3.19 Question 19 


True or False: The program shown below displays a small Frame object on the computer screen. When the 
user clicks the mouse inside the Frame object, the mouse coordinates are displayed near the mouse pointer. 

When the user clicks the X-button in the upper right corner of the Frame, the program terminates and 
returns control to the operating system. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2063 


Listing 3 . Question 19. 


/*File Q19.java 

*/ 

import java.awt.*; 
import java.awt.event.*; 


public class Q19 { 
public static void main(String[] args){ 
GUI gui = new GUI(); 
}//end main 
3//end class Q19 


class MyFrame extends Framef{ 
int clickX; 
int clickY; 


public void paint (Graphics g){ 
g.drawString( 
"" + clickX + ", " + clickY, clickX, clickY); 
}//end paint () 
}//end class MyFrame 


class GUI { 
public GUIQ {//constructor 
MyFrame displayWindow = new MyFrame(); 
displayWindow. setSize (300, 300); 
displayWindow.setTitle("Q19") ; 
displayWindow.setVisible(true) ; 


displayWindow.addWindowListener (new WProc1()); 
displayWindow. addMouseListener ( 
new MProci(displayWindow) ) ; 
}//end constructor 
}//end class GUI definition 


class MProci extends MouseAdapter{ 
MyFrame refToWin; //save a reference to the window here 


MProci(MyFrame inWin){//constructor 
refToWin = inWin;//save ref to window 
}//end constructor 


public void mousePressed(MouseEvent e){ 
refToWin.clickX = e.getX(); 
refToWin.clickY = e.getY(); 
refToWin.repaint (); 

}//end mousePressed() 


}//end class MProgtailable for free at Connexions <http://cnx.org/content /coll1441/1.181> 


class WProci extends WindowAdapter{ 
public void windowClosed(WindowEvent e){ 
Svstem.exit(0); 
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Table 4.457 


Answer 19 (p. 2100) 


4.4.3.3.20 Question 20 


True or False: The program shown below will compile and run successfully. When it starts running, it 
displays a small JFrame window and doesn’t display anything on the command-line screen. 

Whenever the small window is iconified to the system try, the following is displayed on the command-line 
screen: 

*AKKAAEK WProc2 windowlconified test msg 

Whenever the small window is deiconified from the system try, the following is displayed on the command- 
line screen: 

*AKKAAEK WProc2 windowDeiconified test msg 

When the user clicks the X-button, the program terminates and returns control to the operating system. 
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Listing 4 . Question 20. 


/*File Q20.java 
LEETEEEEEEEEEEEEEEEEEEEEEEEEE EEE EE EEEE EEEE EEE EEEE EEEE EEEE EN 


import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 


public class Q20 { 
public static void main(String[] args){ 
GUI gui = new GUI();//instantiate a GUInterface object 
}//end main 
3//end class Q20 


class GUI{ 
public GUI(Q {//constructor 
JFrame displayWindow = new JFrame(); 
displayWindow. setSize (300, 200) ; 
displayWindow.setTitle("Q20") ; 
//Following is available in recent Java versions 
displayWindow. setDefaultClose0peration ( 
JFrame .EXIT_ON_CLOSE) ; 
displayWindow.addWindowListener (new WProc2()); 
displayWindow.setVisible(true) ; 


}//end constructor 
}//end class GUI definition 


class WProc2 extends WindowAdapter{ 
public void windowIconified(WindowEvent e){ 
System. out.print1n( 
"xkxkkkkkk WProc2 windowIconified test msg"); 
3//end windowIconified() 


public void windowDeiconified(WindowEvent e){ 
System. out .print1n( 
"xkkkkkkk WProc2 windowDeiconified test msg"); 
}//end windowDeiconified() 
}//end class WProc2 


Table 4.458 


Answer 20 (p. 2100) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2066 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


4.4.3.3.21 Question 21 


True or False: The program shown below displays a small JFrame object on the computer screen. When the 
user clicks the mouse inside the JFrame object, the mouse coordinates are displayed near the mouse pointer. 
Old coordinates are erased and new coordinates are displayed with each successive mouse click. 

When the user clicks the X-button in the upper right corner of the Frame, the program terminates and 
returns control to the operating system. 
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Listing 5 . Question 21. 


/*File Q21.java 
DEEE EEEE E EEEE EEE EEEE EEE EEEE EEE EEE EEEE EEE EEE EE EEE EEEE EEEE EEA 
import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 
public class Q21 { 

public static void main(String[] args){ 

GUI gui = new GUI();//instantiate a GUI 

}//end main 

}//end class Q21 


class MyFrame extends JFramef{ 
int clickX; 
int clickY; 


public void paint (Graphics g){ 
g.drawString( 
"" + clickX + ", " + clickY, clickX, clickY); 
}//end paint () 
}//end class MyFrame 


class GUI { 
public GUI(Q {//constructor 
MyFrame displayWindow = new MyFrame(); 
displayWindow. setSize (300, 300); 
displayWindow.setTitle("Q21") ; 
displayWindow.setVisible(true) ; 
displayWindow. setDefaultClose0peration ( 
JFrame .EXIT_ON_CLOSE) ; 
displayWindow. addMouseListener ( 
new MouseProc(displayWindow) ) ; 
}//end constructor 
3//end class GUI definition 


class MouseProc extends MouseAdapter{ 
MyFrame refToWin; //save a reference to the source here 


MouseProc(MyFrame inWin){//constructor 
refToWin = inWin;//save ref to window 
}//end constructor 


public void mousePressed(MouseEvent e){ 
refToWin.clickX = e.getX(); 


refToWin.clickY = e.getY(); 
refToWin.repaint (); 


}//end mousePresg@mbhe for free at Connexions <http://cnx.org/content /coll1441/1.181> 


}//end class MouseProc 
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Table 4.459 


Answer 21 (p. 2100) 


4.4.3.3.22 Question 22 


True or False: There must always be a one-to-one correspondence between source objects and listener objects. 
Answer 22 (p. 2100) 


4.4.3.3.23 Question 23 


True or False: The program shown below displays two small Frame objects side-by-side on the computer 
screen. Clicking inside either Frame object causes the mouse coordinates to be displayed in that Frame 
object relative to the upper-left corner of the Frame object. 

Clicking the X-button on either Frame object causes that Frame object to disappear from the computer 
screen. Clicking the X-button on both Frame objects causes both Frame objects to disappear and causes 
the program to terminate returning control to the operating system. 
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Listing 6 . Question 23. 


/*File Q23.java 
*/ 


import java.awt.*; 
import java.awt.event.*; 


public class Q23 { 
public static void main(String[] args){ 
GUI gui = new GUI(); 
}//end main 
3//end class Q23 


class MyFrame extends Framef{ 
int xCoor; 
int yCoor; 


MyFrame() {//constructor 
setTitle("Q3"); 
setSize (200,200) ; 

}//end constructor 


public void paint (Graphics g){ 
g.drawString("" + xCoor + ", " + yCoor, xCoor, yCoor); 
}//end paint () 
}//end class MyFrame 


class GUI { 
public GUIQ {//constructor 


MyFrame myFramel = new MyFrame(); 
myFramel.setVisible(true) ; 


MyFrame myFrame2 = new MyFrame(); 
myFrame2.setLocation(201,0); 
myFrame2.setVisible(true) ; 


WProci winProcCmdi = new WProci(); 
myFramei1 .addWindowListener (winProcCmd1) ; 
myFrame2.addWindowListener (winProcCmd1) ; 


MouseProc mouseProcCmd = new MouseProc(); 
myFramei1 .addMouseListener (mouseProcCmd) ; 
myFrame2.addMouseListener (mouseProcCmd) ; 
}//end constructor 
}//end class GUI definition 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
class MouseProc extends MouseAdapter{ 
public void mousePressed(MouseEvent e){ 
((MyFrame)e.getComponent ()).xCoor = e.getX(); 
((MyFrame)e.getSource()).yCoor = e.getY(): 
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Table 4.460 


Answer 23 (p. 2100) 


4.4.3.3.24 Question 24 


True or False: The program shown below displays a small JFrame with a red background. Two overlapping 
buttons appear in front of the red background. One button is green and the other button is yellow. 

At startup, the green button is in front of and partially hides the yellow button. If you click the frontmost 
button, the two buttons swap positions front to back. In other words, clicking the green button when it is 
in front brings the yellow button to the front. Clicking the yellow button when it is in front brings the green 
button to the front. Clicking the button in the back does not cause the buttons to swap positions. 

Clicking the X-button causes the program to terminate and return control to the operating system. 
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Listing 7 . Question 24. 


/*File Q24 
aK ak K ak K 3k ak ak ak ak ak 3K 3K aK 3K 2K ak 3K ak aK 3K 3K aK IC I IC aK aK K 3K 3K OI II I I I A 3K K 3K 2K KK 2k 21 1 fk K ÞK ÞK ÞK ÞK K K / 


import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 


class Q24 extends JFrame{//subclass JFrame 
JLayeredPane theLayeredPane; 
JButton greenButton; 
JButton yellowButton; 


public static void main(String[] args){ 
new Q24(); 
}//end main 


Q24 () {//constructor 
theLayeredPane = this.getLayeredPane(); 
int frameWidth = 300; 
int frameHeight = 100; 


JTextField redTextField = new JTextField(""); 
redTextField.setBackground(Color.red) ; 
this. getContentPane() .add(redTextField,"Center") ; 


greenButton = new JButton( 

“ereenButton on Layered Pane"); 
greenButton. setBackground(Color.green) ; 
greenButton.setBounds(10,10,240,40) ; 
greenButton.addActionListener (new MyActionListener()) ; 
theLayeredPane.add(greenButton,new Integer(1)); 


yellowButton = new JButton( 

“yellowButton on Layered Pane"); 
yellowButton.setBackground (Color. yellow) ; 
yellowButton.setBounds (40, 20, 240,40) ; 
yellowButton.addActionListener (new MyActionListener()) ; 
theLayeredPane.add(yellowButton,new Integer (-29999)) ; 


//Set title, size, and visibility of JFrame object. 
this.setTitle("Q24") ; 

this.setSize(frameWidth, frameHeight) ; 
this.setVisible(true) ; 


setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
}//end constructor 


class MyActionLigtirperioimps emenincAictd ombibs tenebte /content /coll1441/1.181> 
public void actionPerformed(ActionEvent e){ 
if (e.getActionCommand() . equals( 
"greenButton on Layered Pane")){ 
theLaveredPane. setLavyer (greenButton, -29999): 
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Table 4.461 


Answer 24 (p. 2100) 


4.4.3.3.25 Question 25 


True or False: The MouseMotionListener interface declares three methods: 


e public abstract void mouseDragged(MouseEvent e) 
e public abstract void mouseMoved(MouseE vent e) 
e public abstract void mousePressed(MouseEvent e) 


Answer 25 (p. 2100) 


4.4.3.3.26 Question 26 


True or False: The mouseDragged method is invoked when a mouse button is pressed on a component 
and then dragged. 
Answer 26 (p. 2099) 


4.4.3.3.27 Question 27 


True or False: The mouseMoved method is invoked when the mouse is moved on a component with no 
buttons down. 
Answer 27 (p. 2099) 


4.4.3.3.28 Question 28 


True or False: This program displays a small Frame object on the computer screen. When you hold down a 
mouse button and move your mouse pointer into the client area of the Frame, the coordinates of the mouse 
pointer appear directly above the pointer. As you move the mouse pointer around in the client area while 
holding the button down, the coordinates of the pointer continue to be displayed above the pointer. 

If you release the mouse button while moving the mouse in the client area, the coordinates of the point 
where you released the button appear and remain there until you press the mouse button, at which time the 
coordinates of the mouse pointer resume being displayed. 

Clicking the X-button terminates the program and returns control to the operating system. 
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Listing 8 . Question 28. 


/*File Q28.java from lesson 92 

FE AG II I IOI I IOI AI I I A I ak I I 1 E 21 1 1 4 21 21 EE 4 21 2k 2k E EE E a ak kak // 
import java.awt.*; 

import java.awt.event.*; 


public class Q28 { 
public static void main(String[] args){ 
GUI gui = new GUI(); 
}//end main 
}//end class Q28 


class MyFrame extends Framef 
int xCoor; 
int yCoor; 


MyFrame(String name){//constructor 
this.setTitle("Q28") ; 
this.setSize (300,200) ; 
this.setName (name); 

}//end constructor 


public void paint (Graphics g){ 
g.drawString("" + xCoor + ", " + yCoor, xCoor, yCoor); 
}//end paint () 
}//end class MyFrame 


class GUI { 
public GUI(Q {//constructor 
MyFrame myFramel = new MyFrame("Framel") ; 
myFramel.setVisible(true) ; 


myFrame1.addWindowListener (new WProc1()); 


MyMouseMotionProcessor mouseMotionProc = 
new MyMouseMotionProcessor(myFrame1) ; 
myFrame1 .addMouseMotionListener (mouseMotionProc) ; 


}//end constructor 
}//end class GUI definition 


class MyMouseMotionProcessor extends MouseMotionAdapter{ 
MyFrame refToFrame1; //save references to the Frame 


MyMouseMotionProcessor(MyFrame inFrame1) { 
refToFramei = inFrame1; 
}// end constructor 
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public void mouseMoved(MouseEvent e){ 
refToFrame1.xCoor = e.getX(); 
refToFrame1.yCoor = e.getY(); 
refToFramei.repaint(): 
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4.4.3.3.29 Question 29 


True or False: The program shown below displays a Frame object on the computer screen. The Frame object 
contains a single large Button object labeled Whistle. 

When the user clicks the Whistle button, the program displays the following text on the command-line 
screen. 

I am whistling, Tweet Tweet Tweet 

When the user clicks the X-button, the program terminates returning control to the operating system. 
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Listing 9 . Question 29. 


/*File Q29.java Copyright 1997, R.G.Baldwin 

BE AG EEE EEEE EEEE E EEEE A I aK I I A E EEEE 21 21 21 1 4 21 21 2k E EE 2 ak ak feof / 
import java.awt.*; 

import java.awt.event.*; 


public class Q29 { 
void whistle() {System.out.print1n( 
"I am whistling, Tweet Tweet Tweet") ;} 


static public void main(String[] args){ 
Q29 app = new Q29(); 
GUI gui = app.new GUI(); 

}//end main() 


//The GUI class is defined inside the Q29 class and is 
// an inner-class of Q29. 
class GUI extends Frame{ 


public GUI(){//constructor for GUI inner-class 
this.setTitle("Q29") ; 
Button whistleButton; 
this.add(whistleButton = 
new Button("Whistle") ,"Center") ; 


//Instantiates two anonymous objects of types 
// ActionListener and WindowAdapter. registers them 
// for handling 
// events on the Button object and the Frame object. 
//Begin statement ----------------------------------- 
whistleButton.addActionListener ( 
new ActionListener(){//anonymous class definition 
public void actionPerformed(ActionEvent e){ 
whistle(Q);//call the whistle() method 
}//end actionPerformed () 
}//end ActionListener 
);//end addActionListener () 
//End statement ------------------------------------- 


//Begin statement ----------------------------------- 
this.addWindowListener ( 
new WindowAdapter(){//anonymous class definition 
public void windowClosing(WindowEvent e){ 
System.exit(0);//terminate the program 
}//end windowClosing() 
}//end WindowAdapter 
);//end addWindowListener 
//End statement ------------------------------------- 
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//Set frame size and make it visible. 
this.setSize(300,100); 
this.setVisible(true): 
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Answer 29 (p. 2099) 


4.4.3.3.30 Question 30 


True or False: The program shown below displays a small Frame object with a white background. A Button 
object and a Label object are placed in the Frame. The Label is on the left and the Button is on the right. 
The two are lined up horizontally and the pair is centered left-to-right in the Frame. 

The Button is labeled "Button" and the Label is labeled "Initial Text". 

When you click the Button, the text in the Label changes to "Ouch". 

When you click the X-button, the program terminates and returns control to the operating system. 
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Listing 10 . Question 30. 


/*File Q30.java 

BEA EEE EE I IOI I IOI AICI I AGI aI I I A E 21 1 1 4 21 21 21 1 4 21 2k 2k E EE 2 2k ak kak / 
import java.awt.*; 

import java.awt.event.*; 


public class Q30 extends Frame { 
Label myLabel; 


static public void main(String[] args){ 
Q30 app = new Q30(); 
}//end main() 


public Q30( {//constructor 
this.setTitle("Q30") ; 
this.setLayout (new FlowLayout()); 
Button myButton; 
this.add(myButton = new Button("Button")) ; 
this.add(myLabel = new Label("Initial Text")); 


myButton.addActionListener ( 
new //instantiate anonymous object of the class 
ActionListener(){//anonymous class definition 
public void actionPerformed(ActionEvent e){ 
myLabel.setText ("Ouch") ; 
}//end actionPerformed () 
}//end ActionListener class definition 
);//end addActionListener() statement 


this. addWindowListener ( 
new WindowAdapter(){//anonymous class definition 
public void windowClosing(WindowEvent e){ 
System.exit(0);//terminate the program 
}//end windowClosing() 
}//end WindowAdapter 
);//end addWindowListener 


this.setSize(300,100) ; 
this.setVisible(true) ; 
3//end Q30 constructor 
3//end class Q30 


Table 4.464 
Answer 30 (p. 2099) 
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4.4.3.3.31 Question 31 


True or False: The program shown below displays a JSlider centered in a JFrame. The JSlider is calibrated 
to extend from -100 on the left end to 100 on the right end with 0 at the center. There is a tick mark every 
10 units and every other tick mark is labeled, including -100, 0, and 100. 

When you move the thumb on the slider, the value of the current position of the thumb is displayed on 
the command-line screen. Old values are not erased when a new value is displayed. 

When you click the X-button, the program terminates and returns control to the operating system. 
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Listing 11 . Question 31. 


/*File Q31 

FE EEEE EEEE EEE EEEE EEE ICAI AI I ICAI I I A 1 1 2k EE 21 21 E 4 4 24 E 2 af 2k EE E / 
import javax.swing. JFrame; 

import javax.swing.JSlider; 

import javax.swing.event.ChangeListener ; 

import javax.swing.event.ChangeEvent; 

import java.awt.BorderLayout ; 

public class Q31{ 


public static void main(String[] args){ 
new Q3igui(); 
}//end main method 
}//end class Q31 


class Q31igui extends JFramef 
private JSlider slider = new JSlider(-100,100); 


public Q31igui(){//constructor 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 


slider .setMajorTickSpacing (20) ; 
slider .setMinorTickSpacing(10) ; 
slider.setPaintTicks (true); 
slider.setPaintLabels (true); 


getContentPane() .add(slider) ; 


setSize (300,100) ; 
setTitle("Q31") ; 
setVisible(true) ; 


slider .addChangeListener ( 
new ChangeListener () { 
public void stateChanged(ChangeFvent e){ 
System.out.print(" " + slider.getValue()); 
}//end stateChanged 
}//end new ChangeListener 
);//end addChangeListener 


}//end class Q3igui 
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Answer 31 (p. 2099) 


4.4.3.3.32 Question 32 


True or False: The program shown below displays a small JFrame object on the computer screen. Each time 
the user clicks the mouse inside the JFrame object, the mouse coordinates are displayed near the mouse 
pointer and the old mouse coordinates from the previous click are erased. 

When the user clicks the X-button in the upper right corner of the Frame, the program terminates and 
returns control to the operating system. 
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Listing 12 . Question 32. 


/*File Q32.java Copyright 2002 R.G.Baldwin 
FE AG IIA I IOI AI I I AGI AI I I EE EEEE 21 21 EEE 21 21 1 EEEE E EE E ak kak // 


import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 


public class Q32 { 
public static void main(String[] args){ 
new Q32gui(); 
}//end main 
}//end class Q32 


class Q32gui { 
public Q32gui(){//constructor 
JFrame theFrame = new JFrame(); 
theFrame.setSize (200,200) ; 
theFrame.setTitle("Q32") ; 
DisplaySpace displayWindow = new DisplaySpace() ; 


theFrame.getContentPane() .add(displayWindow, "Center") ; 
theFrame.setDefaultCloseOperation( 

JFrame .EXIT_ON_CLOSE) ; 
theFrame.setVisible(true) ; 


displayWindow. addMouseListener ( 
new MProci(displayWindow) ) ; 
3//end constructor 


class DisplaySpace extends JPanelf{ 


int clickX; 
int clickY; 


public void paintComponent (Graphics g){ 
super . paintComponent (g) ; 
g.drawString( 
"" + clickX + ", " + clickY, clickX, clickY); 
}//end paintComponent 
}//end class DisplaySpace 


class MProci extends MouseAdapter{ 
DisplaySpace refToWin; 


MProci(DisplaySpace inWin){//constructor 
refToWin = inWin;//save ref to window 
}//end construckeHlable for free at Connexions <http://cnx.org/content /col11441/1.181> 


public void mousePressed(MouseEvent e){ 
refToWin.clickX = e.getX(); 
refToWin.clickY = e.getY(); 
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Table 4.466 


Answer 32 (p. 2099) 


4.4.3.3.33 Question 33 


True or False: The program shown below displays a small JFrame object on the computer screen. Each time 
the user clicks the mouse inside the JFrame object, the mouse coordinates are displayed near the mouse 
pointer and the old mouse coordinates from the previous click are erased. 

When the user clicks the X-button in the upper right corner of the Frame, the program terminates and 
returns control to the operating system. 
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Listing 13 . Question 33. 


/*File Q33.java 
FESO SOAS OAS IO IRIS AISI II IA ICI I IG I A I EEEE EEEE ak kk ak EN 


import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 


public class Q33 { 
public static void main(String[] args){ 
new Q33gui(); 
}//end main 
3//end class Q33 


class Q33gui extends JFramef 
public Q33gui(){//constructor 
setSize (200,200) ; 
setTitle("Q33") ; 
getContentPane() .add(new DisplaySpace() , Center") ; 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setVisible(true) ; 
}//end constructor 
}//end Q33gui 


class DisplaySpace extends JPanel{ 


int clickX; 
int clickY; 


DisplaySpace(){ 
addMouseListener ( 
new MouseAdapter(){//anonymous class definition 
public void onMouseEvent (MouseEvent e){ 
clickX = e.getX(); 
clickY = e.getY(); 
repaint (); 
}//end onMouseEvent () 
}//end MouseAdapter 
);//end addMouseListener () 
}//end constructor 


public void paintComponent (Graphics g){ 
super . paintComponent (g) ; 
g.drawString( 
"" + clickX + ", " + clickY, clickX, clickY); 
}//end paintComponent 
}//end class DisplaySpace 
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Answer 33 (p. 2099) 


4.4.3.3.34 Question 34 


True or False: The program shown below displays a small Frame object on the computer screen. Each 
time the user clicks the mouse inside the Frame object, the mouse coordinates are displayed near the mouse 
pointer and the old mouse coordinates from the previous click are erased. 

When the user clicks the X-button in the upper right corner of the Frame, the program terminates and 
returns control to the operating system. 
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Listing 14 . Question 34. 


/*File Q34.java 

*/ 

import java.awt.*; 
import java.awt.event.*; 


public class Q34 { 
public static void main(String[] args){ 
GUI gui = new GUI(); 
}//end main 
3//end class Q34 


class GUI extends Frame{ 
int clickX; 
int clickY; 


public GUIQ {//constructor 
setSize(150,150) ; 
setTitle("Q34") ; 
setVisible(true) ; 


addWindowListener ( 
new WindowAdapter(){//anonymous class definition 
public void windowClosing(WindowEvent e){ 
System.exit (0); 
}//end windowClosing 
}//end WindowAdapter 
);//end addWindowListener () 


addMouseListener ( 
new MouseAdapter(){//anonymous class definition 
public void mousePressed(MouseEvent e){ 
clickX = e.getX(); 
clickY = e.getY(); 
repaint (); 
}//end mousePressed() 
}//end MouseAdapter 
);//end addMouseListener () 
}//end constructor 


public void paint (Graphics g){ 
g.drawString( 
"" + clickX + ", " + clickY, clickX, clickY); 
}//end paint 


3//end class GUI 
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Answer 34 (p. 2098) 


4.4.3.3.35 Question 35 


True or False: The program shown below displays a small JFrame object on the computer screen. 

When you move your mouse pointer around inside the client area of the frame, without pressing either 
mouse button, the coordinates of the mouse pointer appear directly above the pointer. In this case, the 
coordinates are displayed using black characters. 

When you move your mouse pointer around inside the client area of the frame, while pressing either 
mouse button, the coordinates of the mouse pointer appear directly above the pointer. In this case, the 
coordinates are displayed using red characters. 

When you click X-button in the upper right corner of the frame, the program terminates and control is 
returned to the operating system. 
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Listing 15 . Question 35. 


/*File Q35.java 
FESO OGG IOS IO IORI II II IAI ICI I I A I A I A I ak A kK ak 2k EEEE EN 


import java.awt.*; 
import java.awt.event.*; 
import javax.swing.*; 


public class Q35 { 
public static void main(String[] args){ 
new Q35gui(); 
}//end main 
3//end class Q35 


class Q35gui extends JFramef 
public Q35gui(){//constructor 
setSize (200,200) ; 
setTitle("Q35") ; 
getContentPane() .add(new DisplaySpace() , Center") ; 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setVisible(true) ; 
}//end constructor 
}//end Q35gui 


class DisplaySpace extends JPanelf{ 


int clickX; 
int clickY; 


DisplaySpace(){ 
addMouseMotionListener ( 
new MouseMotionAdapter(){//anonymous class definition 
public void mouseMoved(MouseEvent e){ 
setForeground(Color.RED) ; 
clickX = e.getX(); 
clickY = e.getY(); 
repaint (); 
3//end mouseMoved 
public void mouseDragged(MouseEvent e){ 
setForeground (Color .BLACK) ; 
clickX = e.getX(); 
clickY = e.getY(); 
repaint (); 
}//end mouseDragged 
}//end MouseAdapter 
);//end addMouseMotionListener () 
}//end constructor 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
public void paintComponent (Graphics g){ 
super . paintComponent (g) ; 
g.drawString( 
un + ClickX + ", " + clickY, clickX, clickY); 
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Answer 35 (p. 2098) 


4.4.3.3.36 Question 36 


True or False: The program shown below displays a small JFrame object containing two JButton objects 
and a JLabel object. The JLabel has a green background and blue letters. The captions on the two JButton 
objects are Top and Bottom. 

The three objects are displayed vertically in the JFrame. The Top JButton appears at the top of the 
column of objects. The Bottom JButton appears at the bottom of the column. The JLabel appears between 
the two JButton objects. 

At startup, the JLabel displays the word Top. When you click the Bottom button, the word in the 
JLabel changes to Bottom. When you click the Top button, the word in the JLabel changes to Top. When 
you click X-button on the JFrame, the program terminates and returns control to the operating system. 
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Listing 16 . Question 36. 


/*File Q36.java 

BE EEEE EEEE EEE I IOI I IOI AI I I A I ak I I 1 21 21 1 EE 21 21 21 1 4 21 2 E E EE E a ak kak // 
import java.awt.Color; 

import java.awt.event.ActionListener; 

import java.awt.event.ActionEvent; 

import java.awt.BorderLayout ; 

import javax.swing. JFrame; 

import javax.swing. JButton; 

import javax.swing.JLabel; 


public class Q36{ 
public static void main(String[] args){ 
JFrame aFrame = new Q36gui(); 
}//end main 
3//end class Q36 


class Q36gui extends JFrame implements ActionListener{ 
JButton button! = new JButton("Top") ; 
JButton button2 = new JButton("Bottom") ; 
JLabel label = new JLabel("Top") ; 


public Q36gui(){//constructor 

this.setTitle("Q36") ; 

this. getContentPane() .add(button1, BorderLayout .NORTH) ; 
label. setBackground (Color .GREEN) ; 

label. setForeground (Color .BLUE) ; 

label. setOpaque (true) ; 

this. getContentPane() .add(label ,BorderLayout .CENTER) ; 
this. getContentPane() .add(button2, BorderLayout.SOUTH) ; 
buttoni.addActionListener (this); 
button2.addActionListener (this); 
this.setSize(150,100) ; 

this.setVisible(true) ; 


this.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
}//end constructor 


public void actionPerformed(ActionEvent e){ 
if (e.getActionCommand().indexOf("Top") != -1) 
label. setText ("Top"); 
else 
label.setText ("Bottom"); 
}//end actionPerformed () 


}//end class Q36gui 
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Table 4.470 


Answer 36 (p. 2098) 


4.4.3.3.37 Question 37 


True or False: The program shown below displays a small Frame object containing two Button objects and 
a Label object. The Label has a green background and blue letters. The captions on the two Button objects 
are Top and Bottom. 

The three objects are displayed vertically in the Frame. The Top Button appears at the top of the column 
of objects. The Bottom Button appears at the bottom of the column. The Label appears between the two 
Button objects. 

At startup, the Label displays the word Top. When you click the Bottom button, the word in the Label 
changes to Bottom. When you click the Top button, the word in the Label changes to Top. When you click 
X-button on the Frame, the program terminates and returns control to the operating system. 
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Listing 17 . Question 37. 


/*File Q37.java Copyright 2002 R.G.Baldwin 

BE AG EEE EEEE EEEE E EEEE AK ak I I 1 21 21 EEE 21 21 21 EEE ak E EE 2 a ak aka // 
import java.awt.Color; 

import java.awt.Frame; 

import java.awt.Button; 

import java.awt.Label; 

import java.awt.BorderLayout ; 


import java.awt.event.ActionListener; 
import java.awt.event .WindowListener; 
import java.awt.event .WindowEvent ; 
import java.awt.event.ActionEvent; 


public class Q37{ 
public static void main(String[] args){ 
Frame aFrame = new Q37gui(); 
}//end main 
3//end class Q37 


class Q37gui extends Frame 
implements WindowListener, ActionListener{ 
Button buttoni = new Button("Top"); 
Button button2 = new Button("Bottom") ; 
Label label = new Label("Top"); 


public Q37gui(){//constructor 


this.setTitle("Q37") ; 
add(button1, BorderLayout .NORTH) ; 
label. setBackground (Color .GREEN) ; 
label. setForeground (Color .BLUE) ; 
add(label, BorderLayout .CENTER) ; 
add (button2, BorderLayout . SOUTH) ; 
buttoni.addActionListener (this); 
button2.addActionListener (this); 
this.setSize(150,100) ; 
this.setVisible(true) ; 


this.addWindowListener (this) ; 
}//end constructor 


public void windowClosing(WindowEvent e){ 
//terminate the program when the window is closed 
System. exit (0) ; 

}//end windowClosing 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
public void windowOpened(WindowEvent e){}//dummy 
public void windowClosed(WindowEvent e){}//dummy 
public void windowIconified(WindowEvent e){}//dummy 
public void windowDeiconified(WindowEvent e){}//dummy 
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Answer 37 (p. 2098) 


4.4.3.4 Listings 


Listing 1 (p. 2064 
Listing 2 (p. 2066 
Listing 3 (p. 2068 
Listing 4 (p. 2070) . Question 20. 
Listing 5 (p. 2072) . Question 21. 

( 

( 

( 

( 


) . Question 16. 
) 
) 
) 
) 
Listing 6 (p. 2074) . Question 23. 
) 
) 
) 
2 


. Question 17. 
. Question 19. 


Listing 7 (p. 2076) . Question 24. 
Listing 8 (p. 2078) . Question 28. 
Listing 9 (p . Question 29. 
Listing 10 (p. 2082) . Question 30. 
Listing 11 (p. 2084) . Question 31. 
Listing 12 (p. 2086) . Question 32. 
Listing 13 (p. 2088) . Question 33. 
Listing 14 (p. 2090) . Question 34. 
Listing 15 (p. 2092) . Question 35. 
Listing 16 (p. 2094) . Question 36. 
Listing 17 (p. 2096) . Question 37. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the computer screen at the same time. 


None L oyx) 


Display your name 
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This image was also inserted for the purpose of inserting space between the questions and the answers. 


ProbO05a.jpq zj o |x] 


Put your name here 


4.4.3.5 Answers 
4.4.3.5.1 Answer 37 


True. Note that the GUI object is both a source of action events and a listener for action events fired by 
the buttons. 

Back to Question 37 (p. 2095) 
4.4.3.5.2 Answer 36 


True. Note that the GUI object is both a source of action events and a listener for action events fired by 
the buttons. 
Back to Question 36 (p. 2093) 
4.4.3.5.3 Answer 35 
False. The red and black colors are reversed. Otherwise, the statement would be true. 
Back to Question 35 (p. 2091) 
4.4.3.5.4 Answer 34 


True. This program uses anonymous inner classes to define and instantiate a mouse event handler and a 
window event handler. 
Back to Question 34 (p. 2089) 
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4.4.3.5.5 Answer 33 


False. The code in the anonymous mouse event handler class calls a method named onMouseEvent . It 
should call a method named mousePressed instead, in which case the program would behave as described. 
Back to Question 33 (p. 2087) 


4.4.3.5.6 Answer 32 


True. 
Back to Question 32 (p. 2085) 


4.4.3.5.7 Answer 31 


True. 
Back to Question 31 (p. 2083) 


4.4.3.5.8 Answer 30 


False. The Button and the Label are lined up horizontally with the Button on the Left and the Label on 
the right. The FlowLayout manager places components from left to right in the order that they are added 
to the container. The Button was added before the Label. See Java094. 

Back to Question 30 (p. 2081) 


4.4.3.5.9 Answer 29 


True. See Java094. 
Back to Question 29 (p. 2079) 


4.4.3.5.10 Answer 28 


False. The description of the mouse button is reversed. When you move your mouse pointer into the client 
area of the Frame without pressing a mouse button, the coordinates of the mouse pointer appear directly 
above the pointer. As you move the mouse pointer around in the client area, the coordinates of the pointer 
continue to be displayed above the pointer. 

If you press one of the mouse buttons while moving the mouse in the client area, the coordinates of the 
point where you pressed the button appear and remain there until you release the mouse button, at which 
time the coordinates of the mouse pointer resume being displayed. 

Clicking the X-button terminates the program and returns control to the operating system. 

See Java092. 

Back to Question 28 (p. 2077) 


4.4.3.5.11 Answer 27 
True. See Java092. 

Back to Question 27 (p. 2077) 
4.4.3.5.12 Answer 26 


True. See Java092. 
Back to Question 26 (p. 2077) 
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4.4.3.5.13 Answer 25 


False. The MouseMotionListener interface declares only the following two methods. The mouse- 
Pressed method is declared in the MouseListener interface. See Java092. 


e public abstract void mouseDragged(MouseEvent e) 
e public abstract void mouseMoved(MouseEvent e) 


Back to Question 25 (p. 2077) 


4.4.3.5.14 Answer 24 


True. See Java087. 
Back to Question 24 (p. 2075) 


4.4.3.5.15 Answer 23 


False. Clicking the X-button on either Frame object causes both Frame objects to disappear, terminating 
the program, and returning control to the operating system. See Java082. 
Back to Question 23 (p. 2073) 


4.4.3.5.16 Answer 22 


False. Multiple listener objects can be, and often are registered on a single source object. Similarly, a single 
listener object can be registered on multiple source objects. In many, but not all such cases, the listener 
object must be able to identify which source fired the event in order to take the appropriate action. However, 
in some situations, the appropriate action is independent of the identity of the source. See Java082. 

Back to Question 22 (p. 2073) 


4.4.3.5.17 Answer 21 


False. Although new coordinates are displayed with each mouse click, the old coordinates are not erased. 
See Java081. 
Back to Question 21 (p. 2071) 


4.4.3.5.18 Answer 20 


True. See Java 081. Note, however that the setDefaultCloseOperation method probably did not exist 
when Java081 was written. When used as shown in the code for this question, that method causes the 
program to terminate and return control to the operating system when the user clicks the X-button. Four 
different default actions can be specified for the X-button: 


DO_NOTHING_ON_CLOSE 
HIDE _ON_ CLOSE 
DISPOSE_ON_ CLOSE 
EXIT_ON_ CLOSE 


Back to Question 20 (p. 2069) 


4.4.3.5.19 Answer 19 


False. In order for this to be true, it would be necessary to override the WindowClosing method instead of 
the WindowClosed method. See Java080. 
Back to Question 19 (p. 2067) 
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4.4.3.5.20 Answer 18 
False: The default layout manager for a Frame object is BorderLayout . See Java080. 
Back to Question 18 (p. 2067) 
4.4.3.5.21 Answer 17 
True. See Java080. 
Back to Question 17 (p. 2065) 
4.4.3.5.22 Answer 16 
True. See Java080. 
Back to Question 16 (p. 2063) 
4.4.3.5.23 Answer 15 
True. See Java080. 
Back to Question 15 (p. 2063) 
4.4.3.5.24 Answer 14 
True. See Java080. 
Back to Question 14 (p. 2063) 
4.4.3.5.25 Answer 13 
True. See Java080. 
Back to Question 13 (p. 2063) 
4.4.3.5.26 Answer 12 
False. There is a class of mouse events that includes most of the events normally associated with mouse 
action and there is a matching interface definition that is used to define a listener class for those events. 
See Java080. 
Back to Question 12 (p. 2062) 
4.4.3.5.27 Answer 11 
True. See Java080. 
Back to Question 11 (p. 2062) 
4.4.3.5.28 Answer 10 
True. See Java080. 
Back to Question 10 (p. 2062) 
4.4.3.5.29 Answer 9 


False. An event source is an object that has the ability to determine when an interesting event has 
occurred, and to notify listener objects of the occurrence of the event. See Java080. 
Back to Question 9 (p. 2062) 
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4.4.3.5.30 Answer 8 
True. See Java080. 
Back to Question 8 (p. 2062) 
4.4.3.5.31 Answer 7 
True. 
Back to Question 7 (p. 2062) 
4.4.3.5.32 Answer 6 
False. This is multicasting . The one-to-one case is often referred to as unicasting. See Java077. 
Back to Question 6 (p. 2062) 
4.4.3.5.33 Answer 5 
True. See Java077. 
Back to Question 5 (p. 2062) 
4.4.3.5.34 Answer 4 


False. It is very important to understand that Swing is an extension of, and not a replacement for the AWT. 
Therefore, as students, we cannot simply skip over an understanding of the AWT and move on to Swing. 
The AWT is the foundation for Swing. See Java073. 

Back to Question 4 (p. 2062) 
4.4.3.5.35 Answer 3 


False. com.sun.java.swing.* was the package for Swing in JDK 1.1.6. However, sometime between then and 
the release of Java SE 7, the package containing Swing components was changed to javax.swing.* 
Back to Question 3 (p. 2061) 
4.4.3.5.36 Answer 2 
True. See Java073. 
Back to Question 2 (p. 2061) 
4.4.3.5.37 Answer 1 
True. See Java073. 
Back to Question 1 (p. 2061) 
4.4.3.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Jy0037: Review Event Handling 
e File: Jy0037.htm 

e Published: 10/30/13 

e Revised 12/23/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


4.5 JavaServer Pages (JSP) 


4.5.1 Java4305: Preface to JSP’ 
4.5.1.1 Table of Contents 


e Preface (p. 2103) 
e Miscellaneous (p. 2103) 


4.5.1.2 Preface 


As mentioned in Java OOP: Preface to ITSE 2317 !8° , JSP was added as a new topic in ITSE2317 - 
Java Programming (Intermediate) beginning with the Spring 2014 semester. 

This sub-collection contains tutorial-style modules that explain how to use JSP along with companion 
modules containing review questions with answers to help you solidify your understanding of the material 
in those modules. 

In addition the sub-collection begins with a short module explaining the relationship between servlets 
and JSP, and ends with a module containing a large number of review questions covering the JSP portion 
of the course. 


4.5.1.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4305: Preface to JSP 
e File: Java4305.htm 

e Published: 11/26/13 

e Revised 08/21/15 


198 This content is available online at <http://cnx.org/content /m48057/1.5/>. 
199http://cnx.org/content /m45258/latest /?collection=col11441 /latest 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


4.5.2 Java4307: Servlets and JSP’*” 
4.5.2.1 Table of Contents 


e Preface (p. 2105) 
Viewing tip (p. 2105) 


x Images (p. 2105) 
x Listings (p. 2105) 


e Discussion (p. 2105) 


What is a servlet and how does it relate to a JSP? (p. 2105) 
Differences between servlets and JSP (p. 2105) 

Packages, classes, and methods (p. 2106) 

Life cycle of a servlet (p. 2107) 

Life cycle of a JSP (p. 2107) 


e Anatomy of a JSP-generated servlet (p. 2107) 


One class and one object per jsp file (p. 2108) 
Thread safety (p. 2108) 

Servlet methods (p. 2108) 

The file named 4307-01.htm (p. 2108) 

The file named 4307-01.jsp (p. 2118) 

The HTML code (p. 2118) 

The JSP code (p. 2119) 

The behavior of the scriptlet (p. 2119) 

Test the hypothesis (p. 2120) 

Output from the doPost method (p. 2120) 
Output from the doGet method (p. 2122) 
Output from the doPut method (p. 2125) 
Output from the doDelete method (p. 2127) 


Support for all four methods (p. 2129) 


e References (p. 2129) 
e Miscellaneous (p. 2129) 


* 
* 
* 
* 


20°This content is available online at <http://cnx.org/content /m48284/1.4/>. 
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4.5.2.2 Preface 


This module is one in a collection of modules designed for teaching ITSE 2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

The purpose of this module is to provide a discussion of the relationship between Java Servlets and 
JavaServer Pages (JSP) . A background knowledge of object-oriented programming using Java is a prereq- 
uisite for understanding this material. 

A JSP is essentially a shorthand or alternative method for writing a Java servlet. (One might say that 
a JSP is a servlet in disguise.) Therefore, a cursory understand of Java servlets is useful in understanding 
the subtle aspects of JSP. 

The servlet material provided in this module will be very brief. A major section on servlets will be 
included in the INEW 2338 Advanced Java (web) 7°! course beginning in the Fall 2014 semester. In the 
meantime, you may find this online tutorial °??? on servlets to be useful. (I am not affiliated with the authors 
of that tutorial.) 


4.5.2.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the Images and listings while you are reading about them. 


4.5.2.2.1.1 Images 


e Image 1 (p. 2117) . Screen output for 4307-01.htm. 
e Image 2 (p ) . Output from the doPost method. 
e Image 3 (p. 2124) . Output from the doGet method. 
e Image 4 (p. 2126) . Output from the doPut method. 
e (p ) 


Image 5 . Output from the doDelete method. 


4.5.2.2.1.2 Listings 


e Listing 1 (p. 2109) . The file named 4307-01.htm. 
e Listing 2 (p. 2118) . The file named 4307-01.jsp. 


4.5.2.3 Discussion 
4.5.2.3.1 What is a servlet and how does it relate to a JSP? 


As mentioned earlier, a JSP is essentially a shorthand or alternative method for writing a Java servlet. 

A servlet is an executable Java program that runs on a web server. A servlet typically acts as the interface 
between requests coming from a web browser and other web applications such as databases. The execution 
of a servlet is initiated by a request from a browser. 


4.5.2.3.2 Differences between servlets and JSP 


Even though a JSP is an alternative method for writing a servlet, from a practical standpoint, there are 
significant differences between the two. 

Deployment 

The installation of a servlet or a JSP on a web server is often referred to as deployment . A servlet 
is typically written and compiled locally using standard Java code and then deployed onto the server as a 
compiled Java class. 


201http://cnx.org/content /m48259 /latest /?collection=col11441 /latest 
02 http://www.tutorialspoint.com/servlets/index.htm 
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A JSP is typically deployed onto the server as a file containing Java source code intermingled with HTML 
(or possibly XML) code. The Java source code is distinguished from the HTML code by inserting the Java 
source code into special JSP tags constructed using angle brackets, percent characters, and other characters 
as well. 

A component on the server known as the JSP container translates the HTML code into Java source 
code and compiles the resulting combined code into a Java servlet. In the end, therefore, both approaches 
end up being a servlet. 

HTML output 

Servlets and JSP typically create HTML code and send that HTML code back to a browser. When 

writing a servlet, it is often necessary for the author to write numerous print or println statements with 
String parameters consisting of raw HTML code. Writing and testing those statements can be a long, 
tedious, and error-prone process. 

A JSP on the other hand intermingles raw HTML code with Java source code (using special JSP tags 
for the Java source code) , thus eliminating or significantly reducing the amount of HTML code that must 
be written into the Java source code. Without getting into the details, it is easier to write HTML code in a 
JSP than to write that same HTML code in Java source code, particularly if you use a good HTML editor 
to write the HTML code and then insert the JSP tags into the HTML code. 

The JSP container uses the HTML code in the JSP page as a template and writes the corresponding Java 
source code for you. The container also inserts the Java source code from the JSP tags into the newly-minted 
Java source code.. Then it compiles the resulting Java source code into a servlet. 

On the other hand, there is no free lunch. Writing the Java source code in the form of JSP tags and 
testing that code can sometimes be more complicated than simply writing and testing the Java source code 
using a good Java IDE. There is a tradeoff in complexity between the two approaches. 

Method overriding 
The author of an HTTP servlet must override methods named doGet , doPost doPut , and 
doDelete to establish the behavior of the servlet. This, in turn requires a fairly in-depth knowledge of 

OOP and runtime polymorphism. 

Much of that programming effort is done automatically when the JSP container translates a JSP file into 
a servlet and compiles it. Therefore, less actual Java programming may be required to create a JSP than 
would be required to create a comparable servlet. 

It may also be true that in some cases, a person having less understanding of Java object-oriented 
programming can follow the rules and write a JSP than would be required to write a comparable servlet. 

On the other hand, because the servlet programmer must program closer to ground zero, the servlet 
programmer may have a better understanding of what is actually happening on the server than would be 
the case for a JSP programmer creating a comparable servlet using the JSP as a go-between. 


ti 2 


4.5.2.3.3 Packages, classes, and methods 


Java EE 7 contains about eleven packages with names that begin with javax.servlet . About seven of 
those packages have names that begin with javax.servlet.jsp 


(Those are the only packages in Java EE 7 that contain jsp in the name of the package. There 
are no packages in Java Platform, Standard Edition 7 that contain either servlet or jsp in 
the name of the package.) 


According to Default Package Imports 7° , by default, the JSP container imports the following packages into 


any JSP page. No page directive import settings are required for using the classes defined in these packages: 


e javax.servlet.* 
e javax.servlet.http.* 
e javax.servlet..jsp.* 


203http://docs.oracle.com/cd/A97688_16/generic.903/a97679/getstart .htm71007970 
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The three packages listed above provide the main classes for the development of servlets and JSP. However, 
according to this tutorial 2° , 


"The full functionality of the Java class libraries is available to a servlet. It can communicate 
with applets, databases, or other software via the sockets and RMI mechanisms that you have 
seen already." 


Because a JSP is simply a servlet in disguise, it has access to the same resources that are available to a 
servlet. 


4.5.2.3.4 Life cycle of a servlet 


You can read about the complete life cycle of a servlet in this tutorial 295 . For now, suffice it to say that 


Java Servlets are simply Java classes that reside on and are instantiated and executed by a web server that 
supports the Java Servlet specification. Servlets can be created using the packages mentioned above. These 
classes implement the Java Servlet and JSP specifications. 

Once deployed on a web server, a Java servlet will have been created and compiled just like any other 
Java class. 

A single instance (object) of each servlet class is created on the server. When a browser makes a request 
to run the servlet, a new thread is spawned to handle the request. A nice diagram with an explanation is 
provided in the section titled Architecture Diagram in this tutorial 7° . 

The fact that every browser accessing the servlet is running on a different thread spawned by the same 
servlet object has some subtle ramifications regarding the thread safety (or lack thereof) of instance variables 
belonging to the object. I will touch on that in more detail later in this module. 

Several examples of servlet code are available here 207 . 


4.5.2.3.5 Life cycle of a JSP 


The life cycle of a JSP is similar to the life cycle of a servlet. The main difference is that the JSP container 
must convert the jsp file containing HTML code and JSP tags into the source code for a servlet and then 
compile that servlet. 


4.5.2.4 Anatomy of a JSP-generated servlet 


You might be wondering "Exactly how does the JSP container translate the contents of a jsp file into a 
servlet?" Without having access to some very detailed technical information, it is not possible to know the 
exact answer to that question. However, it is possible to develop a hypothesis and write code to test that 
hypothesis. 


Nerd alert : The remaining material in this module is more advanced than students are 
expected to understand early in the course. However, this material, which contains the answers 
to some interesting questions, is being provided in anticipation that some students may have 
those questions later in the course and will come back to this module to learn the answers. 


204http://www.tutorialspoint.com/servlets/servlets-quick-guide.htm 
205 http://www.tutorialspoint.com/servlets/servlets-life-cycle.htm 

206 http://www.tutorialspoint.com/servlets/servlets-life-cycle.htm 

207 http://www.tutorialspoint.com/servlets/servlets-first-example.htm 
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4.5.2.4.1 One class and one object per jsp file 


It seems clear from the literature that each jsp file (and any files included by that file) is translated into a 
single HTTP servlet class by the JSP container. When the jsp file is first requested by an HTTP browser, 
that servlet class is compiled and a single object is instantiated from the class. That object is retained by 
the server until it is purposely removed by the server, which could be seconds, minutes, hours, days, weeks, 
months, years, etc. into the future. 

For as long as that object remains on the server, each new request for the jsp file spawns a new thread 
and the methods belonging to the object are used to handle that particular request on the new thread. 


4.5.2.4.2 Thread safety 


Local variables declared in those methods are thread safe . By that, I mean that if two threads are 
executing the same Java method, each thread has its own copy of all local variables. The code being 
executed in one thread cannot modify the variables belonging to another thread. 

Instance variables belonging to the object, on the other hand, are not inherently thread safe. Instance 
variables are shared by all methods belonging to an object and by all threads that may be executing the 
methods belonging to the object. The code being executed by one thread can modify the value of an instance 
variable, possibly to the detriment of other threads. 

While in general it is possible in Java to protect instance variables and make them thread safe, that is 
not an easy task. Insofar as JSP programming is concerned, the best protection is probably to avoid using 
instance variables in situations where this could be a problem. However, I will show you an example later 
where the use of an instance variable is probably okay. 


4.5.2.4.3 Servlet methods 


When a human programmer defines an HTTP servlet class, that programmer will normally define a class 
that extends the class named HttpServlet and override one or more of the following inherited methods: 


doDelete : Called by the server to allow a servlet to handle a DELETE request. 
doGet : Called by the server to allow a servlet to handle a GET request. 
doPost : Called by the server to allow a servlet to handle a POST request. 
doPut : Called by the server to allow a servlet to handle a PUT request. 


The choice of methods to be overridden depends on the expectations of the programmer regarding the types 
of requests that are likely to be received. 

The behavior of the overridden methods need not be the same. In fact, it is very likely that the behavior 
of an overridden doGet method will be substantially different from the behavior of a doDelete method 
ora doPut method due simply to the different purposes of the HTTP DELETE, GET, and PUT requests. 

However, I hypothesize that the servlet class that is automatically created by the JSP container overrides 
all four methods with exactly the same code. (If that is not the case, I don’t know how to cause it to do 
otherwise.) I will present a sample program that seems to confirm this hypothesis. The sample program 
will also demonstrate the behavior of local variables and instance variables in JSP code. 


4.5.2.4.4 The file named 4307-01.htm 


Listing 1 (p. 2109) shows the raw HTML code for a file that I will use to test this hypothesis. This file will 
also be used to demonstrate the behavior of local variables and instance variables. This is strictly an HTML 
file. While it does reference a jsp file, it doesn’t contain any jsp code. 
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Listing 1 . The file named 4307-01.htm. 


<!DOCTYPE html> 

<html ><head></head> 
<body> 

<hi>File: 4307-01.htm</hi> 


<h2>Call jsp page with post</h2> 

<form action="http://localhost :8080/4307-01.jsp" method="post"> 
<table> 

<tr> 

<td>Age</td> 

<td><input type="text" name="age"></td> 

</tr><tr> 

<td><input type="submit" value="Submit with post method"></td> 
</tr> 

</table> 

</form> 


<h2>Call jsp page with get</h2> 

<form action="http://localhost :8080/4307-01.jsp" method="get"> 
<table> 

<tr> 

<td>Age</td> 

<td><input type="text" name="age"></td> 

</tr><tr> 

<td><input type="submit" value="Submit with get method"></td> 
</tr> 

</table> 

</form> 


<h2>Call jsp page with put</h2> 

<form action="http://localhost:8080/4307-01.jsp" method="put"> 
<table> 

<tr> 

<td>Age</td> 

<td><input type="text" name="age0"></td> 

</tr><tr> 

<td><input type="submit" value="Submit with put method"></td> 
</tr> 

</table> 

</form> 


<h2>Call jsp page with delete</h2> 

<form action="http://localhost :8080/4307-01. jsp" method="delete"> 
<table> 

<tr> 

<td>Age</td> 

<td><input type="text" name="agel"></td> 

</tr><tr> 

<td><input type="submit" value="Submit with delete method"></td> 
</tr> Available for free at Connexions <http://cnx.org/content /col11441/1.181> 
</table> 

</form> 


</body> 
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Table 4.472 


Image 1 (p. 2117) shows the result of opening this file in a Firefox browser. 
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Image 1 . Screen output for 4307-01.htm. 
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Table 4.473 


Highly redundant HTML code 
While the raw HTML code in Listing 1 (p. 2109) may look long and complex, Image 1 (p. 2117) shows 
that it is highly redundant. That code produces four simple data entry forms on the same page, each with 


a text field for entering a value and a submit button for submitting that value to the same jsp file. I will 
have more to say about this later. 


4.5.2.4.5 The file named 4307-01.jsp 


Listing 2 (p. 2118) shows the contents of a file named 4307-01.jsp that has been deployed on my local Apache 
Tomcat server. I will explain the behavior of this JSP and its relationship with the HTML file shown in 
Listing 1 (p. 2109) in the paragraphs that follow. 


Listing 2 . The file named 4307-01.jsp. 


<!--File 4307-01.jsp --> 
<!--Copyright 2013, R.G.Baldwin --> 


<html> 

<body> 
<j%--Declare an instance variable --%> 
<%! int accessCounter = 0; %> 


<%--Define a scriptlet --%> 
<% 


String age = 


int localVar = 


0; 


request .getParameter ("age"); 


out.println("<p>Age = 


" + age + "</p>"); 


out.println("<p>localVar = " + ++localVar + "</p>"); 


out.println("<p>Access Counter = " + ++accessCounter + "</p>"); 
h> 
</body> 
</html> 
Table 4.474 


4.5.2.4.6 The HTML code 


The action attribute 


Let’s turn our attention to the HTML code in Listing 1 (p. 2109) . This code consists of four form 
elements, each of which has the requisite action attribute. The value of the action attribute is the 
same for all four form elements. That value specifies that the same jsp file will be executed when the user 


selects the submit button for any of the four forms. The specified jsp file is the one shown in Listing 2 
(p. 2118) . 
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The method attribute 
Each of the four form elements also has the requisite method attribute. Note, however, that the 
values of the four method attributes are not the same. Going from top to bottom, they are: 


post 
get 
put 
delete 


This means that if you select the submit button for the top form in Image 1 (p. 2117) . the doPost 
method of the servlet produced by the jsp file in Listing 2 (p. 2118) will be executed. 

If you select the submit button for the bottom form in Image 1 (p. 2117) , the doDelete method 
of the servlet produced by the jsp file in Listing 2 (p. 2118) will be executed. 

Similarly, selecting the submit buttons for the second and third forms in Image 1 (p. 2117) will cause 
the doGet and doPut methods to be executed in that order. 


4.5.2.4.7 The JSP code 


Note that the jsp code in Listing 2 (p. 2118) makes no distinction as to the method in which the code will 
reside. This leads to my hypothesis that all four methods are overridden containing exactly the same code. 

The code in each method is defined in the JSP scriptlet element in Listing 2 (p. 2118) . The code 
in the methods does not include the code in the JSP declaration element that declares and initializes the 
instance variable named accessCounter . That instance variable comes into existence and is initialized 
when the object is first instantiated and continues to exist for as long as the object exists. 


4.5.2.4.8 The behavior of the scriptlet 


The code in the scriptlet element, and hence in each of the four methods behaves as follows: 


Declare a local variable named localVar and initialize its value to 0. 
Get the incoming data value identified by "age" and store it in a new local variable of type String 
named age 

e Callthe println method on the response object to embed the value of age ina String and send 
it back to the browser. 

e Callthe println method on the response object to increment the value of localVar , embed it in 
a String and send it back to the browser. 

e Callthe println method on the response object to increment the value of the instance variable named 
accessCounter , embed it ina String and send it back to the browser. 


Expectations for local Var 

Given this behavior, we would expect the value of the local variable named localVar to be 1 each 
time is reported back to the browser. This is because all local variables cease to exist when the method in 
which they are declared terminates. Thus, each time one of the four methods is called, that variable will be 
declared anew and initialized to 0. Then it will be incremented to a value of 1 and sent back to the browser. 
After that, the method will terminate and the variable will cease to exist. 

Expectation for accessCounter 

On the other hand, instance variables do not cease to exist when methods terminate. The life of an 
instance variable is the same of the life of the object to which it belongs. Therefore, we would expect the 
value of the instance variable named accessCounter to be incremented by one each time any of the four 
methods is called. 

Each time the value of accessCounter is reported back to any requesting browser, its value should be 
one greater than the value reported back to the most recent requesting browser. 
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Note that those requesting browsers can be entirely different browsers so long as they have access to the 
web server. Using a local web server, they all need to be on the same computer. However, using a public 
web server on the Internet, those browsers could be different browsers on different computers in different 
countries. 


4.5.2.4.9 Test the hypothesis 


Now let’s test my hypothesis. Deploy the file named 4307-01.jsp on your web server and start the server. 
Open the file named 4307-01.htm in your browser. Your browser should display something very similar 

to Image 1 (p. 2117) . 

4.5.2.4.9.1 Output from the doPost method 


Enter the value 22 into the topmost text field and select the corresponding submit button. Your browser 
should display something similar to Image 2 (p. 2122) . We know from Listing 1 (p. 2109) that this causes 
the servlet object to execute the method named doPost 
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Image 2 . Output from the doPost method. 
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Table 4.475 


The age value from the text field is displayed in Image 2 (p. 2122) along with the expected value of 
localVar . Also, the value of accessCounter is correct because this is the first time that the jsp page 
has been accessed since the server was started. 


4.5.2.4.9.2 Output from the doGet method 


Now press the "back" button on your browser, or open the file named 43807-01.htm in a different browser 
tab, or open it in a different browser, whichever you prefer. 

Enter the value 33 in the second text field and select the corresponding submit button. We know from 
Listing 1 (p. 2109) that this causes the servlet object to execute the method named doGet . Your browser 
should display something similar to Image 3 (p. 2124) . 
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Image 3 . Output from the doGet method. 


| ©) My title - Mozilla Firefox 


ory 


Age = 33 
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Access Counter = 2 


Table 4.476 


Once again, the age value from the text field is displayed along with the expected value of localVar . 
Also, the value of accessCounter is correct because this is the second time that the jsp page has been 


accessed since the server was started. 
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4.5.2.4.9.3 Output from the doPut method 


Once again, press the "back" button on your browser or open the file named 4307-01.htm in a different 
browser tab, or open it in a different browser, whichever you prefer. 

Enter the value 44 in the third text field and select the corresponding submit button. We know from 
Listing 1 (p. 2109) that this causes the servlet object to execute the method named doPut . Your browser 
should display something similar to Image 4 (p. 2126) . 
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Mozilla Firefox 


Image 4 . Output from the doPut method. 
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Age = null 


local Var = 1 


Access Counter = 3 


Table 4.477 


What happened to age? 

Note that the age value from the text field is not displayed in Image 4 (p. 2126) . This is because 
the code in the jsp file was not designed to properly support the HTTP PUT command. In particular, the 
PUT command doesn’t send anything to the server that the servlet can access using the simple call to the 
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getParameter method on the request object. In this case, the getParameter method returned null 
and that is what was sent back to the browser. 

We did get the expected value of localVar . Also, the value of accessCounter is correct because 
this is the third time that the jsp page has been accessed since the server was started. 


4.5.2.4.9.4 Output from the doDelete method 


Finally, do the same thing again using the bottom form in Image 1 (p. 2117) and entering 55 into the text 
field. Your browser should display something similar to Image 5 (p. 2128) . 
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) My title - Mozilla Firefox 
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Image 5 . Output from the doDelete method. 
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Table 4.478 
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Once again, the value for Age is null because the code in the jsp file was not designed to properly 
support the HTTP DELETE command. However, the other two values reported back to the browser by the 
doDelete method are exactly what we would expect. 


4.5.2.4.10 Support for all four methods 


Our servlet in this module doesn’t properly support the HTTP PUT or HTTP DELETE commands. How 
then might one write a single jsp file that would behave appropriately for all four commands? 

The answer to that question is that I don’t know the answer. However, I feel reasonably confident that 
it is possible to write code in a method that would allow that method to identify itself. If so, the jsp 
scriptlet code could be written with four sections in an if-else construct. Only one section would be executed 
depending on which method is being executed, and each section could contain code that would provide 
appropriate behavior for the method being executed. Then again, that may be entirely wrong. The correct 
approach may be entirely different. 

In any event, I hope this will give you a better understanding of what happens when you write, deploy, 
and use a JSP with a web server. 


4.5.2.5 References 


There are many good references available on the web for this topic. As you work through the material in 
these modules on JSP, you should keep the following two tutorials in mind as supplementary material. 


e Servlets Tutorial 2% 
e JSP Tutorial 2°9 


4.5.2.6 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4307: Servlets and JSP 
e File: Java4307.htm 

e Published: 12/17/13 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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4.5.3 Java4308: Deploying JSP and Servlets ° 
4.5.3.1 Table of Contents 


e Preface (p. 2130) 
Viewing tip (p. 2131) 


x Images (p. 2131) 
x Listings (p. 2131) 


e General background information (p. 2131) 
e Set up the Java Development Kit (p. 2131) 


Java Platform (JDK) version 7 or later (p. 2131) 
Servlet and JSP jar files (p. 2132) 


e Set up the Tomcat Web Server (p. 2132) 


Start the server (p. 2132) 
Stop the serve (p. 2133) r 


e Create. deploy, and run a servlet (p. 2134) 


Three folders of interest (p. 2134) 

Seven required steps (p. 2134) 

Create and compile the servlet file (p. 2134) 

Copy the compiled servlet file into the classes folder (p. 2136) 
Modify the file named web.xml (p. 2136) 

Start the server (p. 2136) 

Access the servlet file with your browser (p. 2136) 

Stop the server (p. 2139) 


e Create, deploy, and run a JSP (p. 2139) 


Five required steps (p. 2139) 

Create the jsp file (p. 2139) 

Copy the jsp file into the ROOT folder (p. 2139) 
Start the server (p. 2139) 

Access the jsp file with your browser (p. 2140) 
Stop the server (p. 2141) 


e Miscellaneous (p. 2142) 


4.5.3.2 Preface 


This module is one in a collection of modules designed for teaching ITSE 2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

Eventually, students enrolled in this course will deploy their JSP projects on a web server operated by 
the college. In the meantime, however, it may be useful for students to have the ability to deploy and test 
JSP projects and servlets locally on their own computers. The purpose of this module is to explain one way 
to deploy and test JSP projects and servlets on a local machine running Windows. 

The material in this module is based heavily on the following documents: 


e JSP - Quick Guide °t! 
e Servlets - Quick Guide ?!? 


210This content is available online at <http://cnx.org/content /m48488/1.2/>. 
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4.5.3.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the Images and listings while you are reading about them. 


4.5.3.2.1.1 Images 


e Image 1 (p. 2138) . Output from HelloWorld01 servlet. 
e Image 2 (p. 2141) . Output from hello02.jsp. 


4.5.3.2.1.2 Listings 


e Listing 1 (p. 2132) . The TomcatStart.bat file. 
e Listing 2 (p. 2133) . The TomcatStop.bat file. 

e Listing 3 (p. 2135) . The HelloWorld01.java file. 
e Listing 4 (p. 2135) . The compile.bat file. 

e Listing 5 (p. 2136) . The Modified web.xml file. 
e Listing 6 (p. 2139) . The hello02.jsp file. 


4.5.3.3 General background information 


The purpose of this module is to show you how to set and run servlets and JSP on an Apache Tomcat server 
running locally on a Windows machine. This will involve the following steps: 


Set up the Java Development Kit 
Set up the Tomcat Web Server 
Create. deploy, and run a servlet 
Create, deploy, and run a JSP 


4.5.3.4 Set up the Java Development Kit 


In order to create and run servlets and JSP, you need the following Java software installed on your computer: 


e Java Platform (JDK) version 7 or later 
e Jar files containing servlet and JSP packages 


4.5.3.4.1 Java Platform (JDK) version 7 or later 


Students enrolled in this course should already have experience downloading and installing the Java Platform 
(JDK) because they have used it in the two prerequisite courses. 

Others will find the JDK freely available for downloading from Oracle here ?!3 . Installation instructions 
are available here 2!4 . Download and install the JDK according to those instructions. 


213http://www.oracle.com/technetwork/java/javase /downloads/index.html 
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4.5.3.4.2 Servlet and JSP jar files 


The situation regarding the required jar files isn’t so straightforward. The jar files are part of Java EE 7. 
The download page for Java EE 7 is this web page 7!° . However, as of December 2013, everything that I 
could find on that page consisted of huge software bundles containing far more than needed. (All that is 
needed is one and possibly two small jar files.) 

I finally found what I needed as the Java Servlet Development Kit 2.1 at this web page 7!° . Even 
that download contains more than is needed, but since it doesn’t involve a Windows install operation, you 
can delete all but the jar files if you choose to do so. 

This material is downloaded in a file named jsdk2_1-1.zip . Extract the contents of the zip file and 
store them wherever you choose on your hard drive. The zip file encapsulates a tree with a root folder named 
jsdk2.1 . I elected to store it on my computer in the following location: 


C:\Program Files (x86) \JavaServletDevKit\jsdk2.1 


(This will become important later when I show you the contents of some batch files that I use to streamline 
the process.) 
The two jar files of interest are contained in the folder named jsdk2.1 and are named: 


e servlet.jar 
e server.jar 


(It may be that only the first of the two jar files is really needed but neither file is very large.) 
At this point, you should have all of the Java development software that you need set up and ready to 
use. 


4.5.3.5 Set up the Tomcat Web Server 


I elected to use a free copy of the Apache Tomcat web server. You can download it here ?!7 . In December 
2013, I downloaded and installed the latest version, which is Tomcat 8.0. 

This software arrives in a zip file named apache-tomcat-8.0.0-RC5-windows-x64.zip . The zip file 
encapsulates a tree with a root folder named apache-tomcat-8.0.0-RC5 . You can extract the tree and 
store it wherever you choose on your hard disk. I elected to store it in the following location: 


C: \apache-tomcat-8.0.0-RC5 
(Once again, this will become important later when I show you the contents of some batch files that I use 
to streamline the process.) 
4.5.3.5.1 Start the server 


You must start the server running before you can use it to host servlets or JSP. I placed a batch file named 
TomcatStart.bat on my desktop. I start the server by double clicking on the icon for the batch file. 
My batch file named TomcatStart.bat contains the commands shown in Listing 1 (p. 2132) . 


Listing 1 . The TomcatStart.bat file. 


continued on next page 
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set JAVA_HOME=C:\Program Files\Java\jdk1.7.0_45 

set CATALINA_HOME=C: \apache-tomcat-8.0.0-RC5 

set PATH=PATH%; ZJAVA_HOME%\bin; ZCATALINA_HOME%\bin 

set CLASSPATH=/%CATALINA%\common\lib\servlet-api. jar; CLASSPATH 


start %CATALINA_HOME%\bin\startup.bat 
pause 


Table 4.479 


The first two lines in your batch file may be different, depending on where you decide to locate your JDK 
and your Tomcat server. 

When you start the server, you should see many lines of text scrolling upward in a command window 
with the last line reading something like "Server startup in 1030 ms" . When you see that, you will know 
that the server is ready to host servlets and JSP. 


4.5.3.5.2 Stop the server 


You must stop the server when you want to stop processing servlets or JSP. Perhaps more importantly, if 
you need to modify a servlet or a JSP, you must stop the server, copy the modified file into the appropriate 
location, and then restart the server. 

My batch file named TomcatStop.bat contains the commands shown in Listing 2 (p. 2133) . 


Listing 2 . The TomcatStop.bat file. 


set JAVA_HOME=C:\Program Files\Java\jdk1.7.0_45 

set CATALINA_HOME=C: \apache-tomcat-8.0.0-RC5 

set PATH=PATH%; ZJAVA_HOME%\bin; ZCATALINA_HOME%\bin 
start /%CATALINA_HOME%\bin\shutdown. bat 

pause 


Table 4.480 


Once again, the first two lines in your batch file may be different, depending on where you decide to 
locate your JDK and your Tomcat server. 

When you stop the server, you should see many lines of text scrolling upward in the command window 
and then the command window will close. When you see that, you will know that the server has stopped. 

There is a lot of material in the Tomcat server tree and I’m sure there are many ways to use that material. 
However, I am going to show you the most straightforward way to install and execute servlets and JSP. We 
will mainly be interested in three folders that reside on the following path 


C: \apache-tomcat-8.0.0-RC5\webapps\ROOT\WEB-INF\classes 


(Note that the classes folder did not exist when I first installed the server. I added it.) 
These are the three folders of interest and reason they are of interest: 


e ROOT: Copy your jsp files into this folder in order to install them. 
e WEB-INF: This folder contains an xml file that must be updated whenever you install a servlet. 
e classes: Copy your compiled servlet files into this folder to install them. 
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4.5.3.6 Create. deploy, and run a servlet 
4.5.3.6.1 Three folders of interest 


There is a lot of material in the Tomcat server tree and I’m sure there are many ways to use that material. 
However, I am going to show you the most straightforward way to install and execute servlets and JSP. 

We will mainly be interested in three folders that reside on the following path within the Tomcat 
server tree: 


C: \apache-tomcat-8.0.0-RC5\webapps\ROOT\WEB-INF\classes 


(Note that the classes folder did not exist when I first installed the server. I added it.) 
These are the three folders of interest. and reason they are of interest: 


e ROOT: Copy your jsp files into this folder in order to install them. 
e WEB-INF: This folder contains an xml file that must be updated whenever you install a servlet. 
e classes: Copy your compiled servlet files into this folder to install them. 


4.5.3.6.2 Seven required steps 


To create, deploy, and run a servlet, you must accomplish the following steps: 


Create the servlet file. 

Compile the servlet file. 

Copy the compiled servlet file into the classes folder discussed above (p. 2133) . 
Modify the file named web.xml in the WEB-INF folder discussed above (p. 2133) . 
Start the server. 

Access the servlet file on the server with your browser. 

Stop the server when you are finished, or when you need to modify the servlet. 


Bl QR ae oe Ny 


4.5.3.6.3 Create and compile the servlet file 


Let’s begin testing our system with a simple servlet. Copy the contents of Listing 3 (p. 2135) into a file 
named HelloWorld01.java in a location somewhere on your hard drive and compile it. 
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Listing 3 . The HelloWorld01.java file. 


// Import required java libraries 
import java.io.*; 
import javax.servlet.*; 
import javax.servlet.http.*; 


// Extend HttpServlet class 
public class HelloWorld01 extends HttpServlet { 


private String message; 


public void init() throws ServletException 
{ 
// Do required initialization 
message = "Hello World 01"; 
} 
//override the doGet method 
public void doGet (HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, IOException 


{ 
// Set response content type 
response. setContentType ("text/html") ; 
// Actual logic goes here. 
PrintWriter out = response.getWriter(); 
out.println("<hi>" + message + "</h1i>"); 
} 


//override the destroy method 
public void destroy() 
{ 
// do nothing. 
} 
} 


Table 4.481 


Listing 4 (p. 2135) shows the contents of a batch file that I used to compile this program. 


Listing 4 . The compile.bat file. 


javac -cp .;"C:\Program Files (x86) \JavaServletDevKit\jsdk2.1\servlet. jar"; 
"C:\Program Files (x86) \JavaServletDevKit\jsdk2.1\server.jar" HelloWorld01.java 
pause 


Table 4.482 
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(Note that the javac command must all be on one line. I inserted a line break into Listing 4 (p. 
2135) to force it to fit in this publication format. Also note that you can omit the path to server.jar and 
this program will compile without errors.) 


4.5.3.6.4 Copy the compiled servlet file into the classes folder 
This program will compile into a single file named HelloWorldO1.class . Copy that file into the folder 
named classes discussed above (p. 2133) . 


4.5.3.6.5 Modify the file named web.xml 


Now you need to update the file named web.xml that is located in the folder named WEB-INF discussed 
above (p. 2133) . Use your text editor to cause the end of that file to be as shown in Listing 5 (p. 2136) . 
(Don’t modify the material that is already in that file.) 


Listing 5 . The Modified web.xml file. 


<servlet> 
<servlet-name >HelloWorld01</servlet-name> 
<servlet-class>HelloWorld01</servlet-class> 
</servlet> 


<servlet-mapping> 
<servlet-name>HelloWorld01</servlet-name> 
<url-pattern>/HelloWorld01</url-pattern> 
</servlet-mapping> 


</web-app> 


Table 4.483 


4.5.3.6.6 Start the server 


Now you are ready to try to execute your servlet. 
First you need to start your Tomcat server by executing the commands shown in Listing 1 (p. 2132) . 


4.5.3.6.7 Access the servlet file with your browser 
Then type the following address into the address window of your browser and press the Enter key: 
http://localhost :8080/HelloWorld01 


If all goes well, you should see something like Image 1 (p. 2138) in your browser. 
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Image 1 . Output from HelloWorld01 servlet. 
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4.5.3.6.8 Stop the server 


If that is what you see, congratulations. If not, stop the server and go back over the instructions to see if 
you made a mistake somewhere along the way. 


4.5.3.7 Create, deploy, and run a JSP 


As it turns out, it is easier to deploy a JSP than it is to deploy a servlet. First, you don’t need to compile 
the JSP. The Tomcat server will translate it into a servlet and compile it for you. Second, you don’t need 
to modify the file named web.xml . 


4.5.3.7.1 Five required steps 


To create, deploy, and run a JSP, you must accomplish the following steps: 


Create the jsp file. 

Copy the jsp file into the ROOT folder discussed above (p. 2133) . 

Start the server. 

Access the jsp file on the server with your browser. 

Stop the server when you are finished, or when you need to modify the JSP. 


CN eee 


4.5.3.7.2 Create the jsp file 
Begin by copying the contents of Listing 6 (p. 2139) into a file named hello02.jsp 


Listing 6 . The hello02.jsp file. 


<html> 

<head><title>Hello World 02</title></head> 
<body> 

Hello World 02!<br/> 

<% 

out.println("Your IP address is " + 

request .getRemoteAddr()); 

A> 

</body> 

</html> 


Table 4.485 


4.5.3.7.3 Copy the jsp file into the ROOT folder 
Next you need to copy the jsp file named hello02.jsp into the ROOT folder discussed above (p. 2133) . 


4.5.3.7.4 Start the server 


Then you need to start the server. 
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4.5.3.7.5 Access the jsp file with your browser 


Next you need to type the following address into the address window on your browser and press the Enter 
key. 


http://localhost :8080/hel1002. jsp 


If all goes well, you should see something like Image 2 (p. 2141) in your browser. 
) Hello World 02 - Mozilla Firefox 


File Edit View History Bookmarks Tools Help 


1c... [#2] Hello Worl... 3 | 2E T 
mpn 


Hello World 02! 
Your IP address is 127.0.0.1 


) Hello World 02 - sashes Firefox 


ache Tome... PrF Worl... = ACF 
€& eD localhoast:3080/hello0: 5) T a 


@ Share Browser WebEx” | 


Hello World 02! 
Your IP address is 127.0.0.1 
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) Hello World 02 - Mozilla Firefox 


File Edit View History Bookmarks Tools Help 


Ç ® localhost:8080/hello0: * 


i al 


(a) Share Browser WebEx" 


Hello World 02! 
Your IP address is 127.0.0.1 


Image 2 . Output from hello02.jsp. 


| =) Hello World 02 - Mozilla Firefox JA m| xj 
ARET O eee 


mE... [2] Hello Worl... = Pes ee 
© | @ locahost:8030/hello0: * Cc + ê 


Mai 
@ Share Browser WebEx” 


Hello World 02! 
Your IP address is 127.0.0.1 


Table 4.486 


4.5.3.7.6 Stop the server 


If you have been able to replicate the results shown in Image 1 (p. 2138) and Image 2 (p. 2141) , congratu- 
lations, you now have a system that you can use to develop and test both servlets and JSP. 
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4.5.3.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4308: Deploying JSP and Servlets 
e File: Java4308.htm 

e Published: 12/19/13 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


4.5.4 Java4310: Getting Started with JSP” 
4.5.4.1 Table of Contents 


Preface (p. 2142) 
Topics (p. 2143) 
Discussion 

What’s next? (p. 2143) 
Miscellaneous (p. 2145) 


4.5.4.2 Preface 


This module is one in a collection of modules designed for teaching ITSE 2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

The purpose of this module is to provide an overview of the Java Server Pages (JSP) material in this 
course. Previous experience with HTML, CSS, and web programming is not required for this course. Since 
they are not prerequisites, an introduction to HTML, CSS, and web programming is provided. There are no 
homework assignments with this module. All JSP homework assignments are specified in Blackboard (Bb). 
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4.5.4.3 Topics 


Getting Started with JSP 

Web Programming Model 

HTML and CSS Fundamentals 
JSP Fundamentals 

Form Processing with JSP 
Working with Java Classes in JSP 
Cookies with JSP 

Sessions with JSP 


4.5.4.4 Discussion 


Each of the 8 modules in the course is briefly described below. Modules 3-8 contain a variety of HTML, CSS, 
JSP, and Java code examples. It is vital for success that students code the examples and get them working. 
Instructions for establishing a coding development environment are in Bb. The Tomcat JSP server, current 
JDK, and NetBeans IDE are all included in the installation package. 


4.5.4.4.1 Getting Started with JSP 


This current page provides an overview of the JSP topics covered in the course. Each topic listed here is 
also listed in the navigation panel at the left and can be accessed via those links. The topics are arranged 
in sequential order and the content of each is cumulatively based on the preceding topics. Therefore, it 
is recommended that students progress from one module to the next in order. The JSP series of modules 
takes a building block approach. Simple concepts are presented first to establish a foundation upon which 
more complex conceptual structures can be built. It should also be noted that, given the complexity of the 
material, none of the modules provides exhaustive coverage of the topics presented. Rather, the intent of 
the author is to supply sufficient treatment of the material to give students topical groundwork upon which 
practical solutions can be constructed. 


4.5.4.4.2 Web Programming Model 


The web is ubiquitous. From desktops, laptops, tablets, and phones, web access is pervasive and powerful. 
However, the ubiquity comes at the price of complexity for the developer. While traditional application 
developers can concentrate their efforts on designated and contained environments, the web developer pro- 
duces software that interacts with multiple components on servers that could be separated by thousands 
of miles. Fortunately, learning how to develop web-based solutions can (and should) be approached in a 
step-wise manner, building stream lined examples to demonstrate working applications. This course takes 
that approach. The web programming model will be briefly introduced before moving on to the applied 
modules that introduce more involved material. 


4.5.4.4.3 HTML and CSS Fundamentals 


HTML stands for Hypertext Markup Language and is the language that provides the structural framework 
for all web pages. The word hyper implies a jumping from one point to another. The word markup is used 
since tags in languages like HTML resemble a paper that has been ’marked up’ by an editor with various 
notations. The latest version of the language is HTML5 and that is used in the JSP modules. This course 
will only cover enough HTML to facilitate learning JSP. Some students may already have sufficient HTML 
experience. However, since material from each section appears on the JSP exam, it is advisable for all 
students to study all sections. 

Cascading Style Sheets (CSS) is a companion technology to HTML and almost all pages contain compo- 
nents of both. HTML is used to designate structural elements of the page while CSS facilitates the design 
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features of the page such as color, position, style, alignment, etc. It should be noted that all non-trivial 
websites employ CSS extensively to implement design elements. Both HTML and CSS will only be intro- 
duced in this course. Students with more interest in client-side web development are encouraged to further 
pursue HTML and CSS topics. Both are extensive subjects, and, when combined with JavaScript, enable 
construction of Rich Internet Applications (RIAs). 


4.5.4.4.4 JSP Fundamentals 


With HTML alone, web developers are limited to the display of static content in the browser. The early 
web pages were limited by this HTML-only approach. By adding scripting capabilities to the browser (a.k.a. 
client) with languages such as JavaScript, VBScript, and Action Script, web pages began to offer more 
interaction with the user. However, content was still browser-based. Java Server Pages, like other server- 
based programming solutions, is a technology that enables code to run on the web server. By executing 
code on the server, web applications have access to server-hosted databases and other programmatically 
web-accessible content such as web services. 


4.5.4.4.5 Form Processing with JSP 


While client-side interactivity alone can be useful and can provide interesting interfaces for users, most 
organizations with websites desire a more lasting relationship with visitors. Most organizations seek to 
convert visitors into customers or members of the community. To accomplish the conversion, sites usually 
provide registration capabilities. Recording visitor information such as profile data, product selections, 
and sales activities, requires HTML form processing. Users interact with web page form elements such as 
textboxes, checkboxes, selection lists, and submission buttons to send visitor input to the web server. Using 
JSP as the server-side solution is a popular and capable method to process client-submitted form information. 


4.5.4.4.6 Working with Java Classes 


The web, like the majority of modern software implementations, is object-oriented. Objects essentially only 
contain two things, functionality and data. Developers limit the contents of objects to only that functionality 
and data pertaining directly to the object. This focused programming practice enables compartmentalization 
and reuse of code. In Java, like other Object Oriented (OO) languages, a class is a description of an object. 
When the class is requested and loaded into memory (a process called instantiation) an object is created. 
By combining Java classes with JSP, developers can construct more logical and therefore, more maintainable 
code. In the Working with Java Classes module, custom classes are written and objects are instantiated 
from those classes. The data elements and methods of the objects are accessed to demonstrate the power 
and convenience of OO programming. 


4.5.4.4.7 Cookies with JSP 


Hypertext Transfer Protocol (HTTP) is the primary rule specification for communication on the World Wide 
Web. The set of rules outlined by HTTP (and its secure variant - HTTPS), specify the conventions with 
which browsers and web servers communicate with one another. As an open (non-proprietary) protocol, 
HTTP enables any client to connect to any server (unless authentication policies are in place). This free 
association comes at a price which is HTTP’s stateless character. With a stateless protocol, each request 
sent by the browser to the server is independent of previous requests. The browser ’state’ (a.k.a. condition 
or value of data elements) is not preserved on the server. 

Even though there is no storage mechanism specified by the protocol to track client status, web servers 
typically support state management via a combination of cookies, sessions, and databases. Cookies are 
simple text files created by the server and stored on the client. When a URL is entered in a browser, all 
cookies for that domain are included in the Request header that is sent to the server. Cookies consist of 
name::value data pairs which are used on the server to identify and apply various settings for that client. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2140 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


4.5.4.4.8 Sessions with JSP 


Sessions are objects on the server capable of short-term data storage. Using a JSP container generated 
JSESSIONID, developers can associate clients with their sessions on the server. Typically, sessions are 
initiated by the creation of a session object on the server. Then, in the case of JSP, a JSESSIONID identifier 
in the form of a cookie is sent to the client. After the cookie with the id is on the client, the browser will then 
automatically include that cookie in the cookies array which is sent to the server as a part of each Request 
header. 

If cookies are disabled on the client, an alternative method of communication can be employed referred 
to as URL rewriting. This technique involves appending the JSESSIONID onto the URLs that are com- 
municated between the client and server and with intra-server communications. Yet another alternative to 
using cookies is the use of hidden elements. URL rewriting will be discussed briefly but the primary focus 
of the session module will be using a cookie to store and forward the JSESSIONID. 


4.5.4.5 What’s next? 


You are ready to begin the JSP portion of the course by starting with the next module - Web Programming 
Fundamentals. Be ready to devote the required amount of time and concentration to studying the material. 
Enjoy the process. 


4.5.4.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4310: Getting Started with JSP 
e Author: Dr. R.L.Martinez 

e Maintainer: R.G.Baldwin 

e File: Java4310.htm 

e Published: 11/26/13 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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4.5.5 Java4320: Web Programming Model” 
4.5.5.1 Table of Contents 
e Preface (p. 2146) 


Viewing tip (p. 2146) 
x Images (p. 2146) 


Preview (p. 2146) 

General background information (p. 2147) 
Discussion (p. 2147) 

Homework assignment (p. 2149) 
Summary (p. 2150) 

What’s next? (p. 2150) 

Images (p. 2151) 

Miscellaneous (p. 2175) 


4.5.5.2 Preface 


This module is one in a collection of modules designed for teaching ITSE 2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

The purpose of this module is to provide an introduction to the web programming model. The homework 
assignments for this module expose students to supplemental information regarding the topics presented 
herein. 


4.5.5.2.1 Viewing tip 


I recommend that students open another copy of this module in a separate browser window and use the 
following links to easily find and view the Images while you are reading about them. 


4.5.5.2.1.1 Images 


e Image 1 (p. 2152) . Web Programming Model 

e Image 2 (p. 2153) . Default Page Specified 

e Image 3 (p. 2155) . Browser and Server Communication 
e Image 4 (p. 2157) . Web Development Cycle 

e Image 5 (p. 2161) . Output - headerDisplay.jsp 

e Image 6 (p. 2165) . Code - css-header.css 

e Image 7 (p. 2169) . Code - headerDisplay.jsp 

e Image 8 (p. 2171) . Code - headerRequest.jsp 

e Image 9 (p. 2174) . Code - headerAutoRefresh.jsp 

e Image 10 (p. 2175) . Code - headerResponse.jsp 


4.5.5.3 Preview 


To program effectively on the web, it is essential that developers understand the basic elements that comprise 
web software architecture. The fundamental web components from a developer’s perspective are discussed 
in this module. The web programming model consists of the following components: 


e Client (browser) 
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e Server (web server) 
e Databases (database servers) 
e Supplemental Content (additional servers) 


The JSP material in this course covers aspects of the first two. Database interfaces and supplemental content 
are addressed in INEW 2338, a following course at ACC. 


4.5.5.4 General background information 


Like many modern technical implementations, the complete internet architecture is quite complex. Appli- 
cations running on a variety of hardware configurations communicate via more than one hundred possible 
protocols. The sending software packages data into packets consisting of protocol data units (PDU) and 
service data units (SDU). The packets are sent down the TCP/IP protocol stack and across the wire to 
the proper destination. The packets are deconstructed as they ascend the protocol stack and are finally 
processed by the receiving application. 

The data transmission cycle between applications happens with remarkable reliability. Communication 
between client and server is achieved with outstanding quality. When errors or dropped packets do occur, 
checksums and other mechanisms are implemented to correct the transmission mistakes. Naturally, a system 
designed to accomplish such technical feats is by necessity exceptionally complicated. Fortunately, developers 
do not need to comprehend all aspects of web technology to be productive. Furthermore, by taking a building 
block approach in this course, students will learn essential aspects of JSP without encountering unnecessary 
(at this point) complexity. 


4.5.5.5 Discussion 


As listed above, the four components of web development are client, web server, database, and other servers. 
Image 1 (p. 2152) provides a diagrammatic view of the connections linking the essential elements. Even 
though hardware is depicted in the diagram, this course addresses web-related software running on the devices 
shown. This course focuses on the inter-relationships between the browser and the web server particularly 
as they apply to JSP. 


4.5.5.5.1 Browser 


The client computer runs the client software known as the browser in web development. The browser accesses 
the web server software which runs on the physical web server (hardware). Notice that the term web server 
can apply to a software program that hosts websites running on a server. The term web server can also refer 
to the hardware server itself. In this course, web server will generally mean the software hosting websites. 
In a networking course, web server would likely reference the hardware server. 

Users have a number of browser alternatives to access websites and popular options are available for 
download at no charge. Some of the more common choices are: Chrome, Firefox, Internet Explorer, and 
Safari. Each one of these is simply an executable (e.g. chrome.exe, firefox.exe, iexplorer.exe, and safari.exe) 
that provides a means to connect to websites and display site content. 

Browsers are specialized programs designed to process and present results of HTML, CSS, and client- 
side scripting languages such as JavaScript. The majority of processing by browsers is accomplished by the 
engine (a.k.a. layout engine, rendering engine). Some additional processing work is performed by plug-ins or 
extensions. Engines running in popular browsers are Blink-Chrome, Gecko-Firefox, Trident-IE, and WebKit- 
Safari. As an aside, all of the engines listed were written in C++ which is a common language of choice for 
high performance client-based applications. 

One considerable challenge for the web developer exists because each browser engine processes HTML, 
CSS, and JavaScript slightly differently. For instance, in HTML5 (the latest version of HTML) some browsers 
support new features while others do not. Sites like html5test.com can be used to check for browser com- 
patibility with selected features. 
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A key design characteristic of browsers is that some behavior within the browser is limited and controlled. 
For security purposes, access to programs outside of the browser by code running within the browser is 
prohibited. 


4.5.5.5.2 Web Server 


The software web server is an application dedicated to processing requests that originate from browser 
clients. Some popular web servers are: Apache HTTP, Apache Tomcat, Glassfish, Internet Information 
Server, JBoss, Jetty, and WebSphere. Of these seven listed, Apache HTTP and Internet Information Server 
do not support Java servlets which is required to run JSP applications. 

To run JSP solutions, a web server must supply a container in which JSP applications execute. In this 
course, we will use Tomcat to support JSP development and testing. It has a three subsections which are 
particularly relevant. Jasper is the component within Tomcat that parses and compiles JSP into Java servlet 
byte code. After compilation, servlets are run in the Tomcat container called Catalina. Tomcat also uses 
Coyote which is a connector to Apache HTTP server and that enables Tomcat to act as its own HTTP server 
(without running an HTTP server explicitly). 

Catalina executes the byte code provided by Jasper and produces HTML output which is then sent to 
the browser. It is important to note that Jasper is only required to parse and compile byte code once for 
each file which will occur the first time the .jsp file is accessed. Subsequent requests for the file will use the 
byte code previously produced. When the file is re-published with updates, Jasper will again be invoked 
when the file is requested. 


4.5.5.5.3 Browser and Web Server Communication 


When a user types a URL (Uniform Resource Locator) into the address box (a.k.a location.search property) 
of a browser and selects Enter, the browser sends a request to the website identified by the URL. The web 
server packages the request string sent from the browser into a Request object. The web server directs the 
request to the appropriate resource on the server. The appropriate resource is determined by the default 
listing in the welcome-file tag of the web.xml file or by URL specification. In Image 2 (p. 2153) , the index 
file will be served by default. Note: Use of web.xml is optional in the Servlet 3+ specification. 

So, if a user enters java.com in the address box, the request is routed over the internet and will reach the 
appropriate web server where it will be directed to the index page. See Image 3 (p. 2155) . Any server-side 
code on the index page is processed and HTML is produced from that code. A Response object containing 
HTML is generated and a Response header is sent back to the browser. CSS and JavaScript are also sent 
back to the client in the Response header if they were included on the index page. If a user enters a specific 
page, java.com/latest-version.jsp for instance, then that specific page will be processed and returned instead 
of the default (index) page. 


4.5.5.5.4 Development and Testing 


After designing web solutions, developers spend most of their time writing and testing code. The topol- 
ogy depicted in Image 3 (p. 2155) shows the browser and web server communicating across the internet. 
This is the architecture that will be in place for production environments, that is, web users visiting the 
organization’s website. 

However, when developers are working on solutions prior to publication to production servers, they often 
install and use local web servers. These local web servers run on the same machine as the development 
software and the browser(s) used for testing. Image 4 (p. 2157) shows the general steps which comprise 
web development. After all of the required features have been implemented and tested, developers upload 
the new pages to the production environment (a.k.a production) and the new pages can then be accessed by 
users. 

The JSP portion of the course uses NetBeans for the examples. NetBeans is available for download at: 
netbeans.org. There are a number of IDEs (Integrated Development Environment) for Java development 
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including: Eclipse, IntelliJ, JBuilder, JDeveloper, and WebSphere. Any of the listed IDEs can be used 
for development in the JSP portion of this course. But, since the examples are provided in NetBeans, 
students will likely benefit from direct comparisons. Students may even elect to use a simple text editor like 
Notepad++. However, given local server integration requirements and other IDE advantages, students will 
probably find NetBeans to be the most productive. 

Any of the common browsers can be used for testing pages. At least two browsers should be employed 
for page verification due to browser differences. In fact, commercial sites are often verified using multiple 
browsers and versions. It is also recommended that students access html5test.com to verify new HTML 
functionality. 

After code has been designed, developed, and tested on the local machine, the directories and file are 
uploaded to the production server. In this class, the production server is the student website. Students 
should exercise due diligence to confirm that their assignments are functioning correctly on their student 
website. If the pages do not function correctly for the student, the pages will not pass verification testing by 
the professor and the assignment will not receive credit. 


4.5.5.5.5 Request and Response Headers and Objects 


To effectively produce web software, web developers must understand the essential components and oper- 
ations of the Request and Response headers and objects. This module presents an overview of the Re- 
quest /Response processing. The code specifics are not thoroughly considered here and should be reviewed 
after working through the remaining modules in the course. All of the JSP related functionality of Images 
7-10 will be covered in subsequent modules. 

When a URL is entered in the browser, a Request header containing information that may be used by 
server programs is sent from the client to the server. Image 5 (p. 2161) shows an example of Request 
and Response header content. The CSS file is included in Image 6 (p. 2165) as a reference. CSS will be 
introduced in the next module. 

In Image 7 (p. 2169) , the code that produces the table of Request and Response header content is 
displayed. When the Request header arrives at the server, the server converts the content into a Request 
object that contains the header data and methods supplied by the class. Lines 15, 18, and 24 reference 
the processing files that are included in the page. Note: the error icons shown in Images 8, 9, and 10 are 
displayed since each of the files lack import directives. However, the errors are irrelevant since those files are 
all included in Image 7 (p. 2169) which does import the appropriate packages. The error messages could be 
disabled from display but were left on here to provide explanation. 

On line 3 of Image 8 (p. 2171) , the getHeaderNames method of the request object is called to populate 
an Enumeration named fieldnames. Lines 4-9 loops through the Enumeration and produce a table row for 
each field contained in the Request object. Line 3 of Image 9 (p. 2174) sets an auto-refresh interval to 
10 seconds. Based on that setting, the client sends a new Request header and the server responds with a 
Response header every 10 seconds. 

On Image 5 (p. 2161) , the time in blue is shown under the Auto Refresh Header and is produced by 
lines 4-21 of Image 9 (p. 2174) . The header table is produced by lines 3-9 of Image 10 (p. 2175) . In 
particular, on line 5 of Image 10 (p. 2175) , the response.getHeaderFields method is called and returns a 
Map collection with a String and List of Strings as arguments. These are the fields sent from the JSP server 
(Tomcat) to the client. The last line of the Response header shows the server is Apache-Coyote 1.1. Coyote 
is a connector in Apache which enables Catalina (the JSP container in Tomcat) to act as its own HTTP 
server (in addition to a JSP container). 


4.5.5.6 Homework assignment 


See the JSP section in Blackboard for all JSP homework assignments. 
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4.5.5.6.1 Supplemental Reading 


http://www.oracle.com /technetwork /java/javaee/jsp /index.html 77° 
http://www.jsptut.com/Tags.jsp 7?! 
http: //en.wikipedia.org/wiki/OSI_model ??? 
http: //en.wikipedia.org/wiki/Layout_ engine ??3 
http: //www.w3.org/Library /src/HTReq.html 274 
http://html5test.com/ ??° 
http: //en.wikipedia.org/wiki/Apache_Tomca 
Sources referenced outside of the course are for additional educational purposes. While thorough knowl- 
edge and understanding of this supplemental information is not required to complete assignments or prepare 
for the JSP exam, it should be considered standard information for the professional developer. 
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4.5.5.7 Run the program 


I strongly, highly, and emphatically encourage students to write the code from all examples and get them 
working. By reconstructing the code, students gain valuable software development practice and are able to 
modify settings, variables, configurations, etc. to further enhance their understanding of the material. It 
should be considered virtually impossible to learn software development without developing software. 


4.5.5.8 Summary 


This module presented an overview of the web programming model. The important components of the model 
for this course are the client (browser) and web server. To effectively code web solutions it is necessary to 
understand the communication process used to facilitate browser and server interactions. In the development. 
and testing cycle section, the steps and a few implications for developing and testing web solutions were 
presented. 


4.5.5.9 What’s next? 


Now that the environmental foundation is in place, we are ready to begin considering the individual con- 
struction components. HTML and CSS will be reviewed in the next module followed by applications of the 
JSP technology in subsequent modules. 


220http://www.oracle.com/technetwork/java/javaee/jsp /index.html 
22lhttp://www.jsptut.com/Tags.jsp 
?22http://en.wikipedia.org/wiki/OSI_model 
223http://en.wikipedia.org/wiki/Layout_ engine 

24h ttp://www.w3.org/Library/src/HTReq.html 
225http://html5test.com/ 
226http://en.wikipedia.org/wiki/Apache Tomcat 
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Image 1 . Web Programming Model 


Users accessing site via a 
browser 


Accessing site as a Q Accessing site as a 
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development tool browser 
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Table 4.487 
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Image 2 . Default Page Specified 
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4. Request object created 

5. Resource page processed 

6. HTML produced from page 

7. Response object created 

8. Response header containing 
HTML, CSS, and JavaScript sent to 
client 


1. java.com entered in browser 
2. Request header created 

3. Request header sent to server 
9. Response header received 

10. Browser renders HTML, CSS, 
and JavaScript 

11. Cycle repeats 


4. Request object created 

5. Resource page processed 

6. HTML produced from page 

7. Response object created 

8. Response header containing 
HTML, CSS, and JavaScript sent to 
client 
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1. java.com entered in browser 4. Request object created 

2. Request header created 5. Resource page processed 

3. Request header sent to server 6. HTML produced from page 

9. Response header received 7. Response object created 

10. Browser renders HTML, CSS, 8. Response header containing 
and JavaScript HTML, CSS, and JavaScript sent to 
11. Cycle repeats client 


Image 3 . Browser and Server Communication 


1. java.com entered in browser 4. Request object created 
2. Request header created 5. Resource page processed 
3. Request header sent to server 6. HTML produced from page 
9. Response header received 7. Response object created 
10. Browser renders HTML, CSS, 8. Response header containing 
and JavaScript HTML, CSS, and JavaScript sent to 
11. Cycle repeats client 
Table 4.489 
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2. Saves changes browser like Chrome or 
3. Start local web server Firefox 


5. Repeat development cycle 


Image 4 . Web Development Cycle 
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1. Developer writes code in an 4. Developer tests 

IDE like NetBeans changes in a local 

2. Saves changes browser like Chrome or 
3. Start local web server Firefox 


5. Repeat development cycle 


Table 4.490 
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Request Header - Sent from Client to Server 


JSESSIONID=D0724B4130882E20CESEC87D19B0B2E3 


Auto Refresh Header 
11:44:11 


Response Header - Sent from Server to Client 


Content-Type text/html:charset=[SO-8859-1 
Apache Coyote 
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Request Header - Sent from Client to Server 
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Auto Refresh Header 
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Response Header - Sent from Server to Client 


text/html:charset=ISO-8859-1 
Apache-Coyote/1.1 
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Request Header - Sent from Client to Server 


JSESSIONID=D0724B4130882E20CESEC87D19B0B2E3 


Auto Refresh Header 
11:44:11 


Response Header - Sent from Server to Client 


Content-Type text/html:charset=[SO-8859-1 
Apache Coyote 
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Image 5 . Output - headerDisplay.jsp 
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body { 
width: 40%; 
margin: 20px auto; 
text-align: center; 
} 
table, th, td { 
border: 1.5px solid black; 
} 
table { 
display: inline-table; 
margin-bottom: 20px; 


th { 
background-color: plum; 
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body { 
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} 
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Image 6 . Code - css-header.css 
1| /* css-header.css */ 
2| body { 
3 width: 40%; 
4 margin: 20px auto; 
5 text-align: center; 
6 } 
7| table, th, td { 
8 border: 1.5px solid black; 
9| } 
10| table { 
11 display: inline-table; 
12 margin-bottom: 20px; 
13; } 
14| th { 
15 background-color: plum; 
16; } 


Table 4.492 
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<!DOCTYPE html> 
<'-- headerDisplay.jsp --> 
<%@ page import="java.io.*,java.util.*,java.net.*" %> 
<html> 
<head> 
<title>HTTP Header Request</titie> 
<link rel="stylesheet" href="css/css-header.css"> 
</head> 
<body> 


<h2>Request Header - Sent from Client to Server</h2> 


<table> 
<tr> 

<th>Field Name</th><th>Field Value(s)</th> 
</tr> 
<%@ include file="headerRequest.jsp" %> 
</table><br/> 

<h2>Auto Refresh Header</h2> 
<%@ include file="headerAutoRefresh.jsp" %> 
<h2>Response Header - Sent from Server to Client</h2> 
<table> 
<tr> 

<th>Field Name</th><th>Field Value (s)</th> 
</tr> 
<%@ include file="headerResponse.jsp" %> 
</table> 
</body> 
</html> 
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1| <!DOCTYPE html> 

2| <!-- headerDisplay.jsp --> 

3| <%@ page import="java.io.*,java.util.*,java.net.*" %> 
4; <html> 

5| <head> 

6 <title>HTTP Header Request</titie> 

7 <link rel="stylesheet" href="css/css-header.css"> 
8 </head> 

9 <body> 

10 <h2>Request Header - Sent from Client to Server</h2> 
11; <table> 

Ta <tr> 

13 <th>Field Name</th><th>Field Value(s)</th> 

14| </tr> 

15; <%@ include file="headerRequest.jsp" %> 

16, </table><br/> 

17 <h2>Auto Refresh Header</h2> 

18; <%@ include file="headerAutoRefresh.jsp" %> 

19| <h2>Response Header - Sent from Server to Client</h2> 
20; <table> 

ai <tr> 

22 <th>Field Name</th><th>Field Value (s)</th> 

23| </tr> 

24, <%@ include file="headerResponse.jsp" %> 

25| </table> 

26; </body> 

27| </html> 
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<!DOCTYPE html> 
<'-- headerDisplay.jsp --> 
<%@ page import="java.io.*,java.util.*,java.net.*" %> 
<html> 
<head> 
<title>HTTP Header Request</titie> 
<link rel="stylesheet" href="css/css-header.css"> 
</head> 
<body> 


<h2>Request Header - Sent from Client to Server</h2> 


<table> 
<tr> 

<th>Field Name</th><th>Field Value(s)</th> 
</tr> 
<%@ include file="headerRequest.jsp" %> 
</table><br/> 

<h2>Auto Refresh Header</h2> 
<%@ include file="headerAutoRefresh.jsp" %> 
<h2>Response Header - Sent from Server to Client</h2> 
<table> 
<tr> 

<th>Field Name</th><th>Field Value (s)</th> 
</tr> 
<%@ include file="headerResponse.jsp" %> 
</table> 
</body> 
</html> 
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Image 7 . Code - headerDisplay.jsp 
| a] <!DOCTYPE html> E 

2; <!-- headerDisplay.jsp --> 

3| <%@ page import="java.io.*,java.util.*,java.net.*" %> 
4; <html> 

5| <head> 

6 <title>HTTP Header Request</title> 

7 <link rel="stylesheet" href="css/css-header.css"> 
8 </head> 

9 <body> 

10 <h2>Request Header - Sent from Client to Server</h2> 
11; <table> 

12; <tr> 

13 <th>Field Name</th><th>Field Value(s)</th> 

14| </tr> 

15; <%@ include file="headerRequest.jsp" %> 

16, </table><br/> 

17 <h2>Auto Refresh Header</h2> 

18| <%@ include file="headerAutoRefresh.jsp" %> 

19| <h2>Response Header - Sent from Server to Client</h2> 
20; <table> 

21; <tr> 

22 <th>Field Name</th><th>Field Value(s)</th> 

23| </tr> 

24, <%@ include file="headerResponse.jsp" %> 

25| </table> 

26, </body> 

27| </html> 


Table 4.493 
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<%-- headerRequest.jsp --%> 
<$ 
Enumeration fieldNames = request .getHeaderNames (); 
while (fieldNames.hasMoreElements()) { 
String fieldName = (String) fieldNames.nextElement(); 
out.print ("<tr><td>" + fieldName + "</td>\n"); 
String fieldValue = request.getHeader (fieldName) ; 
out.printin("<td> " + fieldValue + "</td></tr>\n"); 
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<%-- headerRequest.jsp --%> 
<$ 
Enumeration fieldNames = request .getHeaderNames (); 
while (fieldNames.hasMoreElements()) { 
String fieldName = (String) fieldNames.nextElement(); 
out.print ("<tr><td>" + fieldName + "</td>\n"); 
String fieldValue = request.getHeader (fieldName); 
out.printlin("<td> " + fieldValue + "</td></tr>\n"); 
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<%-- headerRequest.jsp --%> 
<$ 
Enumeration fieldNames = request .getHeaderNames (); 
while (fieldNames.hasMoreElements()) { 
String fieldName = (String) fieldNames.nextElement(); 
out.print ("<tr><td>" + fieldName + "</td>\n"); 
String fieldValue = request.getHeader (fieldName); 
out.printin("<td> " + fieldValue + "</td></tr>\n"); 


worn» On © 


oO 


$> 
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Image 8 . Code - headerRequest.jsp 
@| <%-- headerReqnuest.jsp --%> 
2 <$ 
1?) Enumeration fieldNames = request.qgetHeaderNames(); 
4 while (fieldNames.hasMoreElements()) { 
5 String fieldName = (String) fieldNames.nextElement(); 
6 out.print ("<tr><td>" + fieldName + "</td>\n"); 
7 String fieldValue = request.getHeader (fieldName) ; 
8 out.println("<td> " + fieldValue + "</td></tr>\n"); 
9 
0 


1 $> 
Table 4.494 
@| <%-- headerAutoRefresh.jsp --%> 
2| Sa 
3 response.setiIntHeader("Refresh", 10); 
Q Calendar calendar = new GregorianCalendar () z 
5 String secondString, minuteString; 
% int hour = calendar. get(Calendar.HOUR); 
% int minute = calendar.get(Calendar.MINUTE); 
Q int second = calendar .get (Calendar .SECOND) ; 
(P if (calendar.get(Calendar.AM_ PM) != 0) 
10 hour += 12; 
alal if (second < 10) 
12 secondString = ":0" + second; 
13 else 
14 secondString = ":" + second; 
15 if(minute < 10) 
16 minuteString = ":0" + minute; 
14} else 
18 minuteString = ":" + minute; 
19 out.printin("<h3 style=\"color: blue\">" + hour 
20 + minuteString + secondString + "</h3>"); 
21| %> 
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<%-- headerAutoRefresh.jsp --%> 


<$ 


$> 


response.setiIntHeader("Refresh", 10); 


Calendar calendar = new GregorianCalendar(); 


String secondString, minuteString; 
int hour = calendar. get(Calendar.HOUR); 
int minute = calendar.get(Calendar.MINUTE); 
int second = calendar.get(Calendar. SECOND); 
if (calendar.get(Calendar.AM PM) != 0) 
hour += 12; 
if(second < 10) 
secondString = ":0" + second; 
else 
secondString = ":" + second; 
if(minute < 10) 
minuteString 
else 
minuteString = ":" + minute; 
out.printin("<h3 style=\"color: blue\">" + hour 
+ minuteString + secondString + "</h3>"); 


":0" + minute; 
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@ <%t-- headerAnutoRefresh.jsp --%> 

2 <$ 

3 response.setIntHeader("Refresh", 10); 

Q Calendar calendar = new GregorianCalendar () z 
5 String secondString, minuteString; 

Q int hour = calendar.get (Calendar .HOUR)}; 

% int minute = calendar.get(Calendar.MINUTE); 
® int second = calendar. get(Calendar.SECOND) ; 
Q if (calendar.get(Calendar.AM PM) != 0) 

10 hour += 12; 

11 if(second < 10) 

12 secondString = ":0" + second; 

eal else 

14 secondString = ":" + second; 

15 if (minute < 10) 

16 minuteString = ":0" + minute; 

17 else 

18 minuteString = ":" + minute; 

19 out.printin("<h3 style=\"color: blue\">" + hour 
20 + minuteString + secondString + "</h3>"); 
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Image 9 . Code - headerAutoRefresh.jsp 
| @| <%-- headerAutoRefresh.jsp --%> E 
2 <% 
3 response.setiIntHeader("Refresh", 10); 
Q Calendar calendar = new GregorianCalendar () 5 
5 String secondString, minuteString; 
o int hour = calendar. get(Calendar.HOUR); 
% int minute = calendar.get(Calendar.MINUTE); 
Q int second = calendar.get (Calendar .SECOND) ; 
Q if (calendar.get(Calendar.AM PM) != 0) 
10 hour += 12; 
11 if(second < 10) 
12 secondString = ":0" + second; 
13 else 
14 secondString = ":" + second; 
15 if (minute < 10) 
16 minuteString = ":0" + minute; 
17 else 
18 minuteString = ":" + minute; 
19 out.printin("<h3 style=\"color: blue\">" + hour 
20 + minuteString + secondString + "</h3>"); 
21; %> 
Table 4.495 
@| <%-- headerResponse.jsp --%> 
2 <$ 
@ URL obj = new URL ("http://localhost:8080"); 
® URLConnection conn = obj.openConnection(); 
@ Map<String, List<String>> map = conn. getHeaderFields(); 
6 for (String key: map.keySet()){ 
7 out.printin("<tr><td>" + key + "</td>\n"); 
8 out.printin("<td>" + conn.getHeaderField (key) + "</td></tr>"); 
9 } 
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<%-- headerResponse.jsp --%> 
<$ 
URL obj = new URL ("http://localhost:8080"); 
URLConnection conn = obj .openConnection (); 
Map<String, List<String>> map = conn.getHeaderFields(); 
for (String key: map.keySet())i 
out.printin("<tr><td>" + key + "</td>\n"); 
out.printin("<td>" + conn.getHeaderField (key) + "</td></tr>"); 
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$> 


<%-- headerResponse.jsp --%> 
<$ 
URL obj = new URL ("http://localhost:8080"); 
URLConnection conn = obj .openConnection (); 
Map<String, List<String>> map = conn.getHeaderFields(); 
for (String key: map.keySet()){ 
out.printin("<tr><td>" + key + "</td>\n"); 
out.printin("<td>" + conn.getHeaderField (key) + "</td></tr>"); 
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Image 10 . Code - headerResponse.jsp 
| | g <%-- headerResponse.jsp --%> | 

2 <$ 
@ URL obj = new URL ("http://localhost:8080"); 
@ URLConnection conn = obj.openConnection(); 
o Map<String, List<String>> map = conn.getHeaderFields(); 
6 for (String key: map.keySet()){ 
7 out. printin("<tr><td>" + key + "</td>\n"); 
8 out.printin("<td>" + conn.getHeaderField (key) + "</td></tr>"); 
9; } 

10) $> 


Table 4.496 


4.5.5.11 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 
e Module name: Java4320: Web Programming Model 
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e Author: Dr. R.L.Martinez 
e Maintainer: R.G.Baldwin 
e File: Java4320.htm 

e Published: 11/26/13 

e Revised 12/24/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.5.6 Java4330: HTML and CSS Fundamentals” 
4.5.6.1 Table of Contents 
e Preface (p. 2176) 


Viewing tip (p. 2177) 
x Images (p. 2177) 


Preview (p. 2177) 

General background information (p. 2177) 
Discussion (p. 2177) 

Homework assignment (p. 2181) 
Summary (p. 2182) 

What’s next? (p. 2182) 

Images (p. 2182) 

Miscellaneous (p. 2230) 


4.5.6.2 Preface 


This module is one in a collection of modules designed for teaching ITSE 2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

The purpose of this module is to provide an introduction to HTML and CSS fundamentals. As a student 
in an intermediate Java programming course, it is likely you have some experience with HTML (Hypertext 
Markup Language) and CSS (Cascading Style Sheets). However, since HTML and CSS knowledge is not a 
prerequisite for this course, a basic overview is presented here. 


227This content is available online at <http://cnx.org/content/m48070/1.7/>. 
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4.5.6.2.1 Viewing tip 


I recommend that students open another copy of this module in a separate browser window and use the 
following links to easily find and view the Images while you are reading about them. 


4.5.6.2.1.1 Images 


) . Code - sample-references. html 

) . CSS File in Folder at Same Level 
Image 12 (p. 2222) . CSS File in Folder at Root Level 

) . BOM and DOM 

) . JavaScript Object Model 


e Image 1 (p. 2184) . Code - HTML Hello World 

e Image 2 (p. 2186) . Output - HTML Hello World 

e Image 3 (p. 2187) . Code - Incomplete HTML Page 
e Image 4 (p. 2188) . Common HTML Elements 

e Image 5 (p. 2189) . HTML5 Semantic Elements 

e Image 6 (p. 2193) . Layout with Semantic Elements 
e Image 7 (p. 2197) . Code - sample-1.html 

e Image 8 (p. 2205) . Code - css-1.css 

e Image 9 (p. 2209) . Output - sample-1-html 

e 

e 

e 

e 

e 


4.5.6.3 Preview 


HTML was the original language of the web and it remains the modern means for developers to establish 
the structural content of web pages. While HTML has the ability to display design behavior such as color, 
position, and style, that facility is limited within HTML and is best handled by CSS. By relegating structure 
to HTML and form (design and style) to CSS, developers are able to successfully focus on one aspect of the 
page at a time. 

The JSP topics in this course are concerned with functionality (not presentation) and therefore CSS 
is only addressed briefly. This module includes a view of HTML5 and CSS3 fundamentals required to 
understand JSP in the web development context. Throughout the course, the terms HTML=HTML5 and 
CSS=CSS3 unless otherwise noted. It is recommended that students access the HTML5 and CSS3 resources 
listed under supplemental reading in the homework section for more information about those technologies. 


4.5.6.4 General background information 


HTML has been the structural language of the web from the beginning. With the growing popularity and 
implementation of HTML5, that dominance shows no signs of abating. For a while in the early 2000s, many 
technologists expected XHTML, an XML-based HTML variant, to replace HTML as the web structural 
language of choice. XHTML offered more rigor than previous versions of HTML and thus presented an 
attractive alternative to the looser HTML5 predecessors. But with the many new elements and greater 
focus on semantics (meaningful markup), HTML5 is now considered the de facto structural web language 
standard. 


4.5.6.5 Discussion 


The primary component in HTML is known as an element. It is the fundamental entity by which all page 
content is presented. The first line on an HTML page (a.k.a. document) identifies the document type. Line 
1 of Image 1 (p. 2184) specifies the document type as HTML5 by supplying the simple html argument. Note 
that HTML elements, unlike XHTML, are not case sensitive. Therefore, DOCTYPE is the same as doctype. 
Line 2 shows the format used for HTML comments. 
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4.5.6.5.1 Elements 


HTML pages can be constructed using a number of various elements. There are approximately 116 elements 
in the HTML5 specification. In Image 1 (p. 2184) , the elements shown are html, head, body, and div. Many 
developers use the words elements and tags interchangeably but there is a difference. Each element consists 
of an opening and closing tag. 


4.5.6.5.2 Tags 


There are a few elements that do not have closing tags and those elements are known as empty (e.g. br, 
hr, img, link, meta, and input). They are referred to as empty (or void in HTML5) because they do not 
contain content between an opening and closing tag. Most elements do have content between the opening 
and closing tags and therefore require both opening and corresponding closing tags. See line 6 in Image 7 
(p. 2197) . The title element has the content "HTML5 Elements" which is the innerHTML property for 
that element. On the other hand, the link element (a void element) on line 7, does not have innerHTML, 
nor a closing tag, and is therefore empty. Notice however that the link element does contain attributes and 
values but is still consider empty (void) without the innerHTML property. 

In Image 1 (p. 2184) , the opening tag for the html element is on line 3 and the closing tag is on line 
11. The html tag is the root tag of the page and must exist for the page to be valid HTML5. An HTML5 
document is said to be valid if it follows the grammar, vocabulary, and syntax of the language specification. 
There are a number of websites that can be accessed to check page validity. A popular choice for validation 
is validator.w3.org. Validation is not required for successful web page rendering. Many of the most heavily 
visited sites on the web do not completely validate. However, validation should be checked to ensure the 
issues are at least known. 

Notice that the opening tag of the html element on line 3 contains lang="en". This combination specifies 
that the page uses the English language. The first part of the pair (lang) is known as the attribute and en 
is known as the value. Element modifiers use the format of attribute="value". The meta element contains 
a charset attribute with its value set to utf-8 which is an international character set standard. 

The head element, shown from lines 4-7 in Image 1 (p. 2184) , is also required for validation. It contains 
other elements such as meta and title. The meta element is used to specify the character set of the page, 
search terms, and other items. The title element determines the title shown in the window title bar (Hello 
World highlighted in Image 2 (p. 2186) ). 

The body element contains the main content of the page. In Image 1 (p. 2184) , the body element only 
contains a div (division) element which is used for content organization. The sentence in the div is output 
and highlighted in Image 2 (p. 2186) . A div is known as a block-level element which means it will, by 
default, be displayed on its own line during output. Inline elements (e.g. span, img, input) on the other 
hand, do not begin a new line. 


4.5.6.5.3 Browser Forgiveness 


Browser engines have a long history of forgiving incomplete and poorly formatted HTML. This approach 
dates back to the early days of the WWW when most authors were not professional developers and could 
therefore be expected to write less than perfect code. The example code in Image 3 (p. 2187) does not 
include required elements like html, head, and body. The NetBeans editor advises of the issues by displaying 
the light bulb symbol on line 2. Even without the most fundamental elements, the example in Image 3 (p. 
2187) produces the same output ( Image 2 (p. 2186) ) as the valid code in Image 1 (p. 2184) . Browsers 
make a good faith attempt to render content based on the code in the page. 

It should be noted that the majority of other modern languages are far more syntactically rigorous than 
HTML. Java, C++, JavaScript, PHP, Python, C#, etc. all require correct syntax for successful compilation 
or just-in-time compilation. 
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4.5.6.5.4 More Elements 


As previously mentioned, there are more than 100 elements in the HTM5 specification. Only a few elements 
will be employed in this course because the focus is on JSP functionality and not web page construction. 
Some of the elements that will be used are listed in Image 4 (p. 2188) . 


4.5.6.5.5 Semantic Elements 


Prior to HTMLS5, portions of web pages were delineated primarily by using the div (division) element. 
However, by employing so many div tags on a page, it became difficult for web developers to follow page 
organization while writing and maintaining code. HTML5 addressed this limitation by adding sematic 
elements, most of which are shown in Image 5 (p. 2189) . 

The term semantic means "of or relating to meaning". It applies in HTML5 since developers are able to 
view the new elements and derive meaning from the names. Headers clearly contain header content while 
navs contain navigation etc. That improvement is in contrast to the pre-HTML5 era when all six of the 
elements would have simply been divs. In the past, additional meaning would be obtained by class or id 
names. The new semantic elements convey purpose without additional attributes and values such as names 
and ids. 

Image 6 (p. 2193) provides a sample layout using the new semantic elements provided by HTML5. Even 
though only one of each element is depicted, pages are not limited to singular instances. Also, elements can 
be nested even though that capability is not shown in Image 6 (p. 2193) . Students are encouraged to learn 
more about these and other elements by visiting links in the supplemental reading portion of the homework 
section. 


4.5.6.5.6 Cascading Style Sheets 


The purpose of HTML is content definition and content structure. The HTML elements on a page define 
the content of the page and the structural framework. CSS is used to specify the style and design aspects 
of the page. CSS is a reasonably broad subject and, together with HTML, can comprise an entire college 
course. In this section, only those characteristics of CSS required for learning JSP are covered. 

It was mentioned above that HTML consists of elements, attributes, and values. The attributes and 
values are used to modify the HTML elements. CSS has analogous components which are known as selectors, 
properties, and values. Element, id, and class selectors are among the more useful selectors available and 
those will be covered below. The selector, property, and value together are known as the declaration (or rule). 
For instance, in Image 8 (p. 2205) , line 12 is the header selector and line 13 includes the background-color 
property and the aqua value. Collectively these are the rule applied to the header selector. 

Type (or element) selectors apply only to the elements(s) listed. For example, on line 30 of Image 8 (p. 
2205) , the ul element has the value of property text-align set to left and it only applies to that element 
type. On the other hand, line 33 applies border settings to table, th, and td elements. 

Id selectors are useful when the intent is to limit the selector to only one instance (or use) per page. On 
line 41 of Image 8 (p. 2205) the id selector #id-th1 is declared. And, it is applied on line 34 of Image 7 (p. 
2197) which means that the header background color for that table will have the color plum set. Note that 
id selectors are implemented using the # sign. Again, id selectors should only be applied once per page. If 
the desired effect was to have all table headers be colored plum then an element selector should be used. For 
more selective control, a class selector could be applied. 

Class selectors are applied to all elements that have that class specified with a class="classname" attribute 
and value combination. The class .center is specified on line 37 of Image 8 (p. 2205) and it is applied on 
lines 19 and 33 of Image 7 (p. 2197) . Both the div and the table in the sample have the class center applied. 
Class selectors can be used with multiple HTML elements. Furthermore, each HTML element can have more 
than one class applied. When applying multiple classes, include all classes within the quotes of the value 
and separate the entries with spaces. 
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There are many selector types and, when used in combination, the variations are virtually limitless. 
However, for the functionality purposes of this course, the selectors listed in Image 8 (p. 2205) will be a 
good place to start. More selectors will be introduced when needed. 


4.5.6.5.7 Code sample-1.html 


The code samples in Image 7 (p. 2197) (sample-1.html) and Image 8 (p. 2205) (css-1.css) together produce 
the output in Image 9 (p. 2209) . To successfully complete the JSP assignments and prepare for the JSP 
exam, students should become proficient with this basic level of HTML5 and CSS3. Let’s walk through the 
code listings to understand the fundamental HTML5 and CSS3 required for the course. On line 7 of Image 
7 (p. 2197) , the css-1.css style sheet is referenced and that file is also listed in Image 8 (p. 2205) . Line 8 
includes a "shiv" to help early browsers work with the semantic elements. More semantic help is included in 
css-1.css file on lines 3 and 4. These compatibility entries are provided here as informational courtesy and 
will not be repeated in subsequent samples. 

Each of the semantic elements as identified in Image 9 (p. 2209) is output by h2 elements in the sample- 
1.html file. For instance, the header h2 is on line 13 and the section h2 is on line 16 of Image 7 (p. 2197) . 
An h3 is used to display the nav element since it is nested within a section element. Lines 19-25 of Image 7 
(p. 2197) include a div which has the CSS center class applied. That class centers the div and sets its width 
to 200px. The center class is also applied to the table on line 33. 

Lines 20-24 of Image 7 (p. 2197) specify an unordered list which contains three list items. Each list item 
has an anchor tag which are hyperlinks to websites. An article element is shown on lines 28-30. A table 
element is included in the aside element on lines 31-43. The table is defined by a table header and two table 
rows. Each of the rows contain two columns which are defined by table data (td) elements. 

The footer on lines 45-48 of Image 7 (p. 2197) is the last semantic element on the page. Notice the word 
copy surrounded by an ampersand and a semicolon in the paragraph element on line 47. It is known as a 
character entity which are used to display special characters that are reserved in HTML. Other character 
entities include the less than, greater than, and ampersand symbols. Entities can be displayed by using the 
name (copy) or number (#169) of the entity. For more information, see the link in the supplemental reading 
section. 


4.5.6.5.8 Code css-1.css 


The CSS listed in Image 8 (p. 2205) is referenced on line 7 of sample-1.html and is therefore applied to 
that document. CSS can be external as in this case, embedded in a style element, or applied directly to the 
element within the element specification. In later modules, samples using of each of the three CSS methods 
are shown. There are multiple advantages to using an external CSS file such as code separation, maintenance, 
and reuse. Therefore, an external CSS file will be used for the most part throughout this course with a few 
exceptions. 

Each of the semantic elements shown in Image 5 (p. 2189) has a type selector declared in Image 8 
(p. 2205) from lines 12-29. The background-color properties are assigned values to provide visual evidence 
of the elements when output. Recall that in CSS the declarations consists of selectors, properties, and 
values. Colors can be assigned by names, hexadecimal, or decimal values. To more clearly make associations 
between HTML and CSS, it is preferred to use color names during demonstrations. Lines 33-43 of Image 8 
(p. 2205) provide examples of multi-type, class, and id selectors. These illustrations supply an elementary 
CSS foundation upon which JSP examples are built. 


4.5.6.5.9 Reference Alternatives 


Almost every HTML file contains references to external resources such as JavaScript and/or CSS files. There 
are a number of methods that can be used to access these files. Relative references point to files relative to 
the current file (in the same file system). Absolute references point to resources on the outside of the current 
file system. 
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Image 10 (p. 2211) provides a list of different approaches on lines 6-9. On line 6 the reference is to a CSS 
file in the same directory (folder) as the current document. On line 7, the CSS file is in the css directory 
and that directory is in the same directory as sample-references.html which is the current file (see Image 12 
(p. 2222) for that structure). Line 8 references a file in a folder that is one level up from the current folder 
(see Image 11 (p. 2215) for that structure). Line 9 is an absolute link to an external resource. 


4.5.6.5.10 BOM and DOM 


Even though the JSP portion of this course is focused on server-side programming, a brief discussion of the 
Browser Object Model (BOM), the Document Object Model (DOM), and JavaScript Object Model may be 
helpful. All three of these models only apply to client web development. Just as the browser has no direct 
way of altering content on the server, the server cannot directly interface with the client object models. 
The BOM is the top-level of the object hierarchy of client web programming. See the diagram in Image 13 
(p. 2226) . All HTML elements and browser window components inherit from the BOM. While there is no 
official standard for the BOM, all major browsers support the second tier BOM objects identified in Image 
13 (p. 2226) . 

The DOM (also shown in Image 13 (p. 2226) ) inherits directly from the BOM. Unlike the BOM, the 
W3C organization maintains the DOM specification standard which outlines changes and updates. The 
DOM is where the vast majority of client-side web development occurs. All HTML elements are children of 
the DOM and only a portion of which are shown in Image 13 (p. 2226) . Notice also the form object has 
a number of direct descendants which are the familiar elements used for data collection on forms (more on 
this is in a subsequent module). The BOM and DOM elements are accessible to JavaScript for traversal and 
manipulation. 

The JavaScript Object Model is shown in Image 14 (p. 2230) . The classes depicted are built-in and native 
to JavaScript implementations in browsers and are available for developer use. The European Computer 
Manufacturers Association (ECMA) produces a script standardization document in which ECMAScript is 
specified. Organizations that produce browsers such as Chrome, Firefox, Internet Explorer, Opera, and 
Safari use the ECMA specification to provide JavaScript engines in browsers. The latest ECMA standard is 
262 Edition 5.1 dated June 2011. New specifications are always in work. See the links in the Supplemental 
Reading section for much more on the BOM, DOM, and ECMAScript (JavaScript). 


4.5.6.6 Homework assignment 


See the JSP section in Blackboard for all JSP homework assignments. 


4.5.6.6.1 Supplemental Reading 


http://www.w3.org/Protocols/rfc2616/rfc2616.html 778 
http: //www.w3.org/TR/html-markup/elements.html 779 
http://www.w3.org/TR/html5/ °° 
http: //validator.w3.org/ ?31 
https: / /developer.mozilla.org/en-US /docs/HTML/Block-level_ elements 7°? 
https: //developer.mozilla.org/en-US/docs/HTML/Tnline_ elements ?°? 
http://www.w3schools.com/html/html5_semantic_elements.asp ?°4 
http: //www.w3schools.com /html/html_colornames.asp 7°° 


228http://www.w3.org/Protocols/rfc2616 /rfc2616.html 
229http://www.w3.org/TR/html-markup/elements.html 
2°http://www.w3.org/TR/html5/ 

31 http://validator.w3.org/ 

?32https://developer.mozilla.org/en-US /docs/HTML/Block-level_ elements 
33https://developer.mozilla.org/en-US/docs/HTML/Inline_ elements 

234 http://www-w3schools.com/html/html5 semantic _elements.asp 
35http://www.w3schools.com/html/html_colornames.asp 
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http://net.tutsplus.com/tutorials/html-css-techniques /the-30-css-selectors-you-must-memorize/ 736 
http: //www.w3schools.com /html/html_entities.asp 7°" 

http: //www.w3schools.com /jsref/dom_obj_document.asp 73° 

http: //www.ecma-international.org / publications /files /ECMA-ST /Ecma-262.pdf ?39 


4.5.6.7 Summary 


This module presented an introductory overview of the HTML5 and CSS3 specifications. Basic page layout 
was introduced and a number of HTML5 elements and CSS3 selectors were discussed. Since the JSP portion 
of the course is focused on JSP functionality, extensive design and style aspects of web page construction 
offered by CSS were not considered. Only the aspects of HTML and CSS essential to understanding JSP 
were introduced. 


4.5.6.8 What’s next? 


Now that the fundamentals of HTML and CSS have been introduced, we are ready to look at the introductory 
aspects of JSP technology in the next module. 


4.5.6.9 Images 


1 <!DOCTYPE html> 

2 ‘ *omment—-—> 

3 <html lang="en"> 

4 <head> 

5 <meta charset="utf-8"> 

6 <title>Hello World</title> 
7 </head> 

8 <body> 

9 <div>Say hello to my little world.</div> 
10 </body> 

11 </html> 


-36http://net.tutsplus.com/tutorials/html-css-techniques/the-30-css-selectors-you-must-memorize/ 
237 http://www.w3schools.com/html/html_entities.asp 
38http://www.w3schools.com/jsref/dom_obj_document.asp 

239 http://www-ecma-international.org/publications/files/ECMA-ST/Ecma-262.pdf 
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1 <!DOCTYPE html> 

2 <!-- Comment--> 

3 <html lang="en"> 

4 <head> 

5 <meta charset="utf-8"> 

6 <title>Hello World</title> 
7 </head> 

8 <body> 

9 <div>Say hello to my little world.</div> 
10 </body> 

11 </html> 

1 <!DOCTYPE html> 

2 <!-- Comment--> 

3 <html lang="en"> 

4 <head> 

5 <meta charset="utf-8"> 

6 <title>Hello World</title> 
7 </head> 

8 <body> 

9 <div>Say hello to my little world.</div> 
10 </body> 

11 </html> 
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Image 1 . Code - HTML Hello World 


1 <!DOCTYPE html> 

2 <!-- Comment--> 

3 <html lang="en"> 

4 <head> 

z <meta charset="utf-8"> 

6 <title>Hello World</title> 
7 </head> 

8 <body> 

9 <div>Say hello to my little world.</div> 
10 </body> 

11 </html> 


Table 4.497 


F [D Hello World x Y 
e c f D file:///1:/ 
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J D Hello World - x { 
& > Œ A D file/// 
CIIL EZ 


ss: Apps 


J D) Hello World A 
@ -> c fi E Me//M7 
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E > G4 A |D file///: 
Apps Ee O Bo Z 


Table 4.498 
<!DOCTYPE html> 
<!-- Comment--> 


w pr 


<!DOCTYPE html> 


<!'-- Comment--> 


w p be 


<!DOCTYPE html> 
<'--—- Comment--> 


w p te 
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Image 3 . Code - Incomplete HTML Page 


1 <!DOCTYPE html> 


3 5 
€ l- {( OQmment——»> 


3 Say hello to my little world. 


Table 4.499 


P | Paragraphs (100% base font size) | 
a [Anchors (hyperlinks)  _ _ č | 
img fmages S 


‘input | Captures input from users 
ul, olli o 


Lists (ordered, unordered 


P | Paragraphs (100% base font size) | 
a [Anchors (hyperlinks) _ _ | 
img mages 
input | Capturesinputfromusers ____ 
ul,ol,li | Lists (ordered, unordered) | 
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Common Elements 
table, th, tr, td 
img ifmages S 


Headings from 200-67% of base font size 


Enables user data collection 
input = | Captures input from users 
‚ul, ol, li | Lists (ordered, unordered 


Table 4.500 


Semantic Elements 
Page or section header 


Navigation 


aside | Sidebar related to other content | 
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aside | Sidebar related to other content | 


aside | Sidebar related to other content | 


Image 5 . HTML5 Semantic Elements 


Semantic Elements 
Page or section header 


aside | Sidebar related to other content | 


Table 4.501 
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<nav> 
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<section> 


> 4 <aside> 
<article> 
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<footer> 
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<header> 
> 4 
<nav> 
r s 4 
b 


<section> 
{d <aside> 
<article> 

ZN 


k "4 
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<header> 

> 4 
<nav> 

r s 4 


<section> 


> 4 <aside> 
<article> 
b S/N 


4 
<footer> 
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Image 6 . Layout with Semantic Elements 


<header> 


<nav> 


<section> 


4 <aside> 


<footer> 


Table 4.502 
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<!doctype html> 
<!--sample-i.html R.L. Martinez--> 
<html lang="en"> 
<head> 
<meta charset="utf-8"> 
<title>HTML5 Elements</title> 
<link rel="stylesheet" href="css/css-1.css"> 
<script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script> 
</head> 
<body> 
<h2>Body</h2> 
<header> 
<h2>Header</h2> 
</header> 
<section> 
<h2>Section</h2> 
<nav> 
<h3>Nav</h3> 
<div class="center"> 
<ul> 
<li>List Item 1: <a href="http://www.kittens.com">Kittens</a></1li> 
<li>List Item 2: <a href="http://www.puppies.com">Puppies</a></1li> 
<li>List Item 3: <a href="http://www.turtles.com">Turtles</a></1li> 
</ul> 
</div> 
</nav> 
</section> 
<article> 
<h2>Article</h2> 
</article> 
<aside> 
<h2>Aside</h2> 
<table class="center"> 
<tr><th id="th-idi" colspan="2">Table Header</th></tr> 
<tr> 
<td>Row i, Col i</td> 
<td>Row 1, Col 2</td> 
</tr> 
<tr> 
<td>Row 2, Col 1</td> 
<td>Row 2, Col 2</td> 
</tr> 
</table> 
</aside> 
<footer> 
<h2>Footer</h2> 
<p>&copy; Copyright 2014 R.L. Martinez, Ph.D.</p> 
</footer> 
</body> 
</html> 
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1| <!doctype html> 

2| <!--sample-i.html R.L. Martinez--> 

3| <html lang="en"> 

4! <head> 

5 <meta charset="utf-8"> 

6 <title>HTMLS Elements</title> 

7 <link rel="stylesheet" href="css/css-1.css"> 

8 <script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script> 
9| </head> 

10; <body> 

11| <h2>Body</n2> 

12| <header> 

13 <h2>Header</h2> 

14| </header> 

15| <section> 

16) <h2>Section</h2> 

17, <nav> 

18 <h3>Nav</h3> 

19 <div class="center"> 

20 <ul> 

21 <li>List Item 1: <a href="http://www.kittens.com">Kittens</a></1li> 
22 <li>List Item 2: <a href="http://www.puppies.com">Puppies</a></1li> 
23 <li>List Item 3: <a href="http://www.turtles.com">Turtles</a></li> 
24 </ul> 

25 </div> 

26| </nav> 

27| </section> 

28; <article> 

29 <h2>Article</h2> 

30| </article> 

31| <aside> 

32 <h2>Aside</h2> 

33 <table class="center"> 

34 <tr><th id="th-idi" colspan="2">Table Header</th></tr> 
35 <tr> 

36 <td>Row 1, Col i</td> 

37 <td>Row 1, Col 2</td> 

38 </tr> 

39 <tr> 

40 <td>Row 2, Col 1</td> 

41 <td>Row 2, Col 2</td> 

42 </tr> 

43 </table> 

44| </aside> 

45| <footer> 

46 <h2>Footer</h2> 

47 <p>&copy; Copyright 2014 R.L. Martinez, Ph.D.</p> 

48 </footer> 

49| </body> 

50; </html> 
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<!doctype html> 
<!--sample-i.html R.L. Martinez--> 
<html lang="en"> 
<head> 
<meta charset="utf-8"> 
<title>HTML5 Elements</title> 
<link rel="stylesheet" href="css/css-1.css"> 
<script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script> 
</head> 
<body> 
<h2>Body</h2> 
<header> 
<h2>Header</h2> 
</header> 
<section> 
<h2>Section</h2> 
<nav> 
<h3>Nav</h3> 
<div class="center"> 
<ul> 
<li>List Item 1: <a href="http://www.kittens.com">Kittens</a></1li> 
<li>List Item 2: <a href="http://www.puppies.com">Puppies</a></1li> 
<li>List Item 3: <a href="http://www.turtles.com">Turtles</a></1li> 
</ul> 
</div> 
</nav> 
</section> 
<article> 
<h2>Article</h2> 
</article> 
<aside> 
<h2>Aside</h2> 
<table class="center"> 
<tr><th id="th-idi" colspan="2">Table Header</th></tr> 
<tr> 
<td>Row i, Col i</td> 
<td>Row 1, Col 2</td> 
</tr> 
<tr> 
<td>Row 2, Col 1</td> 
<td>Row 2, Col 2</td> 
</tr> 
</table> 
</aside> 
<footer> 
<h2>Footer</h2> 
<p>&copy; Copyright 2014 R.L. Martinez, Ph.D.</p> 
</footer> 
</body> 
</html> 
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Image 7 . Code - sample-1.html 


1) <!doctype html> 

2| <!--sample-1.html R.L. Martinez--> 

3| <html lang="en"> 

4| <head> 

5| <meta charset="utf-8"> 

6| <title>HTML5 Elements</title> 

7| <link rel="stylesheet" href="css/css-1.css"> 

8| <script src="http://html5shiv.googlecode.com/svn/trunk/html5.js"></script> 
9| </head> 

10| <body> 

11| <h2>Body</n2> 

12) <header> 

13) <h2>Header</h2> 

14| </header> 

15| <section> 

16) <h2>Section</h2> 

17) <nav> 

18| <h3>Nav</h3> 

19) <div class="center"> 

20 <ul> 

21| <li>List Item 1: <a href="http://www.kittens.com">Kittens</a></1li> 
22| <li>List Item 2: <a href="http://www.puppies.com">Puppies</a></li> 
23| <li>List Item 3: <a href="http://www.turtles.com">Turtles</a></li> 
24| </ul> 

25 </div> 


26| </nav> 

27| </section> 

28; <article> 

29) <h2>Article</h2> 
30| </article> 

31| <aside> 


32 <h2>Aside</h2> 

33| <table class="center"> 

34| <tr><th id="th-idi" colspan="2">Table Header</th></tr> 
35| <tr> 

36| <td>Row 1, Col 1</td> 
37 <td>Row i, Col 2</td> 
38 </tr> 

39| <tr> 

40| <td>Row 2, Col 1</td> 
41| <td>Row 2, Col 2</td> 
42 </tr> 

43| </table> 


44 </aside> 
45; <footer> 


46 <h2>Footer</h2> 

47) <p>&copy; Copyright 2014 R.L. Martinez, Ph.D.</p> 
48) </footer> 

49| </body> 

50| </html> 
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CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


f For HIMLS shiv *; 
article, aside, figure, footer, header, hgroup, 
menu, nav, section { display: block; } 


body { 
width: 50%; 
margin: 0 auto; 
text-align: center; 
background-color: gainsboro; 


} 
header { 
background-color: aqua; 
} 
nav { 
background-color: bisque; 
} 
section { 
background-color: chartreuse; 
} 


article { 
background-color: dodgerblue; 


} 
aside { 
background-color: firebrick; 
} 
footer { 
background-color: green; 
} 
ul { 
text-align: left; 
} 
table, th, td 
{ 
border:ipx solid black; 
} 


-center { 
width: 200px; 
margin: 0 auto; 


} 
#th-idi { 

background-color: plum; 
} 
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CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


f For HIMLS shiv *; 
article, aside, figure, footer, header, hgroup, 
menu, nav, section { display: block; } 


body { 
width: 50%; 
margin: 0 auto; 
text-align: center; 
background-color: gainsboro; 


} 
header { 
background-color: aqua; 
} 
nav { 
background-color: bisque; 
} 
section { 
background-color: chartreuse; 
} 


article { 
background-color: dodgerblue; 


} 
aside { 
background-color: firebrick; 
} 
footer { 
background-color: green; 
} 
ul { 
text-align: left; 
} 
table, th, td 
{ 
border:ipx solid black; 
} 


-center { 
width: 200px; 
margin: 0 auto; 


} 
#th-idi { 

background-color: plum; 
} 
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f For HIMLS shiv *; 
article, aside, figure, footer, header, hgroup, 
menu, nav, section { display: block; } 


body { 
width: 50%; 
margin: 0 auto; 
text-align: center; 
background-color: gainsboro; 


} 
header { 
background-color: aqua; 
} 
nav { 
background-color: bisque; 
} 
section { 
background-color: chartreuse; 
} 


article { 
background-color: dodgerblue; 


} 
aside { 
background-color: firebrick; 
} 
footer { 
background-color: green; 
} 
ul { 
text-align: left; 
} 
table, th, td 
{ 
border:ipx solid black; 
} 


-center { 
width: 200px; 
margin: 0 auto; 


} 
#th-idi { 

background-color: plum; 
} 
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CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Image 8 . Code - css-1.css 


1 


won n oO & WwW NY 


me fF PF PW WOWWWoOW WWWoNN NNN AD HNN N PYF PP PP PY Pe 
ON PrP OF KD MOTH OF WNP OF WW HA OF WNHPrP OF KO WITH WO & WHY FP OO 


RT Martinez * 


z 
5 shiv */ 


article, aside, figure, footer, header, hgroup, 
menu, nav, section { display: block; } 


body { 
width: 50%; 
margin: 0 auto; 
text-align: center; 
background-color: gainsboro; 
} 
header { 
background-color: aqua; 
} 
nav { 
background-color: bisque; 
} 
section { 
background-color: chartreuse; 
} 
article { 
background-color: dodgerblue; 


} 
aside { 
background-color: firebrick; 
} 
footer { 
background-color: green; 
} 
ul { 
text-align: left; 
} 
table, th, td 
{ 
border:1px solid black; 
} 


-center { 
width: 200px; 
margin: 0 auto; 
} 
#th-idi { 
background-color: plum; 


} 
Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2201 
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[Æ] HTMLS Elements 
€ C fi 


i Aps MM @agtgx«« xa ves 


B localhost:8080/itse23 17-jsp/sample-1.html g| # 


» [3 Other bookmarks 


Body 


Nav 
e List Item 1: Kittens 


e List Item 2: Puppies 
e List Item 3: Turtles 


Table Header 
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[a] HTMLS Elements 
€ C fi |D localhost:8080/itse2317-jsp/sample-1.htmi 927| # = 
i Apps Bo O xxx m SS » ( Other bookmarks 


Body 


Nav 
e List Item 1: Kittens 


e List Item 2: Puppies 
e List Item 3: Turtles 


Table Header 
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[Æ] HTMLS Elements 
€ C fi |D localhost:8080/itse2317-jsp/sample-1.htmi 927| # = 
i Apps Bo O xxx m SS » ( Other bookmarks 


Body 


Nav 
e List Item 1: Kittens 


e List Item 2: Puppies 
e List Item 3: Turtles 


Table Header 
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Image 9 . Output - sample-1.html 


[a] HTMLS Elements 
€ C fi D localhost:8080/itse23 le-1.html 37) @ = 
2 Apps B® D xxx 0 SS » (0 Other bookmarks 


Body 


Nav 
e List Item 1: Kittens 


e List Item 2: Puppies 
e List Item 3: Turtles 


Table Header 


Table 4.505 
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<!doctype html> 


<!-- sample-references.html --> 
<html> 
<head> 


<title>Link References</title> 
<link rel="stylesheet" href="css-1.css"> 
<link rel="stylesheet" href="css/css-1.css"> 
<link rel="stylesheet" href="../css/css-1.css"> 
<script src="http://htmlSshiv.googlecode.com/svn/trunk/html15.js"></script> 
</head> 
<body> 
<div>JSP is great!</div> 
</body> 
</html> 


<!doctype html> 


<!-- sample-references.html --> 
<html> 
<head> 


<title>Link References</title> 
<link rel="stylesheet" href="css-1.css"> 
<link rel="stylesheet" href="css/css-1.css"> 
<link rel="stylesheet" href="../css/css-1.css"> 
<script src="http://htmlSshiv.googlecode.com/svn/trunk/htm15.js"></script> 
</head> 
<body> 
<div>JSP is great!</div> 
</body> 
</html> 


<!doctype html> 


<!-- sample-references.html --> 
<html> 
<head> 


<title>Link References</title> 
<link rel="stylesheet" href="css-1.css"> 
<link rel="stylesheet" href="css/css-1.css"> 
<link rel="stylesheet" href="../css/css-1.css"> 
<script src="http://htmlSshiv.googlecode.com/svn/trunk/htm15.js"></script> 
</head> 
<body> 
<div>JSP is great!</div> 
</body> 
</html> 
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Image 10 . Code - sample-references.html 
| 1 <!doctype html> ~ 
2 
3| <html> 
4 <head> 
5 <title>Link References</title> 
6 <link rel="stylesheet" href="css-1.css"> 
7 <link rel="stylesheet" href="css/css-1.css"> 
g <link rel="stylesheet" href="../css/css-1.css"> 
9 <script src="http://html5Sshiv.googlecode.com/svn/trunk/html5.js"></script> 
10 </head> 
11 <body> 
12 <div>JSP is great!</div> 
13 </body> 
14| </html> 


Table 4.506 
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Image 11 . CSS File in Folder at Root Level 


Projects Files X | Services 


build.xml 


Table 4.507 
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Table 4.508 
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Image 13 . BOM and DOM 


Table 4.509 
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Image 14 . JavaScript Object Model 
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Table 4.510 


4.5.6.10 Miscellaneous 


This section contains a variety of miscellaneous information. 
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Housekeeping material 


e Module name: Java4330:HTML and CSS Fundamentals 
e Author: Dr. R.L.Martinez 

e Maintainer: R.G.Baldwin 

e File: Java4330.htm 

e Published: 11/26/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.5.7 Java4340: JSP Fundamentals” 
4.5.7.1 Table of Contents 
e Preface (p. 2231) 


Viewing tip (p. 2232) 
x Images (p. 2232) 


Preview (p. 2232) 

General background information (p. 2232) 
Discussion (p. 2232) 

Homework assignment (p. 2234) 
Summary (p. 2235) 

What’s next? (p. 2235) 

Images (p. 2235) 

Miscellaneous (p. 2252) 


4.5.7.2 Preface 


This module is one in a collection of modules designed for teaching ITSE 2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

With the coverage of HTML and CSS in the previous module, we are ready to look at the fundamentals 
of JSP (JavaServer Pages). The purpose of this module is to provide an introduction to JSP and consider 
some of the essentials aspects of JSP programming. 


240 This content is available online at <http://cnx.org/content /m48075/1.11/>. 
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4.5.7.2.1 Viewing tip 


I recommend that students open another copy of this module in a separate browser window and use the 
following links to easily find and view the Images while you are reading about them. 


4.5.7.2.1.1 Images 


e Image 1 (p. 2236) . JSP Tags 

e Image 2 (p. 2240) . Code - jsp_tags.jsp 

e Image 3 (p. 2244) . Output - jsp_tags.jsp 

e Image 4 (p. 2245) . Code - sample_included_file.jsp (w/ errors) 
e Image 5 (p. 2247) . Code - sample_included _file.jsp 

e Image 6 (p. 2247) . Console Ouput - jsp_ tags.jsp 

e Image 7 (p. 2251) . View Source - jsp_tags.jsp 


4.5.7.3 Preview 


There are three locations where processing can occur in web development: the client, web server, and other 
servers. This course considers the second area, programs which run on the web server. In particular, programs 
in Java as JSP are the focus of this and all subsequent modules. Since this portion of the course is the last 
section of an intermediate Java programming course, emphasis will not be placed on Java syntax. Rather, 
the focus is on JSP within the web context. Motivation: A web developer with server-side programming 
skills is a valuable addition to software development teams, especially in large organizations with complex 
web processing requirements. Furthermore, Java web development offers a rich and powerful platform upon 
which enterprise-level solutions are constructed. 


4.5.7.4 General background information 


JSP are a server-side processing solution. In essence, JSP are simply HTML pages with Java code inserted 
into the page. When the user accesses a JSP via a browser, the page is processed by compiling and running 
the Java code in the page which produces HTML formatted output. The first time a JSP is accessed, the 
code is parsed and then compiled into a servlet instance (Java bytecode executable). All subsequent visits 
to the page use the original compiled executable but a new thread is created for each new visit. Each thread 
contains local variables that are visible only to that thread. 

The single servlet instance (object) contains instance variables that are confined to that instance. How- 
ever, since the instance is shared by its generated threads, all threads have visibility and access to the 
instance variables. The output of the threads, along with the original HTML, is sent back to the browser in 
the form of a message body of a Response object(s). 

As a server-based processing technology, JSP are directly analogous to other server-side processing solu- 
tions such as ASP.NET and PHP. JSP files have the .jsp extension. ASP.NET files are identified by .aspx 
and PHP files end with .php. Each of these three file types run on the server and send processed HTML 
output back to the client. The good news for developers is that practical proficiency with one server-side 
programming model can transfer readily into preliminary understanding of the other technologies. 


4.5.7.5 Discussion 


In this module, the basic JSP model is considered in the context of the tags it enables. Unlike HTML 
with more than over 100 elements, there are only 5 JSP tags and those are listed in Image 1 (p. 2236) . 
By understanding the purpose of each tag type and viewing tags in code context, students will develop an 
overview perspective of JSP. 
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4.5.7.5.1 JSP Tags 


Recall from the previous module that HTML elements consist of opening and closing tags. Also recall that 
JSP are essentially HTML pages with Java code inserted. When Java code appears on JSP it is enclosed in 
tags. Image 1 (p. 2236) shows the 5 types of JSP tags available. 


4.5.7.5.2 Scriptlet Tag 


The scriptlet tag is used to enclose blocks of Java code on JSP. It is the primary tag used on JSP since 
it normally will contain the most code. NetBeans conveniently colors the scriptlet and expression sections 
green for easy visual identification. In Image 2 (p. 2240) , see lines 11, 13, 17-25, 28-29, 29-31, 31-34, and 
36-39 for examples of green highlights. The first pair of scriptlet tags (lines 17-25) enclose comments and the 
first portion of a for loop. Note that both forms of Java comments are supported within scriptlet tags (lines 
18-21). The scriptlet section is terminated by the closing tag on line 25. However, the loop is not complete. 
Rather, lines 26-30 are HTML inserted in the scriptlet loop. This is a common method of interspersing 
scriptlet code with HTML code. The loop is continued and enclosed on lines 31-32. Observe that the closing 
brace of the loop (Java code) is on line 32. See the page output in Image 3 (p. 2244) . By iterating 3 times, 
the loop produces the table depicted with 3 rows and 3 columns. The last scriptlet line on the page is line 
39 on which the instance variable globalCount is incremented. More on globalCount below. 


4.5.7.5.3 Expression Tag 


The expression tag is used to compile and run Java code and convert the output into string expressions. 
Note that semicolons are not required in expressions since the line is an expression and not a statement that 
requires termination. In Image 2 (p. 2240) , the expression tag is used on lines 11, 13, 28-29, and 37-38. 
Lines 11 and 13 instantiate date objects and output the contents as HTML. Notice the output in Image 3 (p. 
2244) . Line 11 produces the output line: "Hello!...". Where is the output from line 13? More on that when 
the comment tag is discussed below. The expression tags on lines 28-29 produce the number and local Var 
output in the table. The expression tags on lines 37-38 produces the globalCount and localVar output. 


4.5.7.5.4 Directive (Include) Tag 


The directive tags are used on lines 3 and 4 of Image 2 (p. 2240) . In the first version on line 3, a file 
is included (sample_included_file.jsp) by using the include directive. By including a file using the include 
directive, it is just as though the contents of the source file were typed directly into the destination file. In 
the example on line 3 of Image 2 (p. 2240) , the included file, sample_included_file.jsp is listed in Image 5 
(p. 2247) . The resulting output of the file (lines 6 and 11 from Image 5 (p. 2247) ) can be seen in the top 
2 output lines of Image 3 (p. 2244) . You may be wondering, where is the output from line 8 of Image 5 (p. 
2247) ? It is located in the console output window of the JSP server and looks like Image 6 (p. 2247) . 

There are a few more things to observe about the included file. Notice another version of the sam- 
ple_included_file.jsp file is depicted in Image 4 (p. 2245) . Lines 1 and 6 have advisory and error messages 
respectively. The line 1 advisory message relates to missing doctype and header elements. That message 
is removed by the lines 2 and 3 of Image 5 (p. 2247) . The error message on line 6 of Image 4 (p. 2245) 
relates to an unknown symbol Date. That issue is resolved by adding line 4 of Image 5 (p. 2247) . It should 
be noted that the Image 4 (p. 2245) version of the sample_ included _file.jsp will operate correctly when 
included by jsp_tags.jsp in Image 2 (p. 2240) . This is because the required elements that were missing in 
Image 4 (p. 2245) are included in Image 2 (p. 2240) . 


4.5.7.5.5 Directive (Page) Tag 


Another type of JSP directive tag used is page and can be observed on line 4 of Image 2 (p. 2240) . When 
used with the import attribute, the page directive imports Java classes that are available to the entire page. 
This behavior is directly analogous to using the import statement in Java files. In the example on line 4, 
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since the asterisk is used, all classes that are part of the java.util package are imported. Since only Date is 
used in this example, the import operation could be made more specific by using java.util.Date and then 
only the Date class would be imported. Notice the Date() constructor from the Date class is called on lines 
11 and 13 of Image 2 (p. 2240) . 


4.5.7.5.6 Comment Tag 


Lines 14 and 15 of Image 2 (p. 2240) show examples of the JSP comment tag. This format is used on JSP 
pages outside of scriptlet tags. The contents of the JSP comment tags are not compiled, executed, or sent 
back to the browser. On the other hand, regular HTML comments (lines 12 and 13 of Image 2 (p. 2240) ) 
are compiled, executed, and sent back to the browser. However, that content is not displayed. To see this 
in action, view jsp_tags.jsp in a browser, right-click, and select View Source. That will display Image 7 (p. 
2251) . The output on lines 21 and 22 of Image 7 (p. 2251) correspond to the comments on lines 12 and 13 
of Image 2 (p. 2240) . Notice that the Java expression tag has been executed and produced the date output 
in the View Source. However, that content is not displayed. The JSP comment tags on lines 14 and 15 of 
Image 2 (p. 2240) do not even appear in the View Source of the page since they are not sent from the server 
to the browser. Also, notice the other empty lines on the View Source of Image 7 (p. 2251) correspond to 
JSP tags on Image 2 (p. 2240) . 


4.5.7.5.7 Declaration Tag 


The last JSP tag to consider here is the declaration tag. The declaration JSP tag is used to declare instance 
variables and methods. On the surface, this concept appears different from the instance variables and 
methods of classic Java classes. However, behind the scenes, the JSP container creates a servlet class and 
subsequent object from the JSP of Image 2 (p. 2240) . At the point of instantiation, an instance variable is 
created for globalCount in Image 2 (p. 2240) . globalCount is shared by all sessions accessing the servlet for 
Image 2 (p. 2240) and as such is not thread-safe (meaning one browser session can modify a variable in use 
by another browser session). On the other hand, localVar in Image 2 (p. 2240) is created with a scriptlet 
tag and is thus local to each thread allocated by the JSP container. Therefore each browser accessing the 
servlet will have its own copy of localVar. 

Line 36 of Image 2 (p. 2240) includes the only declaration tag on the page. It is not commonly employed 
because the items it declares are global in character and are not thread-safe. This means that multiple 
threads (browsers accessing the page) have access to the same variable in memory. The different behavior 
of localVar and globalCount is exhibited in Image 3 (p. 2244) . In this demonstration, 3 separate browser 
sessions are opened in reasonably rapid succession. Chrome is opened, then IE, and then Firefox. Notice 
that globalCount is incremented on line 39 of Image 2 (p. 2240) and the incrementation is observed in each 
of the browser sessions. Alternatively, localVar is set to 99 on line 33 of Image 2 (p. 2240) but that value is 
local to each browser session and is therefore not reflected in the table output of localVar (it reverts to 0, 1, 
2 in each new session). 

To see this behavior in operation for yourself, open two separate browser sessions that point to 
jsp_tags.jsp (the code in Image 2 (p. 2240) ). Notice that the value of globalCount is shared among 
the browsers. Refresh one of the browsers 3 times and observe globalCount incrementing. Now, refresh the 
other browser and notice the value of globalCount jumps by 3. This behavior is not normally desired and 
therefore will not be used in this course. Like instance variables, instance methods can also be declared 
within JSP. However, it is usually preferable to code methods in separate Java classes. Importing Java 
classes is a technique which is covered more thoroughly in a later module. 


4.5.7.6 Homework assignment 


See the JSP section in Blackboard for all JSP homework assignments. 
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4.5.7.6.1 Supplemental Reading 


http://www.oracle.com /technetwork /java/javaee/jsp /index.html 744 


http://www.jsptut.com/Tags.jsp 24? 
http: //docs.oracle.com/cd/B14099_19/web.1012/b14014/getstart .htm#i1008051 74% 


4.5.7.7 Summary 


This module presented an overview of JSP fundamentals. When considering JSP, it is important to remember 
that JSP are simply HTML pages with Java inserted. The Java is inserted by using JSP tags. In this module, 
the JSP model was considered from the perspective of the 5 JSP tags which are utilized to define Java content 
in JSP. All of the future JSP content covered in this course will be enabled via JSP tags. 


4.5.7.8 What’s next? 


Now that the fundamentals of JSP have been presented via JSP tags, we will consider applications of JSP 
that utilize server functionality. This is covered in the next module, Form Processing with JSP. 


4.5.7.9 Images 


JSP Tag JSP Name 
Scriptlet Insert Java statements 


<%= %> Display string value 


Set whole page conditions 
Not returned to browser 
Declare instance variables or methods 


<% %> 
<%= %> 
<%@ %> 
<%-- --%> 
<%!__%> 


<%= _%> 
<%!__%> 


241 http://www.oracle.com/technetwork/java/javaee/jsp /index.html 
42 http://www.jsptut.com/Tags.jsp 
43http://docs.oracle.com/cd/B14099_19/web.1012/b14014/getstart .htm#i1008051 
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Image 1 . JSP Tags 


<%= _%> 
<%@ %> 


Table 4.511 
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<!DOCTYPE html> 


por t re 7 
<! jsp_tags. 


sp --> 


J 


<%@ include file="sample_included file.jsp" %> 
<%@ page import="Jjava.util.*" $> 


<html> 
<head> 


<title>JSP Tags</title> 


</head> 
<body> 


<hi>JSP Tags</hi> 


<h2>Hello! The time is now <%= new Date() %></h2> 

<!-- HTML comment - compiled and executed but not displayed. --> 

<!-- <h2>Hello! The time is now <%= new Date() %></h2> --> 

<%-- JSP comment - not compiled, executed, or returned to browser. --%> 


<%-- <h2>Hello! The time is now <%= new Date() %*></h2> --%> 
<table border="i"> 


<$ 


// This is a comment 


/* 


This is a comment 


«f/f 


int localVar= 0; 


int n = 3; 


for ( int i = 02: 2 <n: itF } £ 


$> 
<tr> 


<td>Number & localVar</td> 
<td><%= i+1 %></td> 
<td><%= localVar++ ></td> 


</tr> 


<$% 
} 


localVar = 99; 


$> 
</table> 


<%! int globalCount = 0; %> 

<p>This is globalCount: <%= globalCount %></p> 
<p>This is localVar <%= localVar %></p> 

<$% ++globalCount; $> 


</body> 
</html> 
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<!DOCTYPE html> 
<!-- jsp_tags.jsp --> 
<%@ include file="sample_included file.jsp" %> 
<%@ page import="Jjava.util.*" $> 
<html> 
<head> 
<title>JSP Tags</title> 
</head> 
<body> 
<hi>JSP Tags</hi> 
<h2>Hello! The time is now <%= new Date() %></h2> 
<!-- HTML comment - compiled and executed but not displayed. --> 
<!-- <h2>Hello! The time is now <%= new Date() %></h2> --> 


<%-- JSP comment - not compiled, executed, or returned to browser. 


<%-- <h2>Hello! The time is now <%= new Date() %></h2> --%> 
<table border="i"> 


<$ 
// This is a comment 
/* 

This is a comment 
w/ 


int localVar= 0; 
int n = 3; 
for ( ine I= (ip ab cg py eh A 
$> 
<tr> 
<td>Number & localVar</td> 
<td><$= i+1 $></td> 
<td><$= localVar++ %></td> 
</tr> 
<$ 
} 
localVar = 99; 
$> 
</table> 
<%! int globalCount = 0; %> 
<p>This is globalCount: <%= globalCount %></p> 
<p>This is localVar <%= localVar %></p> 
<% ++globalCount; $> 
</body> 
</html> 
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<!DOCTYPE html> 


<!-- jsp_tags.j 


sp --> 


J 


<%@ include file="sample_included file.jsp" %> 
<%@ page import="Jjava.util.*" $> 


<html> 
<head> 


<title>JSP Tags</title> 


</head> 
<body> 


<hi>JSP Tags</hi> 


<h2>Hello! The time is now <%= new Date() %></h2> 

<!-- HTML comment - compiled and executed but not displayed. --> 

<!-- <h2>Hello! The time is now <%= new Date() %></h2> --> 

<%-- JSP comment - not compiled, executed, or returned to browser. --%> 


<%-- <h2>Hello! The time is now <%= new Date() %*></h2> --%> 
<table border="i"> 


<$ 


// This is a comment 


/* 


This is a comment 


«f/f 


int localVar= 0; 


int n = 3; 


for ( int i = 02: 2 <n: itF } £ 


$> 
<tr> 


<td>Number & localVar</td> 
<td><%= i+1 %></td> 
<td><%= localVar++ ></td> 


</tr> 


<$% 
} 


localVar = 99; 


$> 
</table> 


<%! int globalCount = 0; %> 

<p>This is globalCount: <%= globalCount %></p> 
<p>This is localVar <%= localVar %></p> 

<$% ++globalCount; $> 


</body> 
</html> 
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Image 2 . Code - jsp_tags.jsp 
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<!DOCTYPE html> 


Zine sen t 
p 


acs.isp --> 


<%@ include file="sample included file.jsp" %> 
<%@ page import="Java.util.*" $> 
<html> 
<head> 
<title>JSP Tags</title> 
</head> 
<body> 
<hi>JSP Tags</hi> 
<h2>Hello! The time is now <%= new Date() %></h2> 


gine. HWTMT 


comment - 


he 


<%-- JSP comment - not compiled, executed, or returned to browser. 


<%-- <h2>Hello! The time is now <%= new Date() *></h2> --%> 
<table border="i"> 
<$% 


This is a comment 


int localVar= 0; 
int n = 3; 
Tor C ine im ft eD ele pt 
$> 
<txz> 
<td>Number & localVar</td> 
<td><%= i+1 %></td> 
<td><%= localVar++ %></td> 
</tr> 
<$% 
} 
localVar = 99; 
=> 
</table> 
<%! int globalCount = 0; %> 
<p>This is globalCount: <%= globaliCount %></p> 
<p>This is localVar <%= locaiVar %></p> 
<$% ++globalCount; $> 
</body> 
</html> 


--%> 


Table 4.512 
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Hello from included file: sample_included_file.jsp 


Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013 


JSP Tags Chrome 


Hello! The time is now Sun Dec 08 13:22:08 CST 2013 
Numi mber & localVar |1 [O] @ [E] hitp://locathost:2080/it: O ~ © |) A localhost 


{Number & tocalVar [2 (11 
SET: Hello from included file: sample_included_file.jsp IE 
Saara Hello! Time fi included file: Sun Dec 08 13:22:15 CST 2013 
ello! Time from an included file: Sun Dec 2:22:15 
This is localVar 99 
JSP Tags 
Hello! The time is now Sun Dec 08 13:22:15 CST 2013 
Se 
[Number & localVar][1](0] | FR) http.//tocainost:8060..317-jsp/isp_tagsisp| + | = ee 
[Number & localVas]2|[I]} |g. jocatnost 2000/2021? jp jp. tes e |E- Googie PD- b A 
[Number & localVae)2) | 


ThisisalobalCount:1 Hello from included file: sample_included_file.jsp Firefox 


This is localVar 99 
| Hello! Time from an included file: Sun Dec 08 13:22:19 CST 2013 


JSP Tags 


| Hello! The time is now Sun Dec 08 13:22:19 CST 2013 


Number & localVar|1 [0 
Number & localVar |2 |1 
Number & localVar [3 [2 
“his is globalCount: 2 


2 


b 
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Hello from included file: sample_included_file.jsp 


Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013 


JSP Tags Chrome 


Hello! The time is now Sun Dec 08 13:22:08 CST 2013 


[Number & localVar [1f] (<) [E] hitp://locathost:2080/it: O ~ © |) [E] localhost 
[Number & localVar [21| 


Plantes & oea Hello from included file: sample_included_file.jsp IE 
COENEN Hello! Time fi included file: Sun Dec 08 13:22:15 CST 2013 
ello! Time from an included file: Sun Dec 222: 
This is localVar 99 
JSP Tags 
Hello! The time is now Sun Dec 08 13:22:15 CST 2013 
JE 
[ember & locata] [E] tp/nocho sn. 217fe oi E] 
[Number & tocatVar |in] € @ localhost 8030/itse2317-jsp/jsp_təgsjsp C |B- Googie P n- + tf 
umber & localVa = 


Hello from included file: sample_included_file.jsp Firefox 


Hello! Time from an included file: Sun Dec 08 13:22:19 CST 2013 


JSP Tags 
Hello! The time is now Sun Dec 08 13:22:19 CST 2013 
Number & local Var |1 


Number & local Var [2 
Number & localVar|3 


P=] S] 
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Hello from included file: sample_included_file.jsp 


Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013 


JSP Tags Chrome 


Hello! The time is now Sun Dec 08 13:22:08 CST 2013 
Numi mber & localVar |1 [O] @ [E] hitp://locathost:2080/it: O ~ © |) A localhost 


{Number & tocalVar [2 (11 
SET: Hello from included file: sample_included_file.jsp IE 
Saara Hello! Time fi included file: Sun Dec 08 13:22:15 CST 2013 
ello! Time from an included file: Sun Dec 2:22:15 
This is localVar 99 
JSP Tags 
Hello! The time is now Sun Dec 08 13:22:15 CST 2013 
Se 
[Number & localVar][1](0] | FR) http.//tocainost:8060..317-jsp/isp_tagsisp| + | = ee 
[Number & localVas]2|[I]} |g. jocatnost 2000/2021? jp jp. tes e |E- Googie PD- b A 
[Number & localVae)2) | 


ThisisalobalCount:1 Hello from included file: sample_included_file.jsp Firefox 


This is localVar 99 
| Hello! Time from an included file: Sun Dec 08 13:22:19 CST 2013 


JSP Tags 


| Hello! The time is now Sun Dec 08 13:22:19 CST 2013 


Number & localVar|1 [0 
Number & localVar |2 |1 
Number & localVar [3 [2 
“his is globalCount: 2 


2 


b 
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Image 3 . Output - jsp_tags.jsp 


Hello from included file: sample_included_file.jsp 


Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013 


JSP Tags Chrome, 


Hello! The time is now Sun Dec 08 13:22:08 CST 2013 


[Number & localVar[i]0) 


(<) [E] http:/localhost8080/it O ~ © E] localhost 
= & localV: re 


Hello from included file: sample_included_file.jsp IE 
Hello! Time from an included file: Sun Dec 08 13:22:15 CST 2013 


JSP Tags 
Hello! The time is now Sun Dec 08 13:22:15 CST 2013 
( Firefox = 


[Nomber& roaie 
[Number & local Varl 2|1] 
[Number & local Var]|3|(2) 


| E] http://localhost:8080...317-jsp/jsp_tagsjsp + 
¢ © localhost itse2317-jsp/jsp_tags.jsp c B- oogie 


PD- + ff 


ThisisglobalCowt l | Hello from included file: sample_included_file.jsp Firefox 


Hello! Time from an included file: Sun Dec 08 13:22:19 CST 2013 


JSP Tags 


Hello! The time is now Sun Dec 08 13:22:19 CST 2013 


Number & localVar |1 
Number & localVar |2 
Number & local Var [3 


Riis) 


This is globalCount: 2 
This is localVar 99 


Table 4.513 


<%-- sample included file.jsp --%> 
<hr> 


<$% 


Date date = new Date(); 
$> 


worgpnun se wo no 


<hr> 
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System.out.printin( "Printed from Java..." ); 


<h2>Hello from included file: sample included file.jsp</h2> 


<h2>Hello! Time from an included file: <%= date %></h2> 
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<%-- sample included file.jsp --%> 
<hr> 
<h2>Hello from included file: sample included file.jsp</h2> 
<% 
System.out.printin( "Printed from Java..." ); 
Date date = new Date (); 
$> 
<h2>Hello! Time from an included file: <$= date $></h2> 
<hr> 


<%-- sample included file.jsp --%> 
<hr> 
<h2>Hello from included file: sample included file.jsp</h2> 
<$% 
System. out.printin( "Printed from Java..." ); 
Date date = new Date (); 
$> 
<h2>Hello! Time from an included file: <%= date %></h2> 
<hr> 


© œ Ip. > WO N æ 


Image 4 . Code - sample _included_ file.jsp (w/ errors) 


<%-- sample included file.jsp --%> 
<hr> 
<h2>Hello from included file: sample included file.jsp</h2> 
<$% 
System.out.printin( "Printed from Java..." ); 
Date date = new Date (); 
$> 
<h2>Hello! Time from an included file: <$= date $></h2> 
<hr> 


Table 4.514 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


10| 


He 
He 


Kat le ne ea A E et 


H 
1 


H 
= 


H e 
N e 


He 
oO 


e e 
N e 


cele dh Ca A S d kant 


pat Med e eS AL) LaS Liss 


2241 


<!DOCTYPE html> 
<head><title></title></head> 
<%-- sample included file.jsp --%> 
<%@ page import="java.util.*" %> 
<hr> 
<h2>Hello from included file: sample included file.jsp</h2> 
<$% 
System.out.printin( "Printed from Java..." ); 
Date date = new Date(); 
> 
<h2>Hello! Time from an included file: <%= date %></h2> 
<hr> 


<!DOCTYPE html> 
<head><title></title></head> 
<%-- sample included file.jsp --%> 
<%@ page import="java.util.*" %> 
<hr> 
<h2>Hello from included file: sample included file.jsp</h2> 
<$% 
System.out.printin( "Printed from Java..." ); 
Date date = new Date(); 
$> 
<h2>Hello! Time from an included file: <%= date $></h2> 
<hr> 


<!DOCTYPE html> 
<head><title></title></head> 
<%-- sample included file.jsp --%> 
<%@ page import="java.util.*" %> 
<hr> 
<h2>Hello from included file: sample included file.jsp</h2> 
<$% 
System.out.printin( "Printed from Java..." ); 
Date date = new Date(); 
> 
<h2>Hello! Time from an included file: <%= date %></h2> 
<hr> 
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Image 5 . Code - sample_ included _file.jsp 
| 4] <!DOCTYPE html> 
<head><title></title></head> 
<%-- sample included file.jsp --%> 
<%@ page import="java.util.*" %> 
<hr> 


<$ 
System.out.printin( "Printed from Java..." ); 
Date date = new Date(); 


oor nw & WwW NY 
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<hr> 


<h2>Hello from included file: sample included file.jsp</h2> 


<h2>Hello! Time from an included file: <%= date %></h2> 


Table 4.515 


IP 0:0:0:0:0:0:0:1, Time Tue Nov 0S 16:43:21 CST 
Printed from Java... 


IP 0:0:0:0:0:0:0:1, Time Tue Nov 0S 16:43:21 CST 
Printed from Java... 


IP 0:0:0:0:0:0:0:1, Time Tue Nov 0S 16:43:21 CST 
Printed from Java... 


2013 


2013 


2013 


Image 6 . Console Output - jsp_tags.jsp 
IP 0:0:0:0:0:0:0:1, Time Tue Nov 0S 16:43:21 CST 
Printed from Java... 


2013 


Table 4.516 
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<!DOCTYPE html> 
<!-- jsp_tags.jsp --> 


<!DOCTYPE html> 


<head><title></title></head> 


<hr> 
<h2>Hello from included file: sample included _file.jsp</h2> 


<h2>Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013</h2> 
<hr> 


<html> 
<head> 
<title>JSP Tags</title> 
</head> 
<body> 
<hi>JSP Tags</hi> 
<h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> 
<!-- HTML comment - compiled and executed but not displayed. --> 
<!-- <h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> --> 


<table border="i"> 


<tr> 

<td>Number & localVar</td> 
<td>1i</td> 

<td>0</td> 

</tr> 


<tr> 
<td>Number & localVar</td> 
<td>2</td> 

<td>1</td> 

</tr> 


<tr> 
<td>Number & localVar</td> 
<td>3</td> 

<td>2</td> 

</tr> 


</table> 


<p>This is globalCount: 0</p> 
<p>This is localVar 99</p> 


</body> 
</html> 
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<hr> 


<h2>Hello! 
| <hr> 


| <html> 
| <head> 
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|<h2>Hello from included file: sample_included_file.jsp</h2> 


Time from an included file: Sun Dec 08 13:22:08 CST 2013</h2> 


<title>JSP Tags</title> 


| </head> 
| <body> 


<hi>JSP Tags</hi> 


20 | <h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> 
21 | <!-- HTML comment - compiled and executed but not displayed. --> 
22 <!-- <h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> --> 
23 | 

24 | 

25 <table border="1"> 

26 | 

27 <tr> 

28 | <td>Number & localVar</td> 
23 <td>1</td> 

30 | <td>0</td> 

31 | </tr> 

32 | 

33 | curo 

34 | <td>Number & localVar</td> 
35 | <td>2</td> 

38 | <td>1</td> 

37 | </tr> 

23 | 

39 | <tr> 

40 | <td>Number & localVar</td> 
41 | <td>3</td> 

42 | <td>2</td> 

43 | </tr> 

44 | 

45 | </table> 

48 

47 | <p>This is globalCount: 0</p> 
48 | <p>This is localVar 99</p> 

43 | 

50| </body> 

§1| </html> 
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<!DOCTYPE html> 
<!-- jsp_tags.jsp --> 


<!DOCTYPE html> 


<head><title></title></head> 


<hr> 
<h2>Hello from included file: sample included _file.jsp</h2> 


<h2>Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013</h2> 
<hr> 


<html> 
<head> 
<title>JSP Tags</title> 
</head> 
<body> 
<hi>JSP Tags</hi> 
<h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> 
<!-- HTML comment - compiled and executed but not displayed. --> 
<!-- <h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> --> 


<table border="i"> 


<tr> 

<td>Number & localVar</td> 
<td>1i</td> 

<td>0</td> 

</tr> 


<tr> 
<td>Number & localVar</td> 
<td>2</td> 

<td>1</td> 

</tr> 


<tr> 
<td>Number & localVar</td> 
<td>3</td> 

<td>2</td> 

</tr> 


</table> 


<p>This is globalCount: 0</p> 
<p>This is localVar 99</p> 


</body> 
</html> 
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Image 7 . View Source - jsp_tags.jsp 
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<!-- jsp_tags.jsp --> 


<head><title></title></head> 


<hr> 
<h2>Hello from included file: sample_included_file.jsp</h2> 


<h2>Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013</h2> 
<hr> 


<html> 
<head> 
<title>JSP Tags</title> 
</head> 
<body> 
<hi>JSP Tags</hi> 
<h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> 
<!-- HTML comment - compiled and executed but not displayed. --> 
<!-- <h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> --> 


<table border="1"> 


<tr> 
<td>Number & localVar</td> 
<td>1i</td> 

<td>0</td> 

</tr> 


<tr> 
<td>Number & localVar</td> 
<td>2</td> 

<td>i</td> 

</tr> 


<tr> 

<td>Number & localVar</td> 
<td>3</td> 

<td>2</td> 

</tr> 


</table> 


<p>This is globalCount: 0</p> 
<p>This is localVar 99</p> 


</body> 
</html> 


Table 4.517 
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4.5.7.10 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4340: JSP Fundamentals 
e Author: Dr. R.L.Martinez 

e Maintainer: R.G.Baldwin 

e File: Java4340.htm 

e Published: 11/27/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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4.5.8 Java4340r: Review” 
4.5.8.1 Table of Contents 


e Preface (p. 2253) 
e Background information (p. 2253) 


Expression tag (p. 2253) 
Comment tag (p. 2254) 
Scriptlet tag (p. 2254) 
Declaration tag (p. 2254) 
Directive tag (p. 2254) 


e Questions (p. 2255) 


1 (p. 2255) , 2 (p. 2255) , 3 (p. 2255) , 4 (p. 2255) , 5 (p. 2255) , 6 (p. 2255) , 7 (p. 2256) , 8 
(p. 2256) , 9 (p. 2256) , 10 (p. 2256) , 11 (p. 2256) , 12 (p. 2256) , 13 (p. 2256) , 14 (p. 2257) 
, 15 (p. 2257) , 16 (p. 2257) , 17 (p. 2257) , 18 (p. 2257) , 19 (p. 2258) , 20 (p. 2258) , 21 (p. 
2258) , 22 (p. 2258) 


Image index (p. 2258) 
Answers (p. 2260) 
Images (p. 2269) 
Miscellaneous (p. 2286) 


4.5.8.2 Preface 


This module is one in a collection of modules on JavaServer Pages (JSP) designed for teaching ITSE2317 - 
Java Programming (Intermediate) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4340: JSP Funda- 
mentals 74° . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 

The Images (p. 2269) section contains a number of images that you may find helpful as reference material 


in answering the questions. 


4.5.8.3 Background information 


The module named Java4340: JSP Fundamentals 74° introduced your first JSP program. This module 
supplements the information in that module from a slightly different perspective. The main purpose of this 
module, however, is to provide a series of review questions and answers that you can use to solidify the 
information in your mind. 

There are five different kinds of JSP tags. They are shown in Image 1 (p. 2270) . Image 2 (p. 2274) 
shows some examples of those tags being used in a jsp file. 


4.5.8.3.1 Expression tag 


Line 11 of Image 2 (p. 2274) shows an expression tag. An expression tag is used to evaluate a Java 
expression and to insert the results of that evaluation into outgoing HTML code. 


244This content is available online at <http://cnx.org/content /m48187/1.6/>. 
45http://cnx.org/content /m48075 /latest /?collection=col11441/latest 
46 http://cnx.org/content /m48075 /latest /?collection=col11441/latest 
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For example, the JSP expression tag on Line 11 instantiates a new object of the Date class using a 
constructor that causes the new Date object to encapsulate the current date and time. A String version 
of the current date and time is inserted into the HTML output and displayed as shown immediately below 
the JSP Tags header in Image 3 (p. 2278) . 

(Inserting the new Date object’s reference into the expression tag causes the toString method 
of the Date class to be called, returning the String shown in Image 3 (p. 2278) .) 

Note that the Java source code inside a JSP expression tag is not terminated by a semicolon. In other 
words, it is a Java expression and is not a Java statement. 


4.5.8.3.2 Comment tag 


Lines 13 and 15 of Image 2 (p. 2274) also show expression tags. However, the first one is inside an HTML 
comment element and the second one is inside a JSP comment tag. Therefore, they are both ignored and 
have no effect on the output. 


4.5.8.3.3 Scriptlet tag 


The scriptlet tag is used to insert Java source code into HTML code where it will later be compiled and 
executed. 

(Note that code inserted into a scriptlet tag uses standard Java syntax including semicolons where 
required.) 

It is not necessary for a scriptlet to contain a complete block of Java source code. By a block , I 
mean none, one, or more statements surrounded by matching curly brackets. A block of Java source code 
can begin in one scriptlet tag and end in another scriptlet tag with HTML code inserted between the 
two. That is the case in Image 2 (p. 2274) . 

A scriptlet tag begins on Line 17 and ends on Line 25 of Image 2 (p. 2274) . The end of the scriptlet 
tag is in the middle of a for loop block. That means that the HTML code following the end of the 
scriptlet tag will be evaluated during each iteration of the for loop. 

The HTML code that begins on Line 26 and ends on Line 30 includes two JSP expression tags. During 
each iteration of the for loop, this HTML code creates and populates the three elements of a single row in 
a three-column HTML table that begins on Line 16 and ends on Line 35. 

One element is populated with literal HTML text. The other two elements are populated by evaluating 
two different JSP expression tags. The output table is shown in Image 3 (p. 2278) . 

The for loop that begins on Line 24 must have a terminating curly bracket in order to compile. The 
terminating curly bracket is provided by the scriptlet tag that begins on Line 31 and ends on Line 34. 
The code in that scriptlet also assigns a new value to the variable named local Var 


4.5.8.3.4 Declaration tag 


A declaration tag is used on Line 36 of Image 2 (p. 2274) to declare a variable of type int named 
globalCount and to initialize its value to 0. 

Variables declared in this manner are shared by all sessions accessing the servlet. Consequently, the 
declaration of variables in this manner should be used very sparingly if at all. (One browser session can 
modify such a variable in use by another browser session, which can lead to unexpected results. ) 

Expression tags are then used to display the values of globalCount and localVar 

Finally, a scriptlet tag is used to increment the value of globalCount 


4.5.8.3.5 Directive tag 


Two uses of the directive tag are shown near the top of Image 2 (p. 2274) . 

The first usage causes the code in the file named sample included _file.jsp ( Image 5 (p. 2281) 
) to be inserted at the location of the directive tag in Image 2 (p. 2274) . . The code in the scriptlet 
tag in Image 5 (p. 2281) and the code in the expression tag immediately following that scriptlet tag 
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produces the second line of output text near the top of Image 3 (p. 2278) . . The code in the scriptlet tag 
also causes the text " Printed from Java... " (without the quotation marks) to appear on the server 
system console as shown in Image 6 (p. 2281) . 

The second usage of the directive tag near the top of Image 2 (p. 2274) causes the java.util package 
and all of its classes to be imported. This is the JSP alternative to a standard Java import directive. Note 
that the package name being imported is surrounded by quotation marks and is not terminated with a 
semicolon. 


4.5.8.4 Questions 

4.5.8.4.1 Question 1 

There are three locations where processing can occur in web development. Where are they? 
Go to answer 1 (p. 2269) 

4.5.8.4.2 Question 2 

True or False? This course emphasizes C++ programs that run on the client machine. 
Go to answer 2 (p. 2268) 

4.5.8.4.3 Question 3 

True or False? JSP are simply HTML pages with Java code inserted into the page. 
Go to answer 3 (p. 2268) 

4.5.8.4.4 Question 4 


True or False? When the user accesses a JSP via a browser, the page is processed by compiling and running 
the Java code in the page. This often produces HTML formatted output. 
Go to answer 4 (p. 2268) 


4.5.8.4.5 Question 5 


True or False? Each time a JSP is accessed, the code is parsed and then compiled into a servlet (Java 
bytecode executable) . 
Go to answer 5 (p. 2268) 


4.5.8.4.6 Question 6 


True or False? JSP tags in an HTML page are delimited using angle brackets and percent characters as 
shown in Image 8 (p. 2255) . 


Image 8 . Question 6. 


<% h> 


Table 4.518 


Go to answer 6 (p. 2268) 
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4.5.8.4.7 Question 7 
True or False? The six kinds of JSP tags are: 


1. Scriptlet 
2. Expression 
3. Directive 
4. Comment 
5. Declaration 
6. Code 


Go to answer 7 (p. 2268) 


4.5.8.4.8 Question 8 
True or False? When Java code appears on JSP it is enclosed in tags. 
Go to answer 8 (p. 2268) 
4.5.8.4.9 Question 9 
Which kind of JSP tag is normally used to enclose ordinary Java source code? 
Go to answer 9 (p. 2268) 
4.5.8.4.10 Question 10 
NetBeans conveniently colors the scriptlet and expression sections with a special color for easy visual iden- 
tification. What is that color? 
Go to answer 10 (p. 2267) 
4.5.8.4.11 Question 11 


True or False? A scriptlet tag must contain a complete block of Java source code. (A block of Java source 
code is normally surrounded by matching curly brackets.) 

Go to answer 11 (p. 2262) 
4.5.8.4.12 Question 12 


True or False? The expression tag is used to compile and run Java code and convert the output into string 
expressions. 

Go to answer 12 (p. 2262) 
4.5.8.4.13 Question 13 


True or False? An expression tag begins and ends with the characters shown in Image 11 (p. 2256) . 


Image 11 . Question 13. 


continued on next page 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2252 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


<40 A> 


Table 4.519 


Go to answer 13 (p. 2262) 


4.5.8.4.14 Question 14 


True or False? Semi-colons are required in expression tags. 
Go to answer 14 (p. 2262) 


4.5.8.4.15 Question 15 


True or False? A directive tag begins and ends with the characters shown in Image 14 (p. 2257) . 


Image 14 . Question 15. 


<40 4> 


Table 4.520 


Go to answer 15 (p. 2261) 


4.5.8.4.16 Question 16 


True or False? The include version of the directive tag can be used to cause text from an external file 
to be inserted into the jsp file just as though you had typed it in. 
Go to answer 16 (p. 2261) 


4.5.8.4.17 Question 17 


True or False? The JSP syntax shown in Image 15 (p. 2257) can be used to import Java classes that apply 
to the entire page. 


Image 15 . Question 17. 


<%@ import="java.util.Date" %> 


Table 4.521 


Go to answer 17 (p. 2261) 


4.5.8.4.18 Question 18 


True or False? The JSP comment tag begins and ends as shown in Image 17 (p. 2257) . 
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Image 17 . Question 18. 


<%l-- --%> 


Table 4.522 


Go to answer 18 (p. 2261) 


4.5.8.4.19 Question 19 


True or False? The contents of the JSP comment tags are not compiled, executed, or sent back to the browser. 
On the other hand, regular HTML comments are compiled, executed, and sent back to the browser. However, 
that content is not displayed. 

Go to answer 19 (p. 2261) 


4.5.8.4.20 Question 20 


True or False? A JSP declaration tag begins and ends as shown in Image 19 (p. 2258) . 


Image 19 . Question 20. 


<h! 4> 


Table 4.523 


Go to answer 20 (p. 2261) 


4.5.8.4.21 Question 21 


True or False? A JSP declaration is used to declare variables and methods in a page’s scripting language. 
When the scripting language is the Java programming language, variables and methods in JSP declara- 
tions become declarations in the JSP page’s servlet class. 
Go to answer 21 (p. 2260) 


4.5.8.4.22 Question 22 


True or False? The code in Image 20 (p. 2258) is a valid JSP declaration for a variable named globalCount 


Image 20 . Question 22. 


<%! int globalCount="0;" %> 


Table 4.524 


Go to answer 22 (p. 2260) 
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4.5.8.5 Image index 


e Image 1 (p. 2270) . JSP Tags 

e Image 2 (p. 2274) . Code - jsp_tags.jsp 

e Image 3 (p. 2278) . Output - jsp_tags.jsp 

e Image 4 (p. 2279) . Code - sample_included_file.jsp (w/ errors) 
e Image 5 (p. 2281) . Code - sample_included _file.jsp 
e Image 6 (p. 2281) . Console Output - jsp_tags.jsp 
e Image 7 (p. 2285) . View Source - jsp_tags.jsp 

e Image 8 (p. 2255) . Question 6. 

e Image 9 (p. 2266) . A JSP for loop. 

e Image 10 (p. 2267) . JSP output. 

e Image 11 (p. 2256) . Question 13. 

e Image 12 (p. 2262) . Expression tag. 

e Image 13 (p. 2262) . Scripting-language expression. 
e Image 14 (p. 2257) . Question 15. 

e Image 15 (p. 2257) . Question 17. 

e Image 16 (p. 2261) . Importing a Java class. 

e Image 17 (p. 2257) . Question 18. 

e Image 18 (p. 2261) . A JSP comment tag. 

e Image 19 (p. 2258) . Question 20. 

e Image 20 (p. 2258) . Question 22. 

e Image 21 (p. 2260) . A JSP declaration. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None 


Display your name 
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This image was also inserted for the purpose of inserting space between the questions and the answers. 


ProbO05a.jpq zj o |x] 


Put your name here 


4.5.8.6 Answers 
4.5.8.6.1 Answer 22 


False. The correct syntax for the declaration of a variable named globalCount is shown in Image 21 (p. 
2260) . 


Image 21 . A JSP declaration. 


<f! int globalCount = 0; %> 


Table 4.525 


This question was included in this review to emphasize that unlike the directive tag, the declaration 
tag does not use HTML attribute syntax. Instead, it uses standard Java syntax at least for the declaration 
of variables. 

Go back to Question 22 (p. 2258) 


4.5.8.6.2 Answer 21 


True. 
Go back to Question 21 (p. 2258) 
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4.5.8.6.3 Answer 20 
True. 

Go back to Question 20 (p. 2258) 
4.5.8.6.4 Answer 19 
True. 

Go back to Question 19 (p. 2258) 
4.5.8.6.5 Answer 18 


False. The correct syntax for a JSP comment tag is shown in Image 18 (p. 2261) . 


Image 18 . A JSP comment tag. 


<h-- --h> 


Table 4.526 


Note that unlike an HTML comment tag, the code in Image 18 (p. 2261) doesn’t include an exclamation 
mark character. 

Go back to Question 18 (p. 2257) 
4.5.8.6.6 Answer 17 


False. The correct format of the directive tag for importing a class is shown in Image 16 (p. 2261) . 


Image 16 . Importing a Java class. 


<%@ page import="java.util.Date" %> 


Table 4.527 


Note the inclusion of the word page . Note also the use of the equal character and the quotation 
marks. While similar, this is not the format of an import directive in a Java source code file. Instead, it is 
the format of an attribute in XML or HTML. 

Go back to Question 17 (p. 2257) 
4.5.8.6.7 Answer 16 
True. 

Go back to Question 16 (p. 2257) 
4.5.8.6.8 Answer 15 
True. 

Go back to Question 15 (p. 2257) 
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4.5.8.6.9 Answer 14 


False. According to The Java EE 5 Tutorial 747 , 

A JSP expression is used to insert the value of a scripting language expression, converted into a 
string, into the data stream returned to the client. When the scripting language is the Java programming 
language, (as is the case here) an expression is transformed into a statement that converts the value of the 
expression into a String object and inserts it into the implicit out object. 

The syntax for an expression is shown in Image 13 (p. 2262) . 


Image 13 . Scripting-language expression. 


<%= scripting-language-expression %> 


Table 4.528 


Note that a semicolon is not allowed within a JSP expression, even if the same expression has a semicolon 
when you use it within a scriptlet. 

Go back to Question 14 (p. 2257) 
4.5.8.6.10 Answer 13 


False.. An expression tag begins and ends with the characters shown in Image 12 (p. 2262) . 


Image 12 . Expression tag. 


<h= 4> 


Table 4.529 


Go back to Question 13 (p. 2256) 


4.5.8.6.11 Answer 12 


True. 
Go back to Question 12 (p. 2256) 


4.5.8.6.12 Answer 11 


False. A scriptlet tag can contain a fragment of Java code. For example, in Image 9 (p. 2266) , one scriptlet 
tag begins on Line 17 and ends on Line 24. This tag contains the beginning of a for loop, but does not 
contain a complete block of Java code. Another scriptlet tag appears on Line 27. (Note that the green 
background is missing from this tag. That is because the cursor was on Line 27 when the screen shot was 
taken.) Another scriptlet tag extends from Line 29 through Line 31. This tag contains the closing curly 
bracket for the for loop. This example shows a common method of interspersing scriptlet code with HTML 
code using fragments of Java code in scriptlet tags. 


47http://docs.oracle.com/javaee/5/tutorial/doc/bnaov-html 
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16 <table border="i"> 

17 <$ 

18 // This is a comment 
19 /* 

20 This is a comment 
21 x7 

22 int n = 3; 

23 for ( int i = 0; i < n; i++) { 
24 > 

25 <tr> 

26 <td>Number</td> 
27 <td><t= i+1 $ 

28 </tr> 

29 <$ 

30 } 

31 $> 


32 </table> 
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16 
17 
16 
19 
20 
21 
22 


23 
24 
25 


26 


27. 
28 


29 


30 


31 
32 


<table border="1"> 


<$ 
// This is a comment 
/ ~ 
This is a comment 
x7 
int z = 35 
for (int. =207 -€ n; i++ K 
$> 
<tr> 
<td>Number</td> 
$= i+i $ 
</tr> 
<$ 
} 
$> 


</table> 
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16 <table border="i"> 

17 <$ 

18 // This is a comment 
19 /* 

20 This is a comment 
21 x7 

22 int n = 3; 

23 for ( int i = 0; i < n; i++) { 
24 > 

25 <tr> 

26 <td>Number</td> 
27 <td><t= i+1 $ 

28 </tr> 

29 <$ 

30 } 

31 $> 


32 </table> 
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| Image 9 . A JSP for loop. | 
16 <table border="i"> 

17 <$ 

18 // This is a comment 

19 /* 

20 This is a comment 

21 x7 

22 int g = 3; 

23 for ( int i = 0; i <n; i++) { 
24 => 

25 <tr> 

26 <td>Number</td> 

27 <td><$= i+1 $% 

28 </tr> 

29 <$ 

30 } 

31 $> 

32 </table> 

Table 4.530 


This for loop shown in Image 9 (p. 2266) along with the associated HTML tags produces the table 
shown in an excerpt from the HTML output page in Image 10 (p. 2267) . 
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= 


Image 10 . JSP output. 


= 


Table 4.531 


Go back to Question 11 (p. 2256) 


4.5.8.6.13 Answer 10 


NetBeans conveniently colors the scriptlet and expression sections green for easy visual identification. 
Go back to Question 10 (p. 2256) 
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4.5.8.6.14 Answer 9 


The scriptlet tag is normally used to enclose ordinary Java source code on JSP but a declaration tag can be 
used as well. 
Go back to Question 9 (p. 2256) 


4.5.8.6.15 Answer 8 
True. 
Go back to Question 8 (p. 2256) 


4.5.8.6.16 Answer 7 


False. The following are valid JSP tags: 


Scriptlet 
Expression 
Directive 
Comment, 
Declaration 


ee ER ER ee 


Item 6 (p. 2256) in the list, Code, is not a valid JSP tag. 
Go back to Question 7 (p. 2256) 
4.5.8.6.17 Answer 6 
True. 
Go back to Question 6 (p. 2255) 
4.5.8.6.18 Answer 5 
False. The first time a JSP is accessed, the code is parsed and then compiled into a servlet (Java bytecode 
executable) . Subsequent visits to the page use the compiled executable to produce output. This is more 
efficient that some other approaches that require more overhead each time a server-side program is accessed. 
Go back to Question 5 (p. 2255) 
4.5.8.6.19 Answer 4 
True. 
Go back to Question 4 (p. 2255) 
4.5.8.6.20 Answer 3 
True. 
Go back to Question 3 (p. 2255) 
4.5.8.6.21 Answer 2 


False. This course emphasizes Java programs that run on the web server. 
Go back to Question 2 (p. 2255) 
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4.5.8.6.22 Answer 1 


The three locations are 


1. the client machine 
2. the web server, and 
3. other servers. 


Go back to Question 1 (p. 2255) 


4.5.8.7 Images 


This section contains images that may be referred to by more than one question or answer. These images 
may also be helpful as reference material for answering the questions. Many of them were copied directly 
from Java4340: JSP Fundamentals 748 . Other images may be interspersed within the questions and answers. 


Purpose 
<%= %> Display string value 


JSP Tag | JSP Name 
Scriptlet Insert Java statements 
Display string value 


<*%H@ %> Set whole page conditions 
Not returned to browser 
<%! %> Declare instance variables or methods 


<%= %> 
<%!__%> 


48 http://cnx.org/content /m48075 /latest /?collection=col11441/latest 
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Image 1 . JSP Tags 


<%@ %> 
<%!__%> 


Table 4.532 
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<!DOCTYPE html> 


<!-- jsp_tags.j 


sp --> 


J 


<%@ include file="sample_included file.jsp" %> 
<%@ page import="Jjava.util.*" $> 


<html> 
<head> 


<title>JSP Tags</title> 


</head> 
<body> 


<hi>JSP Tags</hi> 


<h2>Hello! The time is now <%= new Date() %></h2> 

<!-- HTML comment - compiled and executed but not displayed. --> 

<!-- <h2>Hello! The time is now <%= new Date() %></h2> --> 

<%-- JSP comment - not compiled, executed, or returned to browser. --%> 


<%-- <h2>Hello! The time is now <%= new Date() %*></h2> --%> 
<table border="i"> 


<$ 


// This is a comment 


/* 


This is a comment 


«f/f 


int localVar= 0; 


int n = 3; 


for ( int i = 02: 2 <n: itF } £ 


$> 
<tr> 


<td>Number & localVar</td> 
<td><%= i+1 %></td> 
<td><%= localVar++ ></td> 


</tr> 


<$% 
} 


localVar = 99; 


$> 
</table> 


<%! int globalCount = 0; %> 

<p>This is globalCount: <%= globalCount %></p> 
<p>This is localVar <%= localVar %></p> 

<$% ++globalCount; $> 


</body> 
</html> 
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<!DOCTYPE html> 
<!-- jsp_tags.jsp --> 
<%@ include file="sample_included file.jsp" %> 
<%@ page import="Jjava.util.*" $> 
<html> 
<head> 
<title>JSP Tags</title> 
</head> 
<body> 
<hi>JSP Tags</hi> 
<h2>Hello! The time is now <%= new Date() %></h2> 
<!-- HTML comment - compiled and executed but not displayed. --> 
<!-- <h2>Hello! The time is now <%= new Date() %></h2> --> 


<%-- JSP comment - not compiled, executed, or returned to browser. 


<%-- <h2>Hello! The time is now <%= new Date() %></h2> --%> 
<table border="i"> 


<$ 
// This is a comment 
/* 

This is a comment 
w/ 


int localVar= 0; 
int n = 3; 
for ( ine I= (ip ab cg py eh A 
$> 
<tr> 
<td>Number & localVar</td> 
<td><$= i+1 $></td> 
<td><$= localVar++ %></td> 
</tr> 
<$ 
} 
localVar = 99; 
$> 
</table> 
<%! int globalCount = 0; %> 
<p>This is globalCount: <%= globalCount %></p> 
<p>This is localVar <%= localVar %></p> 
<% ++globalCount; $> 
</body> 
</html> 
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<!DOCTYPE html> 


<!-- jsp_tags.j 


sp --> 


J 


<%@ include file="sample_included file.jsp" %> 
<%@ page import="Jjava.util.*" $> 


<html> 
<head> 


<title>JSP Tags</title> 


</head> 
<body> 


<hi>JSP Tags</hi> 


<h2>Hello! The time is now <%= new Date() %></h2> 

<!-- HTML comment - compiled and executed but not displayed. --> 

<!-- <h2>Hello! The time is now <%= new Date() %></h2> --> 

<%-- JSP comment - not compiled, executed, or returned to browser. --%> 


<%-- <h2>Hello! The time is now <%= new Date() %*></h2> --%> 
<table border="i"> 


<$ 


// This is a comment 


/* 


This is a comment 


«f/f 


int localVar= 0; 


int n = 3; 


for ( int i = 02: 2 <n: itF } £ 


$> 
<tr> 


<td>Number & localVar</td> 
<td><%= i+1 %></td> 
<td><%= localVar++ ></td> 


</tr> 


<$% 
} 


localVar = 99; 


$> 
</table> 


<%! int globalCount = 0; %> 

<p>This is globalCount: <%= globalCount %></p> 
<p>This is localVar <%= localVar %></p> 

<$% ++globalCount; $> 


</body> 
</html> 
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Image 2 . Code - jsp_tags.jsp 
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<!DOCTYPE html> 


Zine sen t 
p 


acs.isp --> 


<%@ include file="sample included file.jsp" %> 
<%@ page import="Java.util.*" $> 
<html> 
<head> 
<title>JSP Tags</title> 
</head> 
<body> 
<hi>JSP Tags</hi> 
<h2>Hello! The time is now <%= new Date() %></h2> 


gine. HWTMT 


comment - 


he 


<%-- JSP comment - not compiled, executed, or returned to browser. 


<%-- <h2>Hello! The time is now <%= new Date() *></h2> --%> 
<table border="i"> 
<$% 


This is a comment 


int localVar= 0; 
int n = 3; 
Tor C ine im ft eD ele pt 
$> 
<txz> 
<td>Number & localVar</td> 
<td><%= i+1 %></td> 
<td><%= localVar++ %></td> 
</tr> 
<$% 
} 
localVar = 99; 
=> 
</table> 
<%! int globalCount = 0; %> 
<p>This is globalCount: <%= globaliCount %></p> 
<p>This is localVar <%= locaiVar %></p> 
<$% ++globalCount; $> 
</body> 
</html> 


--%> 
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Hello from included file: sample_included_file.jsp 


Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013 


JSP Tags Chrome 


Hello! The time is now Sun Dec 08 13:22:08 CST 2013 
Numi mber & localVar |1 [O] @ [E] hitp://locathost:2080/it: O ~ © |) A localhost 


{Number & tocalVar [2 (11 
SET: Hello from included file: sample_included_file.jsp IE 
Saara Hello! Time fi included file: Sun Dec 08 13:22:15 CST 2013 
ello! Time from an included file: Sun Dec 2:22:15 
This is localVar 99 
JSP Tags 
Hello! The time is now Sun Dec 08 13:22:15 CST 2013 
Se 
[Number & localVar][1](0] | FR) http.//tocainost:8060..317-jsp/isp_tagsisp| + | = ee 
[Number & localVas]2|[I]} |g. jocatnost 2000/2021? jp jp. tes e |E- Googie PD- b A 
[Number & localVae)2) | 


ThisisalobalCount:1 Hello from included file: sample_included_file.jsp Firefox 


This is localVar 99 
| Hello! Time from an included file: Sun Dec 08 13:22:19 CST 2013 


JSP Tags 


| Hello! The time is now Sun Dec 08 13:22:19 CST 2013 


Number & localVar|1 [0 
Number & localVar |2 |1 
Number & localVar [3 [2 
“his is globalCount: 2 


2 


b 
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Hello from included file: sample_included_file.jsp 


Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013 


JSP Tags Chrome 


Hello! The time is now Sun Dec 08 13:22:08 CST 2013 


[Number & localVar [1f] (<) [E] hitp://locathost:2080/it: O ~ © |) [E] localhost 
[Number & localVar [21| 


Plantes & oea Hello from included file: sample_included_file.jsp IE 
COENEN Hello! Time fi included file: Sun Dec 08 13:22:15 CST 2013 
ello! Time from an included file: Sun Dec 222: 
This is localVar 99 
JSP Tags 
Hello! The time is now Sun Dec 08 13:22:15 CST 2013 
JE 
[ember & locata] [E] tp/nocho sn. 217fe oi E] 
[Number & tocatVar |in] € @ localhost 8030/itse2317-jsp/jsp_təgsjsp C |B- Googie P n- + t 
umber & localVa = 


Hello from included file: sample_included_file.jsp Firefox 


Hello! Time from an included file: Sun Dec 08 13:22:19 CST 2013 


JSP Tags 
Hello! The time is now Sun Dec 08 13:22:19 CST 2013 
Number & local Var |1 


Number & local Var [2 
Number & localVar|3 


P=] S] 
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Hello from included file: sample_included_file.jsp 


Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013 


JSP Tags Chrome 


Hello! The time is now Sun Dec 08 13:22:08 CST 2013 
Numi mber & localVar |1 [O] @ [E] hitp://locathost:2080/it: O ~ © |) A localhost 


{Number & tocalVar [2 (11 
SET: Hello from included file: sample_included_file.jsp IE 
Saara Hello! Time fi included file: Sun Dec 08 13:22:15 CST 2013 
ello! Time from an included file: Sun Dec 2:22:15 
This is localVar 99 
JSP Tags 
Hello! The time is now Sun Dec 08 13:22:15 CST 2013 
Se 
[Number & localVar][1](0] | FR) http.//tocainost:8060..317-jsp/isp_tagsisp| + | = ee 
[Number & localVas]2|[I]} |g. jocatnost 2000/2021? jp jp. tes e |E- Googie PD- b A 
[Number & localVae)2) | 


ThisisalobalCount:1 Hello from included file: sample_included_file.jsp Firefox 


This is localVar 99 
| Hello! Time from an included file: Sun Dec 08 13:22:19 CST 2013 


JSP Tags 


| Hello! The time is now Sun Dec 08 13:22:19 CST 2013 


Number & localVar|1 [0 
Number & localVar |2 |1 
Number & localVar [3 [2 
“his is globalCount: 2 


2 


b 
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Image 3 . Output - jsp_tags.jsp 


Hello from included file: sample_included_file.jsp 


Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013 


JSP Tags Chrome, 


Hello! The time is now Sun Dec 08 13:22:08 CST 2013 


[Number & localVar[i]0) 


(<) [E] http:/localhost8080/it O ~ © E] localhost 
= & localV: re 


Hello from included file: sample_included_file.jsp IE 
Hello! Time from an included file: Sun Dec 08 13:22:15 CST 2013 


JSP Tags 
Hello! The time is now Sun Dec 08 13:22:15 CST 2013 
( Firefox = 


[Nomber& roaie 
[Number & local Varl 2|1] 
[Number & local Var]|3|(2) 


| E] http://localhost:8080...317-jsp/jsp_tagsjsp + 
¢ © localhost itse2317-jsp/jsp_tags.jsp c B- oogie 


PD- + ff 


ThisisglobalCowt l | Hello from included file: sample_included_file.jsp Firefox 


Hello! Time from an included file: Sun Dec 08 13:22:19 CST 2013 


JSP Tags 


Hello! The time is now Sun Dec 08 13:22:19 CST 2013 


Number & localVar |1 
Number & localVar |2 
Number & local Var [3 


Riis) 


This is globalCount: 2 
This is localVar 99 


Table 4.534 


<%-- sample included file.jsp --%> 
<hr> 


<$% 


Date date = new Date(); 
$> 


worgpnun se wo no 


<hr> 
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System.out.printin( "Printed from Java..." ); 


<h2>Hello from included file: sample included file.jsp</h2> 


<h2>Hello! Time from an included file: <%= date %></h2> 
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<%-- sample included file.jsp --%> 
<hr> 
<h2>Hello from included file: sample included file.jsp</h2> 
<% 
System.out.printin( "Printed from Java..." ); 
Date date = new Date (); 
$> 
<h2>Hello! Time from an included file: <$= date $></h2> 
<hr> 


<%-- sample included file.jsp --%> 
<hr> 
<h2>Hello from included file: sample included file.jsp</h2> 
<$% 
System. out.printin( "Printed from Java..." ); 
Date date = new Date (); 
$> 
<h2>Hello! Time from an included file: <%= date %></h2> 
<hr> 


© œ Ip. > WO N æ 


Image 4 . Code - sample _included_ file.jsp (w/ errors) 


<%-- sample included file.jsp --%> 
<hr> 
<h2>Hello from included file: sample included file.jsp</h2> 
<$% 
System.out.printin( "Printed from Java..." ); 
Date date = new Date (); 
$> 
<h2>Hello! Time from an included file: <$= date %></h2> 
<hr> 


Table 4.535 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


10| 


He 
He 


Kat le ne ea A E et 


H 
1 


H 
= 


H e 
N e 


He 
oO 


e e 
N e 


cele dh Ca A S d kant 


pat Med e eS AL) LaS Liss 


2275 


<!DOCTYPE html> 
<head><title></title></head> 
<%-- sample included file.jsp --%> 
<%@ page import="java.util.*" %> 
<hr> 
<h2>Hello from included file: sample included file.jsp</h2> 
<$% 
System.out.printin( "Printed from Java..." ); 
Date date = new Date(); 
> 
<h2>Hello! Time from an included file: <%= date %></h2> 
<hr> 


<!DOCTYPE html> 
<head><title></title></head> 
<%-- sample included file.jsp --%> 
<%@ page import="java.util.*" %> 
<hr> 
<h2>Hello from included file: sample included file.jsp</h2> 
<$% 
System.out.printin( "Printed from Java..." ); 
Date date = new Date(); 
$> 
<h2>Hello! Time from an included file: <%= date $></h2> 
<hr> 


<!DOCTYPE html> 
<head><title></title></head> 
<%-- sample included file.jsp --%> 
<%@ page import="java.util.*" %> 
<hr> 
<h2>Hello from included file: sample included file.jsp</h2> 
<$% 
System.out.printin( "Printed from Java..." ); 
Date date = new Date(); 
> 
<h2>Hello! Time from an included file: <%= date %></h2> 
<hr> 
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Image 5 . Code - sample_ included _file.jsp 
| 4] <!DOCTYPE html> 
<head><title></title></head> 
<%-- sample included file.jsp --%> 
<%@ page import="java.util.*" %> 
<hr> 


<$ 
System.out.printin( "Printed from Java..." ); 
Date date = new Date(); 


oor nw & WwW NY 


He 
Oo 


> 


e e 
N e 


<hr> 


<h2>Hello from included file: sample included file.jsp</h2> 


<h2>Hello! Time from an included file: <%= date %></h2> 


Table 4.536 


IP 0:0:0:0:0:0:0:1, Time Tue Nov 0S 16:43:21 CST 
Printed from Java... 


IP 0:0:0:0:0:0:0:1, Time Tue Nov 0S 16:43:21 CST 
Printed from Java... 


IP 0:0:0:0:0:0:0:1, Time Tue Nov 0S 16:43:21 CST 
Printed from Java... 


2013 


2013 


2013 


Image 6 . Console Output - jsp_tags.jsp 
IP 0:0:0:0:0:0:0:1, Time Tue Nov 0S 16:43:21 CST 
Printed from Java... 


2013 


Table 4.537 
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<!DOCTYPE html> 
<!-- jsp_tags.jsp --> 


<!DOCTYPE html> 


<head><title></title></head> 


<hr> 
<h2>Hello from included file: sample included _file.jsp</h2> 


<h2>Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013</h2> 
<hr> 


<html> 
<head> 
<title>JSP Tags</title> 
</head> 
<body> 
<hi>JSP Tags</hi> 
<h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> 
<!-- HTML comment - compiled and executed but not displayed. --> 
<!-- <h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> --> 


<table border="i"> 


<tr> 

<td>Number & localVar</td> 
<td>1i</td> 

<td>0</td> 

</tr> 


<tr> 
<td>Number & localVar</td> 
<td>2</td> 

<td>1</td> 

</tr> 


<tr> 
<td>Number & localVar</td> 
<td>3</td> 

<td>2</td> 

</tr> 


</table> 


<p>This is globalCount: 0</p> 
<p>This is localVar 99</p> 


</body> 
</html> 
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<hr> 


<h2>Hello! 
| <hr> 


| <html> 
| <head> 
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|<h2>Hello from included file: sample_included_file.jsp</h2> 


Time from an included file: Sun Dec 08 13:22:08 CST 2013</h2> 


<title>JSP Tags</title> 


| </head> 
| <body> 


<hi>JSP Tags</hi> 


20 | <h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> 
21 | <!-- HTML comment - compiled and executed but not displayed. --> 
22 <!-- <h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> --> 
23 | 

24 | 

25 <table border="1"> 

26 | 

27 <tr> 

28 | <td>Number & localVar</td> 
23 <td>1</td> 

30 | <td>0</td> 

31 | </tr> 

32 | 

33 | curo 

34 | <td>Number & localVar</td> 
35 | <td>2</td> 

38 | <td>1</td> 

37 | </tr> 

23 | 

39 | <tr> 

40 | <td>Number & localVar</td> 
41 | <td>3</td> 

42 | <td>2</td> 

43 | </tr> 

44 | 

45 | </table> 

48 

47 | <p>This is globalCount: 0</p> 
48 | <p>This is localVar 99</p> 

43 | 

50| </body> 

§1| </html> 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


eee ee ee ee ee oMa 
Oon Omer WN = O 


Z=SBBSBREREBKRESRBBNBRRBKRRB 


ò 


2888 38 FES 


Oon @On & WN = 


2279 


<!DOCTYPE html> 
<!-- jsp_tags.jsp --> 


<!DOCTYPE html> 


<head><title></title></head> 


<hr> 
<h2>Hello from included file: sample included _file.jsp</h2> 


<h2>Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013</h2> 
<hr> 


<html> 
<head> 
<title>JSP Tags</title> 
</head> 
<body> 
<hi>JSP Tags</hi> 
<h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> 
<!-- HTML comment - compiled and executed but not displayed. --> 
<!-- <h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> --> 


<table border="i"> 


<tr> 

<td>Number & localVar</td> 
<td>1i</td> 

<td>0</td> 

</tr> 


<tr> 
<td>Number & localVar</td> 
<td>2</td> 

<td>1</td> 

</tr> 


<tr> 
<td>Number & localVar</td> 
<td>3</td> 

<td>2</td> 

</tr> 


</table> 


<p>This is globalCount: 0</p> 
<p>This is localVar 99</p> 


</body> 
</html> 
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Image 7 . View Source - jsp_tags.jsp 
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<!-- jsp_tags.jsp --> 


<head><title></title></head> 


<hr> 
<h2>Hello from included file: sample_included_file.jsp</h2> 


<h2>Hello! Time from an included file: Sun Dec 08 13:22:08 CST 2013</h2> 
<hr> 


<html> 
<head> 
<title>JSP Tags</title> 
</head> 
<body> 
<hi>JSP Tags</hi> 
<h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> 
<!-- HTML comment - compiled and executed but not displayed. --> 
<!-- <h2>Hello! The time is now Sun Dec 08 13:22:08 CST 2013</h2> --> 


<table border="1"> 


<tr> 
<td>Number & localVar</td> 
<td>1i</td> 

<td>0</td> 

</tr> 


<tr> 
<td>Number & localVar</td> 
<td>2</td> 

<td>i</td> 

</tr> 


<tr> 

<td>Number & localVar</td> 
<td>3</td> 

<td>2</td> 

</tr> 


</table> 


<p>This is globalCount: 0</p> 
<p>This is localVar 99</p> 


</body> 
</html> 


Table 4.538 
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4.5.8.8 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4340r: Review 
e File: Java4340r.htm 

e Published: 12/05/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 

I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 

In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


4.5.9 Java4350: Form Processing with JSP” 
4.5.9.1 Table of Contents 
e Preface (p. 2286) 
Viewing tip (p. 2287) 
x Images (p. 2287) 
Preview (p. 2287) 
General background information (p. 2287) 
Discussion (p. 2287) 
Homework assignment (p. 2290) 
Summary (p. 2291) 
What’s next? (p. 2291) 


Images (p. 2292) 
Miscellaneous (p. 2322) 


4.5.9.2 Preface 


This module is one in a collection of modules designed for teaching ITSE 2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

Thus far, we have covered the web programming model, HTML and CSS fundamentals, and an introduc- 
tion to JSP via the JSP tags. Now we are ready to put our knowledge into practice by implementing useful 
examples of JSP technology. 


249This content is available online at <http://cnx.org/content/m48085/1.5/>. 
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4.5.9.2.1 Viewing tip 


I recommend that students open another copy of this module in a separate browser window and use the 
following links to easily find and view the Images while you are reading about them. 


4.5.9.2.1.1 Images 


e Image 1 (p. 2295) . Sample Form - Amazon.com 

e Image 2 (p. 2296) . Form Element of Amazon.com 

e Image 3 (p. 2296) . Browser Support for novalidate Attribute 
e Image 4 (p. 2297) . Common HTML Form Elements 

e Image 5 (p. 2302) . Code - join_acc_code_academy.html 

e Image 6 (p. 2306) . Output - join_acc_code_academy.html 
e Image 7 (p. 2313) . Code - display_new_member.jsp 

e Image 8 (p. 2321) . Output - display_new_member.jsp 

e Image 9 (p. 2322) . Code - Incorrect Advisory.html 


4.5.9.3 Preview 


In this module we begin working with HTML forms. The capabilities enabled by HTML forms are at the 
core of the tremendous benefits the web represents. When elements are added to HTML forms, the browser 
can retrieve information from users and send that data to the web server. JSP running on the server can 
then process the data and potentially modify the user experience based on user input. A common operation 
performed with user data is reading and/or writing to a database which is not addressed in this course. Web 
database access with Java is covered in ACC course INEW 2338. 


4.5.9.4 General background information 


Almost all websites employ forms. If the site owner would like to obtain information or feedback from 
users, then forms are required. Fortunately for web developers, much of the behind-the-scenes processing is 
performed by the browser. It is the responsibility of the developer to design the form and add form controls 
to capture user input. When submitted, the browser packages the data and selections supplied by the user 
and forwards that content to the receiving page on the server. Code on the receiving page then performs 
appropriate processing tasks with the data. The process of collecting, packaging, and processing form data 
will be discussed in this module. 


4.5.9.5 Discussion 


In the early days of the World Wide Web, developers desired to move beyond the simple and static display 
of information into a new realm filled with interactivity. Obtaining data from site visitors was an obvious 
early goal. 

In November 1995, the HTML 2.0 specification was published which was the first to include the form 
element and the HTML elements that are used within the form to capture visitor data. In HTML5, the 
number of form elements expanded. The additions were originally known as Web Forms 2.0 but that moniker 
was dropped when the new form elements were simply included in the broader HTMLS5 specification. 


4.5.9.5.1 HTML Forms 


Forms are a powerful and essential tool for every web developer. Many web pages and almost all web sites 
use the form element. Developers are not limited to having one form per page but that is often the case. 
Look at Image 1 (p. 2295) for an example of a familiar form. The Amazon form shown contains 5 form 
elements (at least 5 are displayed). Two textboxes (input element with attribute of type and value=text) 
are used to obtain the email address and password from the user. Two radio buttons are used to determine 
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customer status. Note that only one of the radio buttons can be selected at atime. That behavior is known 
as mutually exclusive. They are referred to a radio buttons because only one radio station could be selected 
at a time (only one button pushed). Also notice that the "Yes" response has been preselected. That is 
known as the default. It is common to preselect a radio button from the group although that is not required. 

The last form control on the page is the "Sign in" button. It is a special type of control known as a 
submit button which engages the process to collect form data and send it to the destination specified by the 
action attribute of the form element. In the Amazon case, the action attribute specifies the default page in 
the signin directory as the destination. In Image 2 (p. 2296) , the actual form opening tag is depicted for 
the Amazon form shown in Image 1 (p. 2295) . The tag was captured using View Source of the Image 1 (p. 
2295) page. 

In Image 2 (p. 2296) , the name of the form is set to signIn. In HTML5 the name attribute is not 
supported for anchor (a) and image (img) elements but is used with forms. In XHTML, the name attribute 
is deprecated (use discouraged) for the following elements: a, applet, form, frame, iframe, img, and map . 
However, in HTMLS, name is a valid attribute for forms and is commonly used, if only for semantic value. 

The next attribute is method. There are 2 possible values for the method attribute, GET and POST. 
The value listed in Image 2 (p. 2296) is POST. This means that when data is sent to the destination as 
specified by the action attribute, it is sent as a post transaction which the user does not see. With GET, 
the names and values of the form controls are collected and appended to the URL string. More on GET and 
POST later. 

The next attribute listed in the form element is id. Unlike the name attribute, id attributes are designed 
and required to be unique. This enables developers to apply CSS and/or run JavaScript only with that 
element defined by a specific id. The novalidate attribute is new to HTML5. When set to novalidate, form 
input data is not validated when submitted. That attribute is not supported by some browsers. See Image 
3 (p. 2296) for a list of the browser versions which support novalidate. 

The last attribute listed is action. As previously mentioned, the action attribute specifies the destination 
to which the form data will be sent when the submit button is pressed. In the case of Image 2 (p. 2296) 
, when the user presses submit, the data on the form will be collected and sent to the default page of the 
signin directory. The destination page will process the data according to site protocols. In this case, the 
email address and password will be used to authenticate or deny sign-in to the user. 


4.5.9.5.2 HMTL Form Elements 


There are a number of elements used on forms to collect data from users. These elements are also known as 
controls and objects. Like other elements on an HTML page, form elements contain attributes and values 
for those attributes. Image 4 (p. 2297) lists some of the more popular and useful elements used on forms. 

With the button element, text or images can be used inside the button as the button’s innerHTML 
property. This characteristic distinguishes it from buttons created using the input element with type button 
which is an empty (void) tag. Recall from the HTML and CSS Fundamentals module that void elements 
do not contain the innerHTML property. W3Schools.com advises using the input element to create buttons 
within forms since some browsers submit content between the tags of button elements (the innerHTML) 
instead of the value attribute. 

The datalist element provides a means to pre-populate a box with values that will be accessed as the 
user begins typing in the box. The textarea is a control type that enables users to enter paragraphs of text 
instead of single lines like a textbox. The other elements will be covered in code examples below. 


4.5.9.5.3 Code join acc _code_academy.html 


The code example in Image 5 (p. 2302) produces the web page displayed in Image 6 (p. 2306) . Notice that 
line 6 of Image 5 (p. 2302) references an external CSS file like used in previous examples. When reviewing 
this and all subsequent code examples, items and topics that have been covered in previous modules will not 
be addressed again except to reinforce the more complex concepts. For instance, it is sufficient to remark 
that this file references a CSS file without explaining the purpose of CSS since that has been covered before. 
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Also, a considerable amount of Java knowledge is assumed since this is the 3rd part of a 3 part intermediate 
Java course. Therefore, only Java code that is unique to JSP will be covered. 

When interacting with forms, the user makes a number of submissions and/or selections with form 
controls. Each of the controls on the form have a name and a value attribute. And like all attributes, the 
name and value attributes are assigned values. The name for a control is usually designated at design time 
(i.e. when the developer writes the code for the page). The value attributes receive their values predominantly 
from user interaction. For example, textboxes have names and the values are entered by user submissions. 
When the submit button for a form is pressed, the browser collects all names and associated values for all 
controls within the form and sends that information to the destination determined by the action attribute of 
the form element. The names and values together are known as "name::value" pairs. The browser forwards 
the name::value pairs for the controls to the receiving page for processing. 

The first element of note for this module appears on line 12 of Image 5 (p. 2302) . This form element 
specifies 2 attributes, action and method. The action method provides the destination to which the server 
will send submitted form data. In this case, display _new_member.jsp is called to process the form data, 
the name::value pairs. When the post method is used it means that the data will not be visible to the user. 
GET, the default and the other type of method, appends form name::value pairs to the end of the destination 
URL in clear view. 

There is a rule of thumb that is often used to decide which method, GET or POST, to use with the 
form. If the data submitted is just used for presentation purposes then GET should be sufficient. However, 
if server processing like database access is planned, then POST is the better choice. Processes are known as 
idempotent if no change takes place. For idempotent access, GET is considered the preferred method. For 
extensive server processing like that typically used with JSP, it is more common to use POST and that is 
where we will concentrate our development. 

Lines 17, 21, and 25 contain input elements of type text. This means that those lines will produce text 
boxes which can be seen in the output of Image 6 (p. 2306) . Each of the textboxes have different names 
which are used to identify those controls. Again, when data is submitted (a.k.a sent to the destination 
specified by the action attribute), it is sent in the form of name::value pairs. In the example shown, the 
user entered the text "James" in the firstName textbox and therefore that will be the value associated with 
that textbox. So, when the submit button is pressed, the value James will be associated with the first Name 
textbox. The textboxes last Name=Gosling and phoneNumber=5125551234 are other name::value pairs that 
will be submitted. 

The next control on the form is shown on lines 29-33 of Image 5 (p. 2302) . This is known as a select 
control. Recall that controls are also elements and are also objects. The select elements represents the 
skillLevel dropdown list shown in Image 6 (p. 2306) . The individual selections in the dropdown list are 
determined by the option elements on lines 30-32 of Image 5 (p. 2302) . Notice that each of the options 
has a different value setting. However, the options share the name setting of the select control and only one 
name::value pair will be submitted for the selection control in this example. So, if "Expert" is selected then 
the name::value pair sent will be skillLevel=expert. Note that the value is sent and not the element content 
between the open and closing tags like Beginner, Intermediate, and Expert. 

The last control on the form is the input element with the special type="submit". Submit controls 
are used to invoke the data packaging and submission processes. As mentioned previously, the submission 
destination determined by the action on line 12 of Image 5 (p. 2302) processes the form contents. 


4,.5.9.5.4 Code display _new_member.jsp 


The code of display_new_member.jsp is shown in Image 7 (p. 2313) . This page is invoked (called) when 
the submit button is pressed on join _acc_code_academy.html. Notice that this page contains a few lines 
of JSP code (in green). Line 3 imports 2 packages required by the page. To see which packages are required 
by which components, simply remove the package and NetBeans will identify the unknown symbols. Try it. 

A JSP scriptlet tag on lines 10-16 of Image 7 (p. 2313) encloses Java code. Lines 12-15 acquire the 
values of 4 names (firstName, lastName, phoneNumber, and skillLevel) and assign those values to local 
String variables using the same identifiers (variable names). The name::value pairs were stored in the 
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Request content by the submission process performed by join_acc_code_academy.html. That is part of the 
packaging and submission process previously described. The getParameter method of the Request object is 
used to extract the values from the Request object. 

On lines 24, 28, 32, and 36 of Image 7 (p. 2313) , JSP expression tags are used to display the values 
of the controls obtained by getParameter above. The results of these lines can be seen in the Informa- 
tion Entered table in Image 8 (p. 2321) . There is a form element on lines 40-42 to return back to the 
join_acc_code_academy.html page. Data submission, the primary capability of the form element is not 
used in this case. It is only supplied as another brief example of a form. Usually, an anchor element would 
be better suited for this linking purpose. 


4.5.9.5.5 More About the Request Object 


The next 2 tables displayed in Image 8 (p. 2321) , Unsorted Parameters and Sorted Parameters, are shown 
to investigate another aspect of the Request object. In the first table, produced by lines 20-38 of Image 7 
(p. 2313) , the output of the table was explicitly defined using the expression tags. The order of the output 
could be completely reorganized by placing the variable skillLevel at the top, the variable firstName at the 
bottom, etc. When the name::value pairs are packaged in the Request object by the submission process, 
there is no guaranteed order of the entries. 

On lines 44-55 of Image 7 (p. 2313) , the second table is output. On line 47, the getParameterNames 
method returns an Enumeration of string objects consisting of the name portion of each of the name::value 
pairs stored in the Request object. An Enumeration is an interface which provides references to underlying 
object data. The two methods of the Enumeration interface, hasMoreElements and nextElement are used 
in the loop. hasMoreElements is used to test for the end of the references to the string objects (names) and 
nextElement is used to obtain the next name in the Enumeration. Note that the Enumeration interface does 
not provide a reset method and therefore getParameterNames is called again on line 60. 

A while loop is used on lines 48-53 to output the submission name::value pairs and this output is shown 
in the Unsorted Parameters table of Image 8 (p. 2321) . Notice on lines 47 and 60 the getParameterNames 
method of the Request object is called. As mentioned above, this method returns an Enumeration of the 
parameter names submitted by the form. An Enumeration also provides methods to iterate through its 
referenced content. If the developer would like to specify order and placement of specific name and value 
information, then a technique like that used in lines 20-38 of Image 7 (p. 2313) could be employed. 

An alternative approach to specific placement and unsorted display would be to sort the names or values 
prior to output. In the Sorted Parameters table of Image 8 (p. 2321) , the Enumeration returned by getPa- 
rameterNames is cast to a Collections.list type and assigned to a List variable on line 60 of Image 7 (p. 2313) 
. Like the Enumeration, the List interface provides iteration capabilities. Furthermore, since it implements 
the superinterfaces Collection and Iterable, it offers more functionality than the legacy Enumeration. While 
the Enumeration is not yet deprecated, its use is discouraged for new development. 

The list created on line 60 of Image 7 (p. 2313) is sorted on line 61 prior to being displayed on lines 
63-65. Note that the names are in alphabetical order. If line 61 were removed or commented, the output 
of the third table would be identical to that of the second unsorted table. To have more control over the 
order, control names could be assigned appropriate values like 01-firstName, 02-secondName, etc. on the 
form page. This would ensure values are arranged in a specified order. 

As an aside, notice the warning indicators on lines 45 and 58 of Image 7 (p. 2313) . The actual advisory 
which appears as a popup when hovering over the warning indicator is shown in Image 9 (p. 2322) . It is a 
bit tricky. It is states that columns for the th element are not recognized. Since the table is constructed 
primarily within the scriptlet section of lines 46-54 of Image 7 (p. 2313) , the IDE does not see the table 
that will be dynamically created because it will only be created at runtime. The same warning appears on 
line 58 for the same reason. 


4.5.9.6 Homework assignment 


See the JSP section in Blackboard for all JSP homework assignments. 
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4.5.9.6.1 Supplemental Reading 


https: //developer.mozilla.org /en-US /docs /Web/Guide/HTML/Forms/Styling _ HTML _ forms ?°° 
http: //www.wufoo.com/html5 /attributes/11-novalidate.html?num=4 7°! 
http: //www.w3.org/TR/html401 /interact /forms.html ?°? 
http: //www.whatwg.org/specs /web-forms/current-work/ 7°? 
http: //www.w3schools.com/html/html_forms.asp 754 
http: //www.w3schools.com/tags/att__button_value.asp ?°° 


4.5.9.7 Summary 


HTML forms are essential to the modern web. All commercial sites that establish and maintain customer 
relationships employ forms to capture data. Using JSP to process form submissions was the focus of this 
module. The form controls were covered in addition to the action and method attributes of the form object. 
Characteristics of the Request object were also reviewed. 


4.5.9.8 What’s next? 


In the next module, custom object oriented development techniques will be employed. Java classes will be 
introduced in the JSP to benefit from the encapsulation and modularity that object orientation provides. 


250https:/ /developer.mozilla.org/en-US/docs/Web/Guide/HTML/Forms/Styling HTML_ forms 
25. http://www.wufoo.com/html5/attributes/11-novalidate.html?num=4 
252http://www.w3.org/TR/html401/interact /forms.html 
-53http://www.whatwg.org/specs/web-forms/current-work / 
254http://www.-w3schools.com/html/html_forms.asp 
255http://www.w3schools.com/tags/att button  value.asp 
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4.5.9.9 Images 


amazon Your Account | Help 
wee? 


Sign In 
What is your e-mail address? 


My e-mail addressis:| 


Do you have an Amazon.com password? 
© No, Iam a new customer. 


®© Yes, I have a password: 
Forgot your password? 


Sign In Help 
Forgot your password? Get password help. 
Has your e-mail address changed? Update it here. 


Conditions of Use Privacy Notice © 1996-2013, Amazon.com, Inc. or its affiliates 
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amazon Your Account | Help 
wee? 
Sign In 


What is your e-mail address? 
My e-mail address is: | es 


Do you have an Amazon.com password? 


© No, I am a new customer. 


© Yes, [have a password: 
Forgot your password? 


Sign In Help 
Forgot your password? Get password help. 
Has your e-mail address changed? Update it here. 


Conditions of Use Privacy Notice © 1996-2013, Amazon.com, Inc. or its affiliates 
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amazon Your Account | Help 
wee? 
Sign In 


What is your e-mail address? 


My e-mail address is: | 


Do you have an Amazon.com password? 


© No, I am a new customer. 


Forgot your password? 


® Yes, Ihave a password: 


Sign In Help 
Forgot your password? Get password help. 
Has your e-mail address changed? Update it here. 


Conditions of Use Privacy Notice © 1996-2013, Amazon.com, Inc. or its affiliates 
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Image 1 . Sample Form - Amazon.com 


-= amazon Your Account | Help 
wee? 


Sign In 
What is your e-mail address? 
My e-mail address is: l 
Do you have an Amazon.com password? 


© No, I am a new customer. 


Forgot your password? 


®© Yes, I have a password: 


Sign In Help 


Forgot your password? Get password help. 
Has your e-mail address changed? Update it here. 


Conditions of Use Privacy Notice © 1996-2013, Amazon.com, Inc. or its affiliates 


Table 4.539 


<form name="signIn" method="POST" id="ap signin form" 
novalidate="novalidate" action="https://www.amazon.com/ap/ signin" 


<form name="signIn" method="POST" id="ap signin form" 
novalidate="novalidate" action="https://www.amazon.com/ap/ signin"$ 


<form name="signIn" method="POST" id="ap_signin form" 
novalidate="novalidate" action="https://www.amazon.com/ap/ signin" 
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Image 2 . Form Element of Amazon.com 


<form name="signin" method="POST" id="ap signin form" 
novalidate="novalidate" action="https://www.amazon.com/ap/ signin" 


Table 4.540 


Ea : 
Safari 


Image 3 . Browser Support for novalidate Attribute 


Safari 
rx 
x 
Table 4.541 


Form Element | Purpose 


‘button | Creates buttons 
datalist Specifies list of predefined values 


Creates numerous input types 


input 
‘option © | Element of a selection list 
select | 


Selection list consisting of options 


Area for text entry 
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option | Element of a selection list _ 


Image 4 . Common HTML Form Elements 


Element of a selection list 
Selection list consisting of options 
Area for text entry 


Table 4.542 
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<!DOCTYPE html> 
<!-- join acc code academy.html --> 
<html> 
<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new _member.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 


</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 
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<!-- join acc code academy.html --> 


<html> 
<head> 


<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 


</head> 
<body> 


<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new _member.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 


<tr> 


<td>First Name:</td> 
<td><input type="text” name="firstName"></td> 


</tr> 
<tr> 


<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 


</tr> 
<tr> 


<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 


</tr> 
<tr> 


<td>Skill Level:</td> 
<td><select name="skillLevel"> 


w 
VAO 


<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 


pa 
Q) 


</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 
<!-- join _ acc code academy.html --> 
<html> 
<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new _member.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text” name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 


</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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Image 5 . Code - join _acc_code_academy.html 


1 


Ow own oe WwW NY 
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<!DOCTYPE html> 


<html> 
<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new member.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tx> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 


</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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Table 4.543 


Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


First Name: James (2) 


Last Name: Gosling 


Yow Dis (al 


Join the College 
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Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


= Level: = 
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Join ACC Code Academy 


To join ACC Code Academy please enter your information. 
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Image 6 . Output - join_acc_code_academy.html 


Join ACC Code Academy _ 


To join ACC Code Academy please enter your information. 


James E) 


Tou Dis O) 
Skill Level: y] 


Table 4.544 
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1| <!DOCTYPE HTML> 
2 <!-- displ _new_member.jsp --> 
3| <%@ page import="java.io.*,java.util.*" %> 
4| <html> 
5| <head> 
6 <title>Display New Member</title> 
7 <link rel="stylesheet" href="css/css-1.css"> 
8| </head> 
9| <body> 
10 <% 
11 // get parameters from the request object 


12 String firstName = request.getParameter ("firstName"); 


13 String lastName = request.getParameter ("lastName"); 

14 String phoneNumber = request.getParameter ("phoneNumber") ; 
15 String skillLevel = request.getParameter ("skillLevel"); 

16 $> 

17| <div class="center"> 

18 <hi>Thank you for joining ACC Code Academy.</h1> 

19 <h2>This is the information entered:</h2> 

20| <table class="inline-block"> 

21 <tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
22 <tr> 

23 <td>First Name:</td> 

24 <td><$= firstName %></td> 

25 </tr> 

26 <tr> 

27 <td>Last Name:</td> 

28 <td><%= lastName %></td> 

29 </tr> 

30 <tr> 

31 <td>Phone Number:</td> 

32 <td><%= phoneNumber %></td> 

33 </tr> 

34 <tr> 

35 <td>Skill Level:</td> 

36 <td><%= skillLevel %></td> 

37 </tr> 

38| </table> 

39. <p>To add another new member, select the button below.</p> 

40| <form action="join_acc_code academy.html" method="get"> 

41 <input type="submit" value="Enter Another New Member"> 

42| </form> 

43! <h2>Unsorted Parameter Names</h2> 

44| <table class="inline-block"> 

a <tr><th class="table header" colspan="2">Unsorted Parameters</th></tr> 
46 <$% 

47 Enumeration parameterNames = request.getParameterNames(); 
48 while (parameterNames.hasMoreElements()) { 

49 String paramName = (String) parameterNames.nextElement (); 
50 out.print("<tr><td>" + paramName + "</td>\n"); 

51 String paramValue = request.getParameter (paramName) ; 
52 out.printin("<td> " + paramValue + "</td></tr>\n"); 
53 } 

54 $> 


55| </table> 
56 <h2>Sorted Parameter Names</h2> 
57| <table class="inline-block"> 


@ <tr><th class="table header" colspan="2">Sorted Parameters</th></tr> 
59 <$% 

60 List<String> list = Collections. list(request.getParameterNames()); 
61 Collections. sort(list); 

62 for (String valueName : list) { 

63 out.print ("<tr><td>" + valueName + "</td>\n"); 

64 String paramValue = request.getParameter (valueName) ; 

65 out.printin("<td> " + paramValue + "</td></tr>\n"); 

66 } 

67 $> 

68| </table> 

69| </div> 

70, </body> 

71| </html> 
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1| <!DOCTYPE HTML> 
2 <!-- displ _new_member.jsp --> 
3| <%@ page import="java.io.*,java.util.*" %> 
4| <html> 
5| <head> 
6 <title>Display New Member</title> 
7 <link rel="stylesheet" href="css/css-1.css"> 
8| </head> 
9| <body> 
10 <% 
11 // get parameters from the request object 


12 String firstName = request.getParameter ("firstName"); 


13 String lastName = request.getParameter ("lastName"); 

14 String phoneNumber = request.getParameter ("phoneNumber") ; 
15 String skillLevel = request.getParameter ("skillLevel"); 

16 $> 

17| <div class="center"> 

18 <hi>Thank you for joining ACC Code Academy.</h1> 

19 <h2>This is the information entered:</h2> 

20| <table class="inline-block"> 

21 <tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
22 <tr> 

23 <td>First Name:</td> 

24 <td><$= firstName %></td> 

25 </tr> 

26 <tr> 

27 <td>Last Name:</td> 

28 <td><%= lastName %></td> 

29 </tr> 

30 <tr> 

31 <td>Phone Number:</td> 

32 <td><%= phoneNumber %></td> 

33 </tr> 

34 <tr> 

35 <td>Skill Level:</td> 

36 <td><%= skillLevel %></td> 

37 </tr> 

38| </table> 

39. <p>To add another new member, select the button below.</p> 

40| <form action="join_acc_code academy.html" method="get"> 

41 <input type="submit" value="Enter Another New Member"> 

42| </form> 

43! <h2>Unsorted Parameter Names</h2> 

44| <table class="inline-block"> 

a <tr><th class="table header" colspan="2">Unsorted Parameters</th></tr> 
46 <$% 

47 Enumeration parameterNames = request.getParameterNames(); 
48 while (parameterNames.hasMoreElements()) { 

49 String paramName = (String) parameterNames.nextElement (); 
50 out.print("<tr><td>" + paramName + "</td>\n"); 

51 String paramValue = request.getParameter (paramName) ; 
52 out.printin("<td> " + paramValue + "</td></tr>\n"); 
53 } 

54 $> 


55| </table> 
56 <h2>Sorted Parameter Names</h2> 
57| <table class="inline-block"> 


@ <tr><th class="table header" colspan="2">Sorted Parameters</th></tr> 
59 <$% 

60 List<String> list = Collections. list(request.getParameterNames()); 
61 Collections. sort(list); 

62 for (String valueName : list) { 

63 out.print ("<tr><td>" + valueName + "</td>\n"); 

64 String paramValue = request.getParameter (valueName) ; 

65 out.printin("<td> " + paramValue + "</td></tr>\n"); 

66 } 

67 $> 

68| </table> 

69| </div> 

70, </body> 

71| </html> 
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1| <!DOCTYPE HTML> 
2 <!-- displ _new_member.jsp --> 
3| <%@ page import="java.io.*,java.util.*" %> 
4| <html> 
5| <head> 
6 <title>Display New Member</title> 
7 <link rel="stylesheet" href="css/css-1.css"> 
8| </head> 
9| <body> 
10 <% 
11 // get parameters from the request object 


12 String firstName = request.getParameter ("firstName"); 


13 String lastName = request.getParameter ("lastName"); 

14 String phoneNumber = request.getParameter ("phoneNumber") ; 
15 String skillLevel = request.getParameter ("skillLevel"); 

16 $> 

17| <div class="center"> 

18 <hi>Thank you for joining ACC Code Academy.</h1> 

19 <h2>This is the information entered:</h2> 

20| <table class="inline-block"> 

21 <tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
22 <tr> 

23 <td>First Name:</td> 

24 <td><$= firstName %></td> 

25 </tr> 

26 <tr> 

27 <td>Last Name:</td> 

28 <td><%= lastName %></td> 

29 </tr> 

30 <tr> 

31 <td>Phone Number:</td> 

32 <td><%= phoneNumber %></td> 

33 </tr> 

34 <tr> 

35 <td>Skill Level:</td> 

36 <td><%= skillLevel %></td> 

37 </tr> 

38| </table> 

39. <p>To add another new member, select the button below.</p> 

40| <form action="join_acc_code academy.html" method="get"> 

41 <input type="submit" value="Enter Another New Member"> 

42| </form> 

43! <h2>Unsorted Parameter Names</h2> 

44| <table class="inline-block"> 

a <tr><th class="table header" colspan="2">Unsorted Parameters</th></tr> 
46 <$% 

47 Enumeration parameterNames = request.getParameterNames(); 
48 while (parameterNames.hasMoreElements()) { 

49 String paramName = (String) parameterNames.nextElement (); 
50 out.print("<tr><td>" + paramName + "</td>\n"); 

51 String paramValue = request.getParameter (paramName) ; 
52 out.printin("<td> " + paramValue + "</td></tr>\n"); 
53 } 

54 $> 


55| </table> 
56 <h2>Sorted Parameter Names</h2> 
57| <table class="inline-block"> 


@ <tr><th class="table header" colspan="2">Sorted Parameters</th></tr> 
59 <$% 

60 List<String> list = Collections. list(request.getParameterNames()); 
61 Collections. sort(list); 

62 for (String valueName : list) { 

63 out.print ("<tr><td>" + valueName + "</td>\n"); 

64 String paramValue = request.getParameter (valueName) ; 

65 out.printin("<td> " + paramValue + "</td></tr>\n"); 

66 } 

67 $> 

68| </table> 

69| </div> 

70, </body> 

71| </html> 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2307 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2308 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Image 7 . Code - display _new_member.jsp 


1| <!DOCTYPE HTML> 
ee — "i rone 
3| <%@ page import="java.io.*,java.util.*" %> 
4| <html> 
5| <head> 
6 <title>Display New Member</title> 
7 <link rel="stylesheet" href="css/css-1.css"> 
& </head> 
9! <body> 
10, <% 
11 // get parameters from the request object 
12 String firstName = request.getParameter ("firstName"); 
13 String lastName = request.getParameter ("lastName"); 
14 String phoneNumber = request.getParameter ("phoneNumber") ; 
15 String skillLevel = request.getParameter ("skillLevel"); 
16 $> 
17| <div class="center"> 
18 <hi>Thank you for joining ACC Code Academy.</hi> 
19| <h2>This is the information entered:</h2> 
20| <table class="inline-block"> 
21 <tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
22 <tr> 
23 <td>First Name:</td> 
24 <td><%= firstName %></td> 
25 </tr> 
26 <tr> 
27 <td>Last Name:</td> 
28 <td><%= lastName %></td> 
29 </tr> 
30 <tr> 
31 <td>Phone Number:</td> 
32 <td><%= phoneNumber %></td> 
33 </tr> 
34 <tr> 
35 <td>Skill Level:</td> 
36 <td><%$= skillLevel %></td> 
37 </tr> 
38| </table> 
39 <p>To add another new member, select the button below.</p> 
40| <form action="join_acc_code academy.html" method="get"> 


41 <input type="submit" value="Enter Another New Member"> 

42| </form> 

43|! <h2>Unsorted Parameter Names</h2> 

44| <table class="inline-block"> 

@ <tr><th class="table header" colspan="2">Unsorted Parameters</th></tr> 


46 <% 

47 Enumeration parameterNames = request.getParameterNames (); 
48 while (parameterNames.hasMoreElements()) { 

49 String paramName = (String) parameterNames.nextElement (); 
50 out.print("<tr><td>" + paramName + "</td>\n"); 

S2 String paramValue = request.getParameter (paramName) ; 

52 out.printin("<td> " + paramValue + "</td></tr>\n"); 

53 } 

54 $> 


55| </table> 
56! <h2>Sorted Parameter Names</h2> 
57| <table class="inline-block"> 


@ <tr><th class="table header" colspan="2">Sorted Parameters</th></tr> 
59 <$% 

60 List<String> list = Collections.list(request.getParameterNames ()); 
61 Collections. sort (list); 

62 for (String valueName : list) { 

63 out.print ("<tr><td>" + valueName + "</td>\n"); 

64 String paramValue = request.getParameter (valueName) ; 

65 out.printin("<td> " + paramValue + "</td></tr>\n"); 

66 } 

67 $> 

68 </table> 

69| </div> 

70| </body> 


1| </html> M 
Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2309 


Table 4.545 
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Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 


First Name: 


Last Name: Gosling 
Phone Number:]/5 12555123 
Skill Level: expert 


To add another new member, select the button below. 


Enter Another New Member 


Unsorted Parameter Names 


lastName Gosling 


Sorted Parameter Names 
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Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 


First Name: 


Last Name: Gosling 
Phone Number:]/5 12555123 
Skill Level: expert 


To add another new member, select the button below. 


Enter Another New Member 


Unsorted Parameter Names 


lastName Gosling 


Sorted Parameter Names 
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Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 


First Name: 


Last Name: Gosling 
Phone Number:]/5 12555123 
Skill Level: expert 


To add another new member, select the button below. 


Enter Another New Member 


Unsorted Parameter Names 


lastName Gosling 


Sorted Parameter Names 
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a Image 8 . Output - display _new_member.jsp =] 
Thank you for joining ACC 
Code Academy. 

This is the information entered: 


Information Entered 


First Name: 


Last Name: Gosling 
hone Number:|/5 12555123 
Skill Level: expert 


To add another new member, select the button below. 


Enter Another New Member 


Unsorted Parameter Names 


lastName Gosling 
skillLevel expert 


[phoneNumber]5 12555123 


firstName 


Sorted Parameter Names 


firstName 


lastName Gosling 


512555123 
skillLevel 
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Table column 2 established by element "th" has no cells beginning in it. PROd="Ger"> 


41 |From line 39, column 12; to line 39, column 48 New Member"3 
42! | (Rule Category: All Other) 
43 Pace 


Qa <tr><th class="table er" colspan="2">Unsorted Parameters</th></tr> 


Table column 2 established by element "th" has no cells beginning in it. PROG="Ger"> 


41 |From line 39, column 12; to line 39, column 48 New Member"3 
42! | (Rule Category: All Other) 
43 ZEA 
® 
40 
41 From line 39, column 12; te line 39, column 48 New Member"3 
42 | (Rule Category: All Other) 
= ia 
oy <tr><th class="p an="2">Unsorted Parameters</th></tr> 


2317 


Image 9 . Code - Incorrect Advisory.html 


Table column 2 established by element "th" has no cells beginning in it. [>2Od="geu"> 


41 |From line 39, column 12; to line 39, column 48 New Member "> 
42 | (Rule Category: All Other) 
43 pias 


44 Alt-Enter shows hints) 


@ <tr><th class=" er" colspan="2">Unsorted Parameters</th></tr> 


Table 4.547 


4.5.9.10 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4350: Form Processing with JSP 
e Author: Dr. R.L.Martinez 

e Maintainer: R.G.Baldwin 

e File: Java4350.htm 

e Published: 11/27/13 

e Revised 12/26/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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4.5.10 Java4350r: Review” 
4.5.10.1 Table of Contents 


e Preface (p. 2324) 
e Background information (p. 2324) 


An HTML form (p. 2325) 

Import required classes (p. 2325) 

Get parameter values (p. 2325) 

Default package imports (p. 2325) 

The ServletRequest interface (p. 2325) 

The request object (p. 2325) 

Display parameter values in a table (p. 2326) 
Display unsorted parameter data (p. 2326) 
Display sorted parameter data (p. 2326) 


e Questions (p. 2326) 


1 (p. 2326) , 2 (p. 2326) , 3 (p. 2327) , 4 (p. 2327) , 5 (p. 2327) , 6 (p. 2327) , 7 (p. 2327) , 8 
(p. 2327) , 9 (p. 2327) , 10 (p. 2327) , 11 (p. 2328) , 12 (p. 2328) , 13 (p. 2328) , 14 (p. 2328) 
, 15 (p. 2328) , 16 (p. 2329) , 17 (p. 2329) , 18 (p. 2329) , 19 (p. 2329) , 20 (p. 2329) , 21 (p. 
2329) , 22 (p. 2329) , 23 (p. 2330) , 24 (p. 2330) , 25 (p. 2330) , 26 (p. 2330) , 27 (p. 2330) , 28 
(p. 2330) , 29 (p. 2330) , 30 (p. 2331) , 31 (p. 2331) , 32 (p. 2331) , 33 (p. 2331) , 34 (p. 2331) 
, 35 (p. 2331) , 36 (p. 2331) , 37 (p. 2331) 


Image index (p. 2332) 
Answers (p. 2333) 
Images (p. 2338) 
Miscellaneous (p. 2369) 


4.5.10.2 Preface 


This module is one in a collection of modules on JavaServer Pages (JSP) designed for teaching ITSE2317 - 
Java Programming (Intermediate) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4350: Form Processing 
with JSP 757 . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 

The Images (p. 2338) section contains a number of images that you may find helpful as reference material 
in answering the questions. 


4.5.10.3 Background information 


The module named Java4350: Form Processing with JSP ?58 presented a JSP program having to do with 
form processing. The main purpose of this module is to provide a series of review questions and answers 
that you can use to solidify the information in your mind. 


256This content is available online at <http://cnx.org/content /m48188/1.5/>. 
25Thttp://cnx.org/content /m48085 /latest /?collection=col11441 /latest 
2°8http://cnx.org/content /m48085 /latest /?collection=col11441 /latest 
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4.5.10.3.1 An HTML form 


Line 12 in Image 5 (p. 2348) is the beginning of a form element that ends on Line 41. This HTML file 
produces the screen display shown in Image 6 (p. 2352) . The screen output shows a two-column table with 
a submit button in the last row of the rightmost column. 

The action attribute on Line 12 shows that the code in the file named display_new_member.jsp 
( Image 7 (p. 2359) ) will be executed when the user presses the submit button. Other than that, Image 
5 (p. 2348) is devoid of JSP code. 


4.5.10.3.2 Import required classes 


The JSP file named display _new_member.jsp_ is shown in Image 7 (p. 2359) . 
A JSP directive tag at the top of Image 7 (p. 2359) causes the java.io and java.util packages and 
all the classes that they contain to be imported. 
(Note that the two packages are in a comma-separated list, surrounded by quotation marks with no 
terminating semicolon.) 


4.5.10.3.3 Get parameter values 


Further down the page, we see a scriptlet tag containing four Java statements. Each statement calls 
a method named getParameter on a reference named request , passing the name portion of a 
name::value pair as a parameter to the method. 


4.5.10.3.4 Default package imports 


According to the Default Package Imports 759 documentation, the JSP container by default imports the 
following packages into any JSP page, in accordance with the JSP specification. No page directive import 
settings are required: 


e javax.servlet..* 
e javax.servlet.http.* 
e javax.servlet..jsp.* 


4.5.10.3.5 The ServletRequest interface 


The javax.servlet package contains an interface named ServletRequest . Among other methods, the 
ServletRequest interface declares the method named getParameter that is called in Image 7 (p. 2359) 
. The getParameter method receives the name portion of a name::value pair as a parameter and 


"returns the value of a request parameter as a String , or null if the parameter does not 
exist." 


4.5.10.3.6 The request object 


The JSP container creates and maintains an object that implements the ServletRequest interface and 
refers to that object as request . All methods declared in the ServletRequest interface, including the 
method named getParameter , can be called on the reference named request . As explained above, 
the name portion of a name::value pair is passed as a parameter to the method and the value portion 
is returned as type String 

The scriptlet code in Image 7 (p. 2359) declares four new String variables and stores references to 
the values returned by those method calls in those variables. 


59http://docs.oracle.com/cd/A97688 _16/generic.903/a97679/getstart.htm71007970 
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4.5.10.3.7 Display parameter values in a table 


Further down the page in Image 7 (p. 2359) , we see four usages of expression tags to populate the cells 
in an HTML table with those values. This results in the table shown in Image 8 (p. 2367) under the heading 
This is the information entered . 


4.5.10.3.8 Display unsorted parameter data 


Another scriptlet tag appears further down the page in Image 7 (p. 2359) . This scriptlet begins by 
calling the getParameterNames method, (which is also declared in the ServletRequest interface) , 
on the reference named request . This method 


"returns an Enumeration of String objects, each String containing the name of a request param- 
eter; or an empty Enumeration if the request has no parameters" 


Then the scriptlet uses a while loop and standard Enumeration code to get and display the 
name::value pair for each parameter. The results are shown in the table labeled Unsorted Parameters in 
Image 8 (p. 2367) . 


4.5.10.3.9 Display sorted parameter data 
Finally, the last scriptlet tag on the page in Image 7 (p. 2359) 


e gets another Enumeration on the request object 
e calls the static list method of the Collections class passing the Enumeration as a parameter. 


The list method 


"returns an array list containing the elements returned by the specified enumeration in the order 
they are returned by the enumeration." 


After that, the scriptlet calls the static sort method of the Collections class to sort the list in 
ascending natural order based on the name portion of the name::value pairs.. 

(If you are unfamiliar with collections, see Java4010: Getting Started with Java Collections °° and 
the modules following that one.) 

Then the scriptlet uses a for loop to populate a table with the name::value pairs in ascending 
natural order. The results are shown in the table labeled Sorted Parameters in Image 8 (p. 2367) . 


4.5.10.4 Questions 

4.5.10.4.1 Question 1 

True or False? Forms are required for websites to obtain information from users. 
Go to answer 1 (p. 2337) 


4.5.10.4.2 Question 2 


True or False? When a form is submitted, the browser packages the data and selections supplied by the user 
and forwards that content to the receiving page on the server. 
Go to answer 2 (p. 2337) 


6°http://cnx.org/content /m46135/latest /?collection=col11441/latest 
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4.5.10.4.3 Question 3 


True or False? When elements are added to HTML forms, the browser can retrieve information from users 
and send that data to the web server. JSP running on the server can then process the data and potentially 
modify the user experience based on user input. 

Go to answer 3 (p. 2337) 


4.5.10.4.4 Question 4 


True or False? When the data and selections supplied by the form user are forwarded to the receiving page 
on the server, code on the receiving page can perform processing tasks with the data. 
Go to answer 4 (p. 2337) 


4.5.10.4.5 Question 5 


True or False? The Amazon form shown in Image 1 (p. 2341) displays six elements that support user input. 
What kinds of elements are they? 
Go to answer 5 (p. 2337) 


4.5.10.4.6 Question 6 


True or False? A textbox element isan input element with an attribute named text that has a value 
of "type" 
Go to answer 6 (p. 2337) 


4.5.10.4.7 Question 7 


True or False? A submit button is an input element with an attribute named type that has a value 
of "submit" 
Go to answer 7 (p. 2337) 


4.5.10.4.8 Question 8 


True or False? When selected by the user, a submit button engages the process to collect form data and 
send it to the destination specified by the action attribute of the form element. 
Go to answer 8 (p. 2337) 


4.5.10.4.9 Question 9 


True or False? A radio button is an input element with an attribute named type that has a value of 
"radio" . Typically the group consists of two or more buttons and the user can select one or more buttons 
from the group. 

Go to answer 9 (p. 2337) 


4.5.10.4.10 Question 10 


True or False? One button from a group of radio buttons (the default) must always be preselected when 
the buttons appear on the screen. 
Go to answer 10 (p. 2336) 
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4.5.10.4.11 Question 11 


Given: The content of an HTML element is the material between the opening tag and the closing tag. 
True or False? The various elements on an HTML form are often (but not always) constructed using 
empty HTML elements (meaning that the elements have no content) . In the case of an empty HTML 
element, the type of element is specified by the name of the element. Information about the element is 
conveyed by the attributes and their values. 
Go to answer 11 (p. 2336) 


4.5.10.4.12 Question 12 


True or False? An HTML form is created within an HTML document by the HTML element shown in Image 
10 (p. 2328) . 


Image 10 . An HTML form. 


<form> 
input elements 


</form> 


Table 4.548 


Go to answer 12 (p. 2336) 


4.5.10.4.13 Question 13 


True or False? There are three possible values for the method attribute of a form element: 


e GET 
e POST 
e DUMP 


Go to answer 13 (p. 2336) 


4.5.10.4.14 Question 14 

True or False? The id attribute of a form element, when used, must be unique. 
Go to answer 14 (p. 2336) 

4.5.10.4.15 Question 15 


True or False? The value of the action attribute of a form element specifies the destination to which 
the form data will be sent when the submit button is pressed. 
Go to answer 15 (p. 2336) 
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4.5.10.4.16 Question 16 


Given: The elements on an HTML form are also known as controls and/or objects . 
True or False? The following is a non-exclusive list of controls that often appear an HTML form: 


button 
datalist 
input 
option 
select 
textarea 


Go to answer 16 (p. 2336) 


4.5.10.4.17 Question 17 


True or False? The name attribute on an input control is outdated and is mostly used solely for 
documentation purposes in modern web development. 
Go to answer 17 (p. 2336) 


4.5.10.4.18 Question 18 


True or False? When the submit button for a form is pressed, the browser collects all names and associated 
values for all controls within the form and sends that information (as name::value pairs) to the destination 
determined by the action attribute of the form element. 

Go to answer 18 (p. 2336) 


4.5.10.4.19 Question 19 


True or False? The form element that begins on Line 12 and ends on Line 41 of Image 5 (p. 2348) causes 
a visible rectangle containing several controls to appear on the screen. 
Go to answer 19 (p. 2335) 


4.5.10.4.20 Question 20 


True or False? The value of the action attribute on Line 12 of Image 5 (p. 2348) specifies the destination 
to which the server will send submitted form data as the user enters the data into the various data input 
controls on the form. 

Go to answer 20 (p. 2335) 


4.5.10.4.21 Question 21 


True or False? In Image 5 (p. 2348) , a JSP named display _new_member.jsp_ is called to process the 
form data that has been entered when the user presses the submit button. 
Go to answer 21 (p. 2335) 


4.5.10.4.22 Question 22 


True or False? The code in Image 5 (p. 2348) displays an HTML table with two columns. User input controls 
are displayed on the rows in the rightmost column with labels that identify the type of data expected on 
corresponding rows in the leftmost column. 

Go to answer 22 (p. 2335) 
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4.5.10.4.23 Question 23 


True or False? The code in Image 5 (p. 2348) displays four input elements of type text . Each input 
element has an attribute named name , and the values associated with those attributes are: 


firstName 
lastName 
phoneNumber 
ssNumber 


Go to answer 23 (p. 2335) 


4.5.10.4.24 Question 24 


True or False? The select control shown on Lines 29 through 33 in Image 5 (p. 2348) produces a visual 
object on the screen that some may call a pull-down list. As opposed to having to type the input value, this 
control allows the user to select one value among the following three predefined values: 


e beginner 
e intermediate 
e expert 


Go to answer 24 (p. 2335) 


4.5.10.4.25 Question 25 


True or False? In Image 5 (p. 2348) , the content of the selected option element on Lines 30, 31, and 32 
is sent to the server along with skillLevel as part of the name::value pair. 
Go to answer 25 (p. 2335) 


4.5.10.4.26 Question 26 


True or False? In Image 5 (p. 2348) , the content of the selected option element on Lines 30, 31, and 32 
must match the value of the value attribute for the element. 
Go to answer 26 (p. 2335) 


4.5.10.4.27 Question 27 
True or False? In Image 5 (p. 2348) , the code that produces the pull-down list is an input element. 
Go to answer 27 (p. 2334) 


4.5.10.4.28 Question 28 


True or False? In Image 5 (p. 2348) , the code on Line 38 produces a visual representation of a button with 
the label "Join the College". This control is used to invoke the data packaging and submission processes 
described earlier. 

Go to answer 28 (p. 2334) 


4.5.10.4.29 Question 29 


True or False? When the submit button is pressed in Image 5 (p. 2348) , the browser gathers up all 
of the input data from the controls and sends that data to the server, which passes it to a JSP named " 
display new _member.jsp ". 

Go to answer 29 (p. 2334) 
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4.5.10.4.30 Question 30 


True or False? The code in Image 7 (p. 2359) is executed when the submit button defined by Line 38 in 
Image 5 (p. 2348) is pressed. 
Go to answer 30 (p. 2334) 


4.5.10.4.31 Question 31 


True or False? Each Java import directive in a JSP requires a separate directive tag. 
Go to answer 31 (p. 2334) 


4.5.10.4.32 Question 32 


True or False? The name::value pairs sent by the browser are stored on the server in a Request object 
referred to by data . 
Go to answer 32 (p. 2334) 


4.5.10.4.33 Question 33 


True or False? Java code in a scriptlet tag can access the value associated with a given name in a 
name::value pair by calling the getParameter method on a reference to the Request object and passing 
the name as a parameter to the method. 

Go to answer 33 (p. 2334) 


4.5.10.4.34 Question 34 


True or False? Having stored a String value in a local variable, the code in a JSP can insert that string 
into the outgoing HTML code by enclosing the variable name in a JSP declaration tag. 
Go to answer 34 (p. 2334) 


4.5.10.4.35 Question 35 


Given: The Request object provides a variety of methods that can be used to query its contents. 

True or False? The Request object provides a method named getParameterNames that returns a 
reference to an object that implements the Enumeration interface, which is designed to enumerate across 
the names of the name::value pairs contained in the Request object. 

Go to answer 35 (p. 2334) 


4.5.10.4.36 Question 36 


True or False? Java code in a scriptlet can insert raw HTML code in the returned HTML page by 
calling the print method on a reference named out and constructing the raw HTML code as a String 
parameter to the print method. 

Go to answer 36 (p. 2333) 


4.5.10.4.37 Question 37 


True or False? The code on Line 61 of Image 7 (p. 2359) creates and populates an object of type LinkedList 
containing the elements returned by the Enumeration object referred to by parameterNames2 in the 
order they are returned by the enumeration. (See the Java documentation.) 

Go to answer 37 (p. 2333) 
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2341) . The Amazon form. 


2342) . Form Element of Amazon.com. 
2342) . Browser Support for novalidate Attribute. 
2343) . Common HTML Form Elements. 
2348) . Code - join _acc_code_academy.html. 
. 2352) . Output - join _acc_code_academy.html. 
2359) . Code - display_new_member.jsp. 
2367) . Output - display_new_member.jsp. 
2368) . Code - Incorrect Advisory. html. 
8 


Image 11 (p. 2369) . JSP tags. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


Display your nam 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


4.5.10.6 Answers 
4.5.10.6.1 Answer 37 


False. The code on Line 61 of Image 7 (p. 2359) creates and populates an object of type ArrayList 
containing the elements returned by the Enumeration object referred to by parameterNames2 in the 
order they are returned by the enumeration. 

According to the Java documentation, the list method of the Collections class returns a reference 
to an object of the class ArrayList . However, because of the implementation of runtime polymorphism 
in the Java Collections Framework , it really doesn’t matter whether the object is type LinkedList or 
type ArrayList . In either case, the desired result can be achieved by treating the object as the more 
generic type of the List interface. 

If you don’t understand all of this, see Java4010: Getting Started with Java Collections 76! and Java4210: 
Getting Started with Generics 7° . 

Go back to Question 37 (p. 2331) 


4.5.10.6.2 Answer 36 


True. (See Line 50 in Image 7 (p. 2359) .) 
Go back to Question 36 (p. 2331) 


61 http://cnx.org/content /m46135 /latest /?collection=col11441 /latest 
62http://cnx.org/content /m47554/latest /?collection=col11441 /latest 
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4.5.10.6.3 Answer 35 


True. See http://cnx.org/content /m45597/latest /Java076.htm 7° for more information on the use of the 
Enumeration interface. 

Go back to Question 35 (p. 2331) 
4.5.10.6.4 Answer 34 


False. Having stored a String value in a local variable, the code in a JSP can insert that string into the 
outgoing HTML by enclosing the variable name in a JSP expression tag. (See Line 24 in Image 7 (p. 
2359) .) 

Go back to Question 34 (p. 2331) 
4.5.10.6.5 Answer 33 
True. (See Line 12 in Image 7 (p. 2359) .) 

Go back to Question 33 (p. 2331) 
4.5.10.6.6 Answer 32 


False. The name::value pairs sent by the browser are stored on the server ina Request object referred to 
by request 

Go back to Question 32 (p. 2331) 
4.5.10.6.7 Answer 31 


False. Multiple Java import directives can be included as a comma-separated list in the value of a JSP 
import attribute ina JSP directive tag. (See Line 3 of Image 7 (p. 2359) .) 
Go back to Question 31 (p. 2331) 
4.5.10.6.8 Answer 30 
True. 
Go back to Question 30 (p. 2331) 
4.5.10.6.9 Answer 29 
True. 
Go back to Question 29 (p. 2330) 
4.5.10.6.10 Answer 28 
True. 
Go back to Question 28 (p. 2330) 
4.5.10.6.11 Answer 27 


False. Although the select element is provided to support user input, it is not an input element as in 
the case of the text controls discussed earlier and the submit control to be discussed later. It is, in fact, 
a select element with nested option elements. 

Go back to Question 27 (p. 2330) 


63http://cnx.org/content /m45597 /latest /Java076.htm 
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4.5.10.6.12 Answer 26 


False. The content of each option element is displayed in the pull-down list for the benefit of the user. 
There is no technical requirement for the content to match the value of the value attribute in an option 
element. For example, the values 0, 1, and 2 could be used to represent Beginner, Intermediate, and Expert 
respectively. 

Go back to Question 26 (p. 2330) 


4.5.10.6.13 Answer 25 


False. It is the value of the value attribute of the selected option element on Lines 30, 31, and 32 
(and not the content of the element) that is sent to the server as the value for the skillLevel name in the 
name::value pair. 

Go back to Question 25 (p. 2330) 


4.5.10.6.14 Answer 24 

True. Note that three HTML option elements are nested as content inthe HTML select element. 
Go back to Question 24 (p. 2330) 

4.5.10.6.15 Answer 23 


False. The code in Image 5 (p. 2348) displays only three input elements of type text . Each input element 
has an attribute named name , and the values associated with those attributes are: 


e firstName 
e lastName 
e phoneNumber 


Go back to Question 23 (p. 2330) 


4.5.10.6.16 Answer 22 


True. 
Go back to Question 22 (p. 2329) 


4.5.10.6.17 Answer 21 


True. 
Go back to Question 21 (p. 2329) 


4.5.10.6.18 Answer 20 


False. The value of the action attribute on Line 12 of Image 5 (p. 2348) specifies the destination to which 
the server will send form data when the user pushes the submit button created by Line 38 on Image 5 (p. 
2348) . Data is not sent to the server in real time as it is entered into the various controls in the form. It is 
only sent when the user presses the submit button. 

Go back to Question 20 (p. 2329) 


4.5.10.6.19 Answer 19 


False. The form itself is not visible on the screen. Only the controls contained within the form are visible. 
(See w3schools 7° .) 
Go back to Question 19 (p. 2329) 


264 http://www.-w3schools.com/html/html_forms.asp 
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4.5.10.6.20 Answer 18 
True 
Go back to Question 18 (p. 2329) 
4.5.10.6.21 Answer 17 
False. The name attribute on an input control is a critical piece of the puzzle. As a user enters data 
into an HTML form, the data values are paired up with the values of the name attributes of the elements 
into which the user enters the data. Those mname::value pairs are sent to the receiving page on the 
server when the user selects the submit control. 
Go back to Question 17 (p. 2329) 
4.5.10.6.22 Answer 16 
True. 
Go back to Question 16 (p. 2329) 
4.5.10.6.23 Answer 15 
True 
Go back to Question 15 (p. 2328) 
4.5.10.6.24 Answer 14 
True. 
Go back to Question 14 (p. 2328) 
4.5.10.6.25 Answer 13 
False. DUMP is not a possible value for the method attribute of a form element. 
Go back to Question 13 (p. 2328) 
4.5.10.6.26 Answer 12 


True. (See w3schools 7® .) Note, however that the form element will typically have attributes with names 
like name , action , method , id and more instead of being blank as shown in Image 10 (p. 2328) . 
Go back to Question 12 (p. 2328) 


4.5.10.6.27 Answer 11 


True. (See w3schools 7° .) Note that a select element, for example, does have content , consisting of 
option elements, which also have content . 
Go back to Question 11 (p. 2328) 


4.5.10.6.28 Answer 10 


False. While it is common to preselect a radio button from the group, that is not required. 
Go back to Question 10 (p. 2327) 


65http://www.w3schools.com/html/html_forms.asp 
66 http://www.w3schools.com/html/html_forms.asp 
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4.5.10.6.29 Answer 9 
False. A radio button is an input element with an attribute named type that has a value of "radio" 
(See w3schools 7°" .) Typically the group consists of two or more buttons and the user can select only 
one button from the group. The buttons are mutually exclusive. 
Go back to Question 9 (p. 2327) 
4.5.10.6.30 Answer 8 
True. 
Go back to Question 8 (p. 2327) 
4.5.10.6.31 Answer 7 
True. 
Go back to Question 7 (p. 2327) 
4.5.10.6.32 Answer 6 


False. A textbox element is an input element with an attribute named type that has a value of 
"text n 

Go back to Question 6 (p. 2327) 
4.5.10.6.33 Answer 5 


False. The Amazon form shown in Image 1 (p. 2341) displays only five user input elements: 


e Two textboxes 
e Two radio buttons 
e One submit button 


Go back to Question 5 (p. 2327) 


4.5.10.6.34 Answer 4 
True. 

Go back to Question 4 (p. 2327) 
4.5.10.6.35 Answer 3 
True. 

Go back to Question 3 (p. 2327) 
4.5.10.6.36 Answer 2 
True. 

Go back to Question 2 (p. 2326) 
4.5.10.6.37 Answer 1 


True. 
Go back to Question 1 (p. 2326) 


267 http://www.-w3schools.com/html/html_forms.asp 
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4.5.10.7 Images 


This section contains images that may be referred to by more than one question or answer. These images 
may also be helpful as reference material for answering the questions. Other images may be interspersed 
within the questions and answers. 


amazon Your Account | Help 
wee? 


Sign In 
What is your e-mail address? 
My e-mail address is: | 
Do you have an Amazon.com password? 


© No, I am a new customer. 


® Yes, Ihave a password: 
Forgot your password? 


Sign In Help 


Forgot your password? Get password help. 
Has your e-mail address changed? Update it here. 


Conditions of Use Privacy Notice © 1996-2013, Amazon.com, Inc. or its affiliates 
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amazon Your Account | Help 
aE 


Sign In 
What is your e-mail address? 
My e-mail address is: | O O 


Do you have an Amazon.com password? 


© No, I am a new customer. 


® Yes, [have a password: 
Forgot your password? 


| Sign in using our secure server @) 


Sign In Help 
Forgot your password? Get password help. 
Has your e-mail address changed? Update it here. 


Conditions of Use Privacy Notice © 1996-2013, Amazon.com, Inc. or its affiliates 
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amazon Your Account | Help 
aE 


Sign In 


What is your e-mail address? 


My e-mail address is: | 


Do you have an Amazon.com password? 


© No, I am a new customer. 


® Yes, Ihave a password: 
Forgot your password? 


=a ao es ee 
ry 


Sign In Help 
Forgot your password? Get password help. 
Has your e-mail address changed? Update it here. 


Conditions of Use Privacy Notice © 1996-2013, Amazon.com, Inc. or its affiliates 
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Image 1 . The Amazon form. 


amazon Your Account | Help | 
N) 


Sign In 
What is your e-mail address? 
Mye-mailaddressis: — —  ăć 


Do you have an Amazon.com password? 


© No, I am a new customer. 


® Yes, I have a password: | 
Forgot your password? 


(FEE eC EON EN N 
PI 


Sign In Help 


Forgot your password? Get password help. 
Has your e-mail address changed? Update it here. 


Conditions of Use Privacy Notice © 1996-2013, Amazon.com, Inc. or its affiliates 


Table 4.549 


<form name="signIn" method="POST" id="ap_signin_ form" 
novalidate="novalidate" action="https://www.amazon.com/ap/ signin"ğ 


<form name="signIn" method="POST" id="ap signin form" 
novalidate="novalidate" action="https://www.amazon.com/ap/ signin"ğ 


<form name="signIn" method="POST" id="ap signin form" 
novalidate="novalidate" action="https: //www.amazon.com/ap/signin"® 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2337 


Image 2 . Form Element of Amazon.com. 


<form name="signin" method="POST" id="ap signin form" 
novalidate="novalidate" action="https://www.amazon.com/ ap/signin"® 


Table 4.550 


a : 
Safari 


Image 3 . Browser Support for novalidate Attribute. 
Safari 

rx 

x 


Form Element | Purpose 
‘button | Creates buttons 
datalist Specifies list of predefined values 


Creates numerous input types 


Table 4.551 


input 
Element of a selection list 


‘select © | Selection list consisting of options 
Area for text entry 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2338 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


option | Element of a selection list __ __ _ 


Image 4 . Common HTML Form Elements. 


Element of a selection list 
Selection list consisting of options 
Area for text entry 


Table 4.552 
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<!DOCTYPE html> 
<!-- join acc code academy.html --> 
<html> 
<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new_member.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text” name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lLastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text” name="phoneNumber"></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 


</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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I| <!DOCTYPE html> 

2| <!-- join acc code academy.html --> 

3| <html> 

4 <head> 

5| <title>Join Code Academy</title> 

6 <link rel="stylesheet" href="css/css-i.css"> 

7 </head> 

8| <body> 

cy <div class="center"> 

10| <hi>Join ACC Code Academy</hi> 

11| <p>To join ACC Code Academy please enter your information.</p> 
12| <form action="display new_member.jsp" method="post"> 
13| <table class="inline-block"> 

14) <tr><th id="th-idi" colspan="2">Student Information</th></tr> 
15) <tr> 

16 <td>First Name:</td> 

17| <td><input type="text" name="firstName"></td> 
18| </tr> 

19° <tr> 

20, <td>Last Name:</td> 

21) <td><input type="text" name="lastName"></td> 
22| </tr> 

23| <tr> 

24) <td>Your Digits (all 10):</td> 

25, <td><input type="text" name="phoneNumber"></td> 
26 </tr> 

27| <tr> 

28| <td>Skill Level:</td> 

29, <td><select name="skillLevel"> 

30, <option value="beginner">Beginner</option> 
31, <option value="intermediate">Intermediate</option> 
32, <option value="expert">Expert</option> 

33 </select> 

34, </td> 

35 </tr> 

36 <tr> 

37. <td></td> 

38 <td><br><input type="submit" value="Join the College"></td> 
39| </tr> 

40 </table> 

41| </form> 

42| </div> 

43| </body> 

44| </html> 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2341 


<!DOCTYPE html> 
<!-- join acc code academy.html --> 
<html> 
<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-i.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new_member.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text” name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 


</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" value="Join the College"></td> 
<ftr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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Image 5 . Code - join _acc_code_academy.html. 


1 
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<!DOCTYPE html> 
<!-- join acc code _ academy.html --> 
<html> 
<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new_member.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text” name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 


</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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Table 4.553 


Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


Skill Level: 
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Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


wâr i 
ARL | 


[Your Digits (all 10); 5125551234 | 
Skill Level: 


mpe 
. 


yic 
~_7it 
» 

. 
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Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


: 


Informati 


Vic 
~_7it 
» 
. 
. 
. 


Your Digits (all 10): 5125551234 
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Image 6 . Output - join_acc_code_academy.html. 


Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


te) 


Table 4.554 
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1| <!DOCTYPE HTML> 

2| <!-- dis New ~ --> 

3| <%@ page import="java.io.*,java.util.*" $> 

4| <html> 

5| <head> 

6 <title>Display New Member</title> 

7 <link rel="stylesheet" href="css/css-1.css"> 

& </head> 

9 <body> 

10 <$% 

11 // get parameters from the request object 

12 String firstName = request.getParameter("firstName"); 
13 String lastName = request.getParameter ("lastName"); 

14 String phoneNumber = request.getParameter ("phoneNumber") ; 
15) String skillLevel = request.getParameter("skillLevel"); 
16 $> 

17| <div class="center"> 

18| <hi>Thank you for joining ACC Code Academy.</hi> 

19| <h2>This is the information entered:</h2> 

20| <table class="inline-block"> 

21 <tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
22 <tr> 

23 <td>First Name:</td> 

24 <td><%= firstName $></td> 

25 </tr> 

26) <tr> 

27 <td>Last Name:</td> 

28 <td><%= lastName $></td> 

29 </tr> 

30 <tr> 

31 <td>Phone Number:</td> 

32 <td><%= phoneNumber %></td> 

33 </tr> 

34 <tr> 

35 <td>Skill Level:</td> 

36 <td><%= skillLevel %></td> 

37 </tr> 

38| </table> 

39| <p>To add another new member, select the button below.</p> 
40| <form action="join_acc_code_academy.html" method="get"> 


41 <input type="submit" value="Enter Another New Member"> 
42, </form> 

43! <h2>Unsorted Parameter Names</h2> 

44| <table class="inline-block"> 


a <tr><th class="table header" colspan="2">Unsorted Parameters</th></tr> 


46 <3 

47 Enumeration parameterNames = request.getParameterNames(); 
48 while (parameterNames.hasMoreElements()) { 

49 String paramName = (String) parameterNames.nextElement (); 
50 out.print ("<tr><td>" + paramName + "</td>\n"); 

51 String paramValue = request.getParameter (paramName) ; 

52 out.println("<td> " + paramValue + "</td></tr>\n"); 

53 } 

54 $> 


55| </table> 
56 <h2>Sorted Parameter Names</h2> 
57| <table class="inline-block"> 


a <tr><th_ class="table header" colspan="2">Sorted Parameters</th></tr> 
59) <$% 

60 Enumeration parameterNames2 = request.getParameterNames(); 
61 List<String> list = Collections. list(parameterNames2) ; 

62 Collections. sort(list); 

63 for (String valueName : list) { 

64 out.print ("<tr><td>" + valueName + "</td>\n"); 

65 String paramValue = request.getParameter (valueName) ; 

66 out.printin("<td> " + paramValue + "</td></tr>\n"); 

67 } 

68 $> 

69| </table> 

70| </div> 

71| </body> 

72| </html> 
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1| <!DOCTYPE HTML> 

2| <!-- dis New ~ --> 

3| <%@ page import="java.io.*,java.util.*" $> 

4| <html> 

5| <head> 

6 <title>Display New Member</title> 

7 <link rel="stylesheet" href="css/css-1.css"> 

& </head> 

9 <body> 

10 <$% 

11 // get parameters from the request object 

12 String firstName = request.getParameter("firstName"); 
13 String lastName = request.getParameter ("lastName"); 

14 String phoneNumber = request.getParameter ("phoneNumber") ; 
15) String skillLevel = request.getParameter("skillLevel"); 
16 $> 

17| <div class="center"> 

18| <hi>Thank you for joining ACC Code Academy.</hi> 

19| <h2>This is the information entered:</h2> 

20| <table class="inline-block"> 

21 <tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
22 <tr> 

23 <td>First Name:</td> 

24 <td><%= firstName $></td> 

25 </tr> 

26) <tr> 

27 <td>Last Name:</td> 

28 <td><%= lastName $></td> 

29 </tr> 

30 <tr> 

31 <td>Phone Number:</td> 

32 <td><%= phoneNumber %></td> 

33 </tr> 

34 <tr> 

35 <td>Skill Level:</td> 

36 <td><%= skillLevel %></td> 

37 </tr> 

38| </table> 

39| <p>To add another new member, select the button below.</p> 
40| <form action="join_acc_code_academy.html" method="get"> 


41 <input type="submit" value="Enter Another New Member"> 
42, </form> 

43! <h2>Unsorted Parameter Names</h2> 

44| <table class="inline-block"> 


a <tr><th class="table header" colspan="2">Unsorted Parameters</th></tr> 


46 <3 

47 Enumeration parameterNames = request.getParameterNames(); 
48 while (parameterNames.hasMoreElements()) { 

49 String paramName = (String) parameterNames.nextElement (); 
50 out.print ("<tr><td>" + paramName + "</td>\n"); 

51 String paramValue = request.getParameter (paramName) ; 

52 out.println("<td> " + paramValue + "</td></tr>\n"); 

53 } 

54 $> 


55| </table> 
56 <h2>Sorted Parameter Names</h2> 
57| <table class="inline-block"> 


a <tr><th_ class="table header" colspan="2">Sorted Parameters</th></tr> 
59) <$% 

60 Enumeration parameterNames2 = request.getParameterNames(); 
61 List<String> list = Collections. list(parameterNames2) ; 

62 Collections. sort(list); 

63 for (String valueName : list) { 

64 out.print ("<tr><td>" + valueName + "</td>\n"); 

65 String paramValue = request.getParameter (valueName) ; 

66 out.printin("<td> " + paramValue + "</td></tr>\n"); 

67 } 

68 $> 

69| </table> 

70| </div> 

71| </body> 

72| </html> 
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1| <!DOCTYPE HTML> 

2| <!-- dis New ~ --> 

3| <%@ page import="java.io.*,java.util.*" $> 

4| <html> 

5| <head> 

6 <title>Display New Member</title> 

7 <link rel="stylesheet" href="css/css-1.css"> 

& </head> 

9 <body> 

10 <$% 

11 // get parameters from the request object 

12 String firstName = request.getParameter("firstName"); 
13 String lastName = request.getParameter ("lastName"); 

14 String phoneNumber = request.getParameter ("phoneNumber") ; 
15) String skillLevel = request.getParameter("skillLevel"); 
16 $> 

17| <div class="center"> 

18| <hi>Thank you for joining ACC Code Academy.</hi> 

19| <h2>This is the information entered:</h2> 

20| <table class="inline-block"> 

21 <tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
22 <tr> 

23 <td>First Name:</td> 

24 <td><%= firstName $></td> 

25 </tr> 

26) <tr> 

27 <td>Last Name:</td> 

28 <td><%= lastName $></td> 

29 </tr> 

30 <tr> 

31 <td>Phone Number:</td> 

32 <td><%= phoneNumber %></td> 

33 </tr> 

34 <tr> 

35 <td>Skill Level:</td> 

36 <td><%= skillLevel %></td> 

37 </tr> 

38| </table> 

39| <p>To add another new member, select the button below.</p> 
40| <form action="join_acc_code_academy.html" method="get"> 


41 <input type="submit" value="Enter Another New Member"> 
42, </form> 

43! <h2>Unsorted Parameter Names</h2> 

44| <table class="inline-block"> 


a <tr><th class="table header" colspan="2">Unsorted Parameters</th></tr> 


46 <3 

47 Enumeration parameterNames = request.getParameterNames(); 
48 while (parameterNames.hasMoreElements()) { 

49 String paramName = (String) parameterNames.nextElement (); 
50 out.print ("<tr><td>" + paramName + "</td>\n"); 

51 String paramValue = request.getParameter (paramName) ; 

52 out.println("<td> " + paramValue + "</td></tr>\n"); 

53 } 

54 $> 


55| </table> 
56 <h2>Sorted Parameter Names</h2> 
57| <table class="inline-block"> 


a <tr><th_ class="table header" colspan="2">Sorted Parameters</th></tr> 
59) <$% 

60 Enumeration parameterNames2 = request.getParameterNames(); 
61 List<String> list = Collections. list(parameterNames2) ; 

62 Collections. sort(list); 

63 for (String valueName : list) { 

64 out.print ("<tr><td>" + valueName + "</td>\n"); 

65 String paramValue = request.getParameter (valueName) ; 

66 out.printin("<td> " + paramValue + "</td></tr>\n"); 

67 } 

68 $> 

69| </table> 

70| </div> 

71| </body> 

72| </html> 
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Image 7 . Code - display _new_member.jsp. 
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<!DOCTYPE HTML> 
-- display _n 
<%@ page import=" 
<html> 
<head> 
<title>Display New Member</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<3 


java.io.*,java.util.*" $> 


// get parameters from the request object 
String firstName = request.getParameter("firstName"); 
String lastName = request.getParameter ("lastName"); 
String phoneNumber = request.getParameter ("phoneNumber"); 
String skillLevel = request.getParameter("skillLevel"); 
$> 
<div class="center"> 
<hi>Thank you for joining ACC Code Academy.</hi> 
<h2>This is the information entered:</h2> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
<tr> 
<td>First Name:</td> 
<td><%= firstName %></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><$= lastName %></td> 
</tr> 
<tr> 
<td>Phone Number:</td> 
<td><%= phoneNumber %></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><%= skillLevel %></td> 
</tr> 
</table> 
<p>To add another new member, select the button below.</p> 
<form action="join_acc_code_academy.html" method="get"> 
<input type="submit" value="Enter Another New Member"> 
</form> 
<h2>Unsorted Parameter Names</h2> 
<table class="inline-block"> 


<tr><th class="table header" colspan="2">Unsorted Parameters</th></tr> 


<$% 
Enumeration parameterNames = request.getParameterNames (); 
while (parameterNames.hasMoreElements()) { 
String paramName = (String) parameterNames.nextElement (); 
out.print ("<tr><td>" + paramName + "</td>\n"); 
String paramValue = request.qetParameter (paramName) ; 
out.println("<td> " + paramValue + "</td></tr>\n"); 
} 
=> 
</table> 


<h2>Sorted Parameter Names</h2> 
<table class="inline-block"> 
<tr><th class="table header" colspan="2">Sorted Parameters</th></tr> 
<$ 
Enumeration parameterNames2 = request.getParameterNames (); 
List<String> list = Collections.list(parameterNames2); 
Collections.sort(list); 
for (String valueName : list) { 
out.print ("<tr><td>" + valueName + "</td>\n"); 
String paramValue = request.getParameter (valueName) ; 
out.printin("<td> " + paramValue + "</td></tr>\n"); 


+> 
</table> 
</div> 
</body> 
</nt 
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Table 4.555 
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Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 


First Name: 


Last Name: Gosling 
Phone Number:|/5 12555123 
Skill Level: expert 


To add another new member, select the button below. 


Enter Another New Member 


Unsorted Parameter Names 


[ Unsorted Parameters | 


Sorted Parameter Names 
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Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 


First Name: 


Last Name: Gosling 
Phone Number:|/5 12555123 
Skill Level: expert 


To add another new member, select the button below. 


Enter Another New Member 


Unsorted Parameter Names 


[ Unsorted Parameters | 


Sorted Parameter Names 
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Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 


First Name: 


Last Name: Gosling 
Phone Number:|/5 12555123 
Skill Level: expert 


To add another new member, select the button below. 


Enter Another New Member 


Unsorted Parameter Names 


[ Unsorted Parameters | 


Sorted Parameter Names 
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a Image 8 . Output - display _new_member.jsp. = 
Thank you for joining ACC 
Code Academy. 
This is the information entered: 


Information Entered 


First Name: James 


Last Name: Gosling 
hone Number:|/512555123 
Skill Level: expert 


To add another new member, select the button below. 


Enter Another New Member 


Unsorted Parameter Names 


lastName Gosling 
skillLevel expert 


[phoneNumber]5 12555123 


firstName 


Sorted Parameter Names 


firstName 


lastName Gosling 


skillLevel 
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Table 4.556 

40. | Table column 2 established by element "th" has no cells beginning in it. P2Od="Ger"> 

41. | From line 39, column 12; to line 39, column 48 r New Member"> 

42, (Rule Category: All Other) 

aai | 

44. (Alt-Enter shows hints) 

Q <tr><th class="table header” colspan="2">Unsorted Parameters</th></tr> 
40 | Table column 2 established by element "th" has no cells beginning in it. P2Oa="Ger"> 

41 |From line 39, column 12; to line 39, column 48 r New Member"> 
42 | (Rule Category: All Other) 
43 wig 
44 (Alt-Enter shows hints) 

@ <tr><th class="table header" colspan="2">Unsorted Parameters</th></tr> 
40 [Table column 2 established by element "th" has no cells beginning in it. PROd="ger"> 
41 |From line 39, column 12; to line 39, column 48 New Member"> 
42 |(Rule Category: All Other) 
43 ae 
44 (Alt-Enter shows hints) 

Q@ <tr><th class="table header" colspan="2">Unsorted Parameters</th></tr> 
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Image 9 . Code - Incorrect Advisory.html. 


40 |Table column 2 established by element "th" has no cells beginning in it. P2Od="ser"> 
41 | From line 39, column 12; to line 39, column 48 New Member"> 
42 | (Rule Category: All Other) 
43) |" 
44 | (Alt-Enter shows hints) 
ey <tr><th class="table header" colspan="2">Unsorted Parameters</th></tr> 


Table 4.557 


JSP Tag JSP Name 
Scriptlet Insert Java statements 
Display string value 


Set whole page conditions 
Not returned to browser 
Declare instance variables or methods 
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<% %> 
<%= _%> 
<%@ %> 
<%-- --%> 
<%! __%> 


<%@ %> 
<%-- --%> 


Image 11 . JSP Tags 


<%= _%> 
<%! __%> 


Table 4.558 


4.5.10.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4350r: Review 
e File: Java4350r.htm 

e Published: 12/08/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 
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I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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4.5.11.1 Table of Contents 
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4.5.11.2 Preface 


This module is one in a collection of modules designed for teaching ITSE 2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

In previous modules, JSP fundamentals and form processing were addressed. This module will investigate 
the use of Java classes in combination with JSP. 


4.5.11.2.1 Viewing tip 


I recommend that students open another copy of this module in a separate browser window and use the 
following links to easily find and view the Images while you are reading about them. 


4.5.11.2.1.1 Images 


Image 1 (p. 


eoeoeeee8e8 © 
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2380) . Code - join_acc_code_academy.html 
2384) . Output - join _acc_code_academy.html 
2391) . Code - display_new_member_with_classes.jsp 


. Output - display_new_member_with_classes.jsp 
. Code - StudentFile.java 


) 
) 
) 
. 2399) . Code - Student.java 
) 
) 


. 2406) . StudentInfo.txt 


268 This content is available online at <http://cnx.org/content /m48087/1.5/>. 
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e Image 8 (p. 2408) . Code - Simple Variables Used 
e Image 9 (p. 2409) . Incorrect. Warnings 


4.5.11.3 Preview 


In this module, we enhance the form processing pages from the previous module. The same concept of passing 
form data from one page to another is used. However, in this module, objects will be employed to provide 
greater separation of functional elements. Even though the form processing examples in the previous module 
successfully demonstrated passing and processing of form data, more sophisticated solutions usually involve 
custom classes. Familiarity with object-oriented programming concepts will enhance student understanding 
of this material. 


4.5.11.4 General background information 


Object-orientation (OO) was perhaps the most revolutionary movement to emerge in software development 
during the 1980s and 1990s. Prior to the adoption of OO, the vast majority of software was developed using 
structured (procedural) coding methodologies. With structured coding, the design focus is on the structure 
of the program consisting of procedures, functions, and blocks of code. With OO, the center of design is the 
object. While structured or procedural programming dominated software development prior to the 1990s, 
OO has since become the de facto standard. And, to further emphasize its dominance, consider the WWW 
client which is built on the BOM and DOM previously discussed. 


4.5.11.5 Discussion 


Recall from previous Java informational sources that classes are most commonly thought of as blueprints 
for concrete implementations. To use a physical building analogy, the blueprint in the architect’s office 
represents the class and the individual building represents the object. When an object is created from a 
class the process is known as instantiation; an instance of the class is created in the form of an object. In 
Java terms, the word class can also apply to bytecode files with the .class extension which are created from 
java files containing source code. If a .java file contains more than one class, a .class file is created for each 
class in the .java source code. Files with the .class extension contain Java bytecode which is executed in 
real-time by the Java Virtual Machine (JVM). 

While most references to classes in this module refer to Java classes, recall from the HTML and CSS 
Fundamentals module that CSS also have class selectors. The CSS class selectors allow web page designers 
to apply CSS selectors to multiple elements. This benefit is distinguished from that of CSS id selectors which 
are limited to only one application per page. CSS class selectors are preceded by a period in the CSS file 
and are applied to HTML elements using class="selector_name" syntax (see line 38 in Image 1 (p. 2380) ). 

Objects, in their simplest form, consists of only 2 things: functionality and data. In this module, both 
characteristics of objects, functionality and data, are used to demonstrate the organizational benefits of OO. 
Object functions (or methods as they are known in Java) will be used to access and modify the data stored in 
objects. These methods are externally exposed (outside of the class) while the object data is hidden within 
the class and is accessible only by other class members. This strategy of open methods and closed data is 
the common design of OO. It offers protection of the data while enabling appropriate levels of data access 
through methods. 


4,5.11.5.1 Code - join _acc_code_academy.html 


The version of the join_acc_code_academy-html file used in this module is almost identical to that reviewed 
in the previous module. It is shown again here as a convenience. Lines 12 and 38 of Image 1 (p. 2380) high- 
light the changes. The action of the form has been changed to call display_new_member_ with_classes.jsp 
on line 12. On line 38, the CSS class table header has been added to the submit button to change its color 
to coral (see css-l.css). If there are other questions about this page, review the discussion in the previous 
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module. Image 2 (p. 2384) displays the HTML output of the code in Image 1 (p. 2380) . Notice the button 
color has been changed from the default to coral as specified in the CSS file. 


4.5.11.5.2 Code - display _new_message_with_classes.jsp (part 1 of 2) 


Much of the file in Image 3 (p. 2391) is like that reviewed in the previous module. Like the previ- 
ous version, the code listing in Image 3 (p. 2391) processes form submission data. Naturally, the page 
could be called from any other page within the web application. In this module, it is again called from 
join_acc_code_academy.html. 

The first change to notice is on line 3 of Image 3 (p. 2391) . Two new packages, college and data, are 
imported for use in the page. The next changes are located on lines 17 and 18. On line 17, a servlet context 
is obtained which, according to Oracle, is the "set of methods that a servlet uses to communicate with its 
servlet container." See the link in supplemental reading near the end of the module for more information on 
servlet contexts. 

In JSP terms, a context is equivalent to a web application. Therefore, based on the Oracle definition, 
the servlet context supplies methods that the web application can use to communicate with the servlet 
container. Tomcat is the servlet container (specifically the Catalina component of Tomcat) used in the 
JSP portion of this course. There are almost 30 methods provided by the servlet context object. In this 
example, the getRealPath method of the servlet context is used to obtain a path and file name to which 
student information is written. The path and file name combination is returned in a form appropriate to 
the operating system on which the servlet container (Tomcat) is running. In the case of line 18 of Image 
3 (p. 2391) , the path is set to the WEB-INF directory under the PROJECT-DIR$/build/web directory. 
PROJECT-DIR$ is a variable used to identify the top-level directory of the current project. The file name is 
set to StudentInfo.txt. On line 20 of Image 3 (p. 2391) an important action occurs. On this line a Student 
object is instantiated by calling the constructor on lines 15-22 of Image 4 (p. 2399) . Image 4 (p. 2399) is 
the specification and implementation file for the Student class. Let’s take a break from our discussion of the 
form processor to consider the class files. 


4.5.11.5.3 Code - Student.java 


This file is a typical example of Java class file. It contains 4 private variables on lines 4-7 of Image 4 (p. 
2399) that are recognized from the previous pages covered. The constructor on lines 15-22 is called from line 
20 of Image 3 (p. 2391) to instantiate a Student object. The remaining portions of the class file consists of 
getter (accessor) and setter (mutator) methods for each of the data elements declared on lines 4-7. Note that 
all of the methods have public access specified. And, the getter methods return String types and the setter 
methods have void return types. If there are questions about the code in these standard Java segments, 
review earlier material in this course and other foundational Java course content. 


4.5.11.5.4 Code - StudentFile.java 


The class file in Image 6 (p. 2404) is provided as an example of the modularity that OO supplies. It consists 
of only 14 lines of code and could have easily been included in the calling page. However, by extracting this 
specific functionality, developers can dedicate an object to just student file writing operations. The object 
(or functionality in this static case) can now readily be reused throughout the application as opposed to code 
on the page which would have to be repeated whenever reuse was desired. Furthermore, notice that the add 
method is defined as static on line 6 of Image 6 (p. 2404) . By defining the method as static, the method 
can be called directly without the overhead of object instantiation. In the case of the StudentFile class, only 
class functionality, and not object data, is used. 

When a class only contains functionality, static methods are the natural OO technique for the class. On 
line 8 of Image 6 (p. 2404) a file object is created using the filePath that was passed into the add method 
via a parameter. On lines 9-11 a Print Writer object is created using a FileWriter object as a parameter. 
The out Writer object instantiated from the Print Writer class is then used to write the 4 data items of the 
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Student object to the file. Notice the student information is entered in Image 2 (p. 2384) , displayed in 
Image 5 (p. 2403) , written to the file in Image 6 (p. 2404) , and displayed in the StudentInfo.txt as shown 
in Image 7 (p. 2406) . 


4.5.11.5.5 Code - display _new_message_ with _classes.jsp (part 2 of 2) 


Now back to the code in Image 3 (p. 2391) . Let’s resume the discussion at line 20 where the Student, object 
is created. That object is populated with the data entered by the user which (like before) was extracted from 
the Request object. The object is then used as a parameter in the call to the add method of the StudentFile 
class along with the filePath set on line 18 of Image 3 (p. 2391) . Notice that an object of StudentFile type 
is not created nor is it required. Since the add method is declared as static on line 6 of Image 6 (p. 2404) 
, an object is not required to use the method. Instead of an object name used with the call to add, the 
StudentFile class name is used to qualify the add method. Observe in Image 7 (p. 2406) the filePath of the 
StudentInfo.txt file is highlighted. Also, the contents of the file, shown in Notepad, correspond to the data 
entered by the user in Image 2 (p. 2384) . 

The only new concepts remaining on the page and in this module are the method calls used to output 
the data in the HTML table. Recall that in the non-class version of this code example from the previous 
module, simple variables were used to populate the table. For review, see lines 24, 28, 32, and 36 of Image 
8 (p. 2408) . However, in this version which uses classes, lines 31, 35, 39, and 43 of Image 3 (p. 2391) show 
the use of method calls to populate the table. Each of the accessor methods of the Student object is called 
to fill-in the HTML table information. 


4.5.11.5.6 Incorrect Warnings 


Don’t be alarmed when you encounter warnings or errors that appear to be incorrect; sometimes they are. 
For example, notice the warning produced on line 13 of Image 9 (p. 2409) . It indicates that class inline-block 
could not be found. However, when the page is executed, that class is applied as are all of the other CSS 
selectors specified by css-1.css. Even though the CSS is being applied the IDE still issues the warnings. This 
is a defect in the IDE. It can become out of sync with references (especially if it remains open for days at a 
time). Usually, errant warnings like these disappear when NetBeans is closed and reopened. Cleaning and 
rebuilding the project can also restore partially compromised references. 


4.5.11.6 Homework assignment 


See the JSP section in Blackboard for all JSP homework assignments. 


4.5.11.6.1 Supplemental Reading 

http://docs.oracle.com /cd/E17802_01/products/products/servlet /2.5/docs/servlet-2_5- 
mr2/javax/servlet /ServletContext.html °° 

4.5.11.7 Summary 


OO is currently the dominate methodology of software development and that shows no signs of abating. 
Just as OO is relevant in desktop applications, it is equally powerful and widespread in web-based solutions. 
This module covered the use of Java classes and objects in the JSP context. 


4.5.11.8 What’s next? 


There are a number of ways to store user data. In the remaining modules, two of those techniques are 
discussed. Cookies and sessions are reviewed from a JSP perspective. 


69http://docs.oracle.com/cd/E17802_01/products/products/servlet/2.5/docs/servlet-2__5-mr2/javax/servlet /ServletContext.html 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2369 


4.5.11.9 Images 
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<!DOCTYPE html> 


<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new member with_classes.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="table header" 
value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 
<!-- join acc code academy.html --> 
<html> 
<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new member with_classes.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</txr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="table header" 
value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2372 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


wo ont nD WO & & DY 


moe h em ew WO Www WwW WwW WwW WN HH DY YH DY YY N PRP RP RP RP RP Pr be 
Or WON FP OW OHA OF WKY FP OW DDH HF WNP OF WY MO NH OO fF WY NY PO 


2373 


<!DOCTYPE html> 
<!-- join acc code academy.html --> 
<html> 
<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new member with_classes.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</txr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="table header" 
value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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Image 1 . Code - join _acc_code_academy.html 
1| <!DOCTYPE html> 
2 <!-- join acc code academy.html --> 
3| <html> 
4 <head> 
5 <title>Join Code Academy</title> 
6 <link rel="stylesheet" href="css/css-1.css"> 
7| </head> 
8 <body> 
9| <div class="center"> 
10 <hi>Join ACC Code Academy</hi> 
11 <p>To join ACC Code Academy please enter your information.</p> 
12| <form action="display new_member with_classes.jsp" method="post"> 
13 <table class="inline-block"> 
14 <tr><th id="th-idi" colspan="2">Student Information</th></tr> 
15 <tr> 
16 <td>First Name:</td> 
17 <td><input type="text" name="firstName"></td> 
18 </tr> 
19 <tz> 
20 <td>Last Name:</td> 
21 <td><input type="text" name="lastName"></td> 
22 </tr> 
23 <tr> 
24 <td>Your Digits (all 10):</td> 
25 <td><input type="text" name="phoneNumber"></td> 
26 </tr> 
27 <tr> 
28 <td>Skill Level:</td> 
29 <td><select name="skillLevel"> 
30 <option value="beginner">Beginner</option> 
31 <option value="intermediate">Intermediate</option> 
32 <option value="expert">Expert</option> 
33 </select> 
34 </td> 
35 </tr> 
36 <tr> 
37 <td></td> 
38 <td><br><input type="submit" class="table header" 
39 value="Join the College"></td> 
40 </tr> 
41| </table> 
42, </form> 
43, </div> 
44. </body> 
45) </html> 
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Table 4.559 


Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


— 
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Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


_ D 
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Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


Skill Level: oly 


| mna | 
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Image 2 . Output - join_acc_code_academy.html 


Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


5125556789 | 
Saint [eet o 


| nen 


Table 4.560 
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<!DOCTYPE html> 


<!-- display new student with c 
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<%@ page import="college.*, data.*, java.io.*, java.util.*" %> 
<html> 
<head> 
<title>Display New Student with Classes</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<$% 
// get parameters from the Request object 
String firstName = request.getParameter ("firstName"); 
String lastName = request.getParameter ("lastName"); 
String phoneNumber = request.getParameter ("phoneNumber"); 
String skillLevel = request.getParameter("skillLevel"); 
// set filePath to a relative file name 
ServletContext sc = this.getServletContext(); 
String filePath = sc.getRealPath ("/WEB-INF/Studentinfo.txt"); 
// use custom Java objects to write to file 
Student student = new Student (firstName, lastName, 
phoneNumber, skillLevel); 
StudentFile.add(student, filePath); 
$> 
<div class="center"> 
<h1>Thank you for joining ACC Code Academy.</h1> 
<h2>This is the information entered:</h2> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
<tr> 
<td>First Name:</td> 
<td><$= student.getFirstName() ></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><%= student.getLastName() %></td> 
</tr> 
<tr> 
<td>Phone Number:</td> 
<td><$= student.getPhoneNumber() $></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><%$= student.getSkillLevel() %></td> 
</tr> 
</table> 
<p>To add another new student, select the button below.</p> 
<form action="join_acc_ code academy.html" method="get"> 
<input type="submit" class="table header" 
value="Enter Another New Student"> 
</form> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 


<!-- display new student with c 
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<%@ page import="college.*, data.*, java.io.*, java.util.*" %> 
<html> 
<head> 
<title>Display New Student with Classes</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<$% 
// get parameters from the Request object 
String firstName = request.getParameter ("firstName"); 
String lastName = request.getParameter ("lastName"); 
String phoneNumber = request.getParameter ("phoneNumber"); 
String skillLevel = request.getParameter("skillLevel"); 
// set filePath to a relative file name 
ServletContext sc = this.getServletContext(); 
String filePath = sc.getRealPath ("/WEB-INF/Studentinfo.txt"); 
// use custom Java objects to write to file 
Student student = new Student (firstName, lastName, 
phoneNumber, skillLevel); 
StudentFile.add(student, filePath); 
$> 
<div class="center"> 
<h1>Thank you for joining ACC Code Academy.</h1> 
<h2>This is the information entered:</h2> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
<tr> 
<td>First Name:</td> 
<td><$= student.getFirstName() ></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><%= student.getLastName() %></td> 
</tr> 
<tr> 
<td>Phone Number:</td> 
<td><$= student.getPhoneNumber() $></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><%$= student.getSkillLevel() %></td> 
</tr> 
</table> 
<p>To add another new student, select the button below.</p> 
<form action="join_acc_ code academy.html" method="get"> 
<input type="submit" class="table header" 
value="Enter Another New Student"> 
</form> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 


<!-- display new student with c 


ia) 
w 
* u 
& 
m 
to 
4 
Q 
3 
|] 
i 
a 


<%@ page import="college.*, data.*, java.io.*, java.util.*" %> 
<html> 
<head> 
<title>Display New Student with Classes</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<$% 
// get parameters from the Request object 
String firstName = request.getParameter ("firstName"); 
String lastName = request.getParameter ("lastName"); 
String phoneNumber = request.getParameter ("phoneNumber"); 
String skillLevel = request.getParameter("skillLevel"); 
// set filePath to a relative file name 
ServletContext sc = this.getServletContext(); 
String filePath = sc.getRealPath ("/WEB-INF/Studentinfo.txt"); 
// use custom Java objects to write to file 
Student student = new Student (firstName, lastName, 
phoneNumber, skillLevel); 
StudentFile.add(student, filePath); 
$> 
<div class="center"> 
<h1>Thank you for joining ACC Code Academy.</h1> 
<h2>This is the information entered:</h2> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
<tr> 
<td>First Name:</td> 
<td><$= student.getFirstName() ></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><%= student.getLastName() %></td> 
</tr> 
<tr> 
<td>Phone Number:</td> 
<td><$= student.getPhoneNumber() $></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><%$= student.getSkillLevel() %></td> 
</tr> 
</table> 
<p>To add another new student, select the button below.</p> 
<form action="join_acc_ code academy.html" method="get"> 
<input type="submit" class="table header" 
value="Enter Another New Student"> 
</form> 
</div> 
</body> 
</html> 
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Image 3 . Code - display _new_member_with_classes.jsp 
1} <!DOCTYPE html> 
2 ! 7 ses.jsp --> 
3 java.io.*, java.util.*" %> 
4| <html> 
5| <head> 
6 <title>Display New Student with Classes</title> 
7 <link rel="stylesheet" href="css/css-1.css"> 
&| </head> 
9| <body> 
10 <$% 
11 // get parameters from the Request object 
12 String firstName = request.getParameter ("firstName"); 
13 String lastName = request.getParameter ("lastName"); 
14 String phoneNumber = request.getParameter ("phoneNumber"); 
ws) String skillLevel = request.getParameter("skillLevel"); 
16 // set filePath to a relative file name 
17 ServletContext sc = this.getServletContext(); 
18 String filePath = sc.getRealPath ("/WEB-INF/Studentinfo.txt"); 
19 // use custom Java objects to write to file 
20 Student student = new Student (firstName, lastName, 
21 phoneNumber, skillLevel); 
22 StudentFile.add(student, filePath); 
23 $> 
24| <div class="center"> 
25| <hi>Thank you for joining ACC Code Academy.</hi> 
26| <h2>This is the information entered:</h2> 
27| <table class="inline-block"> 
28 <tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
29 <tr> 
30 <td>First Name:</td> 
31 <td><%$= student.getFirstName() %></td> 
32 </tr> 
33 <tr> 
34 <td>Last Name:</td> 
35 <td><$= student.getLastName() %></td> 
36 </tr> 
37 <tr> 
38 <td>Phone Number:</td> 
39 <td><$= student.getPhoneNumber() ></td> 
40 </tr> 
41 <tr> 
42 <td>Skill Level:</td> 
43 <td><%$= student.getSkillLevel() %></td> 
44 </tr> 
45| </table> 
46| <p>To add another new student, select the button below.</p> 
47\- <form action="join_acc code academy.html" method="get"> 
48 <input type="submit" class="table header" 
49 value="Enter Another New Student"> 
50|" </form> 
51) </div> 
52| </body> 
53| </ 


html> 
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package college; 
public class Student 
{ 
private String firstName; 
private String lastName; 
private String phoneNumber; 
private String skillLevel; 
public Student () 
{ 
firstName = ""; 
lastName = ""; 
phoneNumber = ""; 
skillLevel = ""; 
} 
public Student (String firstName, String lastName, 
String phoneNumber, String skillLevel) 


{ 
this.firstName = firstName; 
this.lastName = lastName; 
this.phoneNumber = phoneNumber; 
this.skillLevel = skillLevel; 

} 

public void setPirstName (String firstName) 

{ 


this.firstName = firstName; 
} 
public String getFirstName () 
{ 
return firstName; 
} 
public void setLastName (String lastName) 
{ 
this.lastName = lastName; 


} 
public String getLastName () 
{ 
return lastName; 
} 


public void setPhoneNumber (String phoneNumber) 
{ 
this.phoneNumber = phoneNumber; 


} 
public String getPhoneNumber () 
{ 
return phoneNumber; 
} 
public void setSkillLevel (String skillLevel) 
{ 
this.skillLevel = skillLevel; 
} 
public String getSkillLevel () 
{ 
return skillLevel; 
} 
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CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


package college; 
public class Student 
{ 
private String firstName; 
private String lastName; 
private String phoneNumber; 
private String skillLevel; 
public Student () 
{ 
firstName = ""; 
lastName = ""; 
phoneNumber = ""; 
skillLevel = ""; 
} 
public Student (String firstName, String lastName, 
String phoneNumber, String skillLevel) 


{ 
this.firstName = firstName; 
this.lastName = lastName; 
this.phoneNumber = phoneNumber; 
this.skillLevel = skillLevel; 

} 

public void setPirstName (String firstName) 

{ 


this.firstName = firstName; 
} 
public String getFirstName () 
{ 
return firstName; 
} 
public void setLastName (String lastName) 
{ 
this.lastName = lastName; 


} 
public String getLastName () 
{ 
return lastName; 
} 


public void setPhoneNumber (String phoneNumber) 
{ 
this.phoneNumber = phoneNumber; 


} 
public String getPhoneNumber () 
{ 
return phoneNumber; 
} 
public void setSkillLevel (String skillLevel) 
{ 
this.skillLevel = skillLevel; 
} 
public String getSkillLevel () 
{ 
return skillLevel; 
} 
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package college; 
public class Student 
{ 
private String firstName; 
private String lastName; 
private String phoneNumber; 
private String skillLevel; 
public Student () 
{ 
firstName = ""; 
lastName = ""; 
phoneNumber = ""; 
skillLevel = ""; 
} 
public Student (String firstName, String lastName, 
String phoneNumber, String skillLevel) 


{ 
this.firstName = firstName; 
this.lastName = lastName; 
this.phoneNumber = phoneNumber; 
this.skillLevel = skillLevel; 

} 

public void setPirstName (String firstName) 

{ 


this.firstName = firstName; 
} 
public String getFirstName () 
{ 
return firstName; 
} 
public void setLastName (String lastName) 
{ 
this.lastName = lastName; 


} 
public String getLastName () 
{ 
return lastName; 
} 


public void setPhoneNumber (String phoneNumber) 
{ 
this.phoneNumber = phoneNumber; 


} 
public String getPhoneNumber () 
{ 
return phoneNumber; 
} 
public void setSkillLevel (String skillLevel) 
{ 
this.skillLevel = skillLevel; 
} 
public String getSkillLevel () 
{ 
return skillLevel; 
} 
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Image 4 . Code - Student.java 
[ 1| package college; ~ 
2| public class Student 
3| í 
4 private String firstName; 
5 private String lastName; 
6 private String phoneNumber; 
7 private String skillLevel; 
8 public Student () 
9 { 
10 firstName = ""; 
E lastName = ""; 
12 phoneNumber = ""; 
13 skillLevel = ""; 
14 } 
15 public Student (String firstName, String lastName, 
16 String phoneNumber, String skillLevel) 
17 { 
18 this.firstName = firstName; 
19 this.lastName = lastName; 
20 this.phoneNumber = phoneNumber; 
21 this.skillLevel = skillLevel; 
22 } 
23 public void setFirstName (String firstName) 
24 { 
25 this.firstName = firstName; 
26 } 
27 public String getFirstName () 
28 { 
29 return firstName; 
30 } 
Eil public void setLastName (String lastName) 
32 { 
33 this.lastName = lastName; 
34 } 
35 public String getLastName () 
36 { 
37 return lastName; 
38 } 
39 public void setPhoneNumber (String phoneNumber) 
40 { 
41 this.phoneNumber = phoneNumber; 
42 } 
43 public String getPhoneNumber () 
44 { 
45 return phoneNumber; 
46 } 
47 public void setSkillLevel (String skillLevel) 
48 { 
49 this.skillLevel = skillLevel; 
50 } 
51 public String getSkillLevel() 
52 { 
53 return skillLevel; 
54 } 
SSj } : ` 
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Table 4.562 


Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 
First Name: Edsger 
Last Name: Dijkstra 


Phone Number:|/5 12555678 
Skill Level: expert 


To add another new student, select the button below. 
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Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 


Phone Number://512555678 


Skill Level: exp 


To add another new student, select the button below. 


i 
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Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 


Phone Number://512555678 


Skill Level: exp 


To add another new student, select the button below. 
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Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 


Phone Number:|/5 125556789 
Skill Level: expert 


To add another new student, select the button below. 


Table 4.563 


1|! package data; 

2| import java.io.*; 

3! import college.Student; 

4 public class StudentFile 

5| { 

6 public static void add(Student student, String filePath) throws IOException 
7, í 

8 File file = new File(filePath) ; 


9 try (PrintWriter outWriter = new PrintWriter(new FileWriter (file, true))) { 
10 outWriter.printin(student.getLastName()+ "|" + student.getFirstName() + 
11 "|" + student.getPhoneNumber() + "|" + student.getSkillLevel()); 
12 } 

13| } 

14) } 
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package data; 
import java.io.*; 
import college.Student; 
public class StudentFile 
{ 
public static void add (Student student, String filePath) throws IOException 
{ 
File file = new File(filePath) ; 
try (PrintWriter outWriter = new PrintWriter(new FileWriter (file, true))) { 
outWriter.printin(student.getLastName()+ "|" + student.getFirstName() + 
"|" + student.getPhoneNumber() + "|" + student.getSkillLevel()); 


package data; 
import java.io.*; 
import college.Student; 
public class StudentFile 
{ 
public static void add(Student student, String filePath) throws IOException 
{ 
File file = new File (filePath); 
try (PrintWriter outWriter = new PrintWriter (new FileWriter (file, true))) { 
outWriter.printin(student.getLastName()+ "|" + student.getFirstName() + 
"|" + student.getPhoneNumber() + "|" + student.getSkillLevel()); 
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Image 6 . Code - StudentFile.java 


1 
2 
3 
4 
5 
6 
7 
e 
9 


10 
alal 
12 
13 
14 


package data; 
import java.io.*; 
import college.Student; 
public class StudentFile 
{ 
public static void add (Student student, String filePath) throws IOException 
{ 
File file = new File(filePath) ; 
try (PrintWriter outWriter = new PrintWriter(new FileWriter(file, true))) i 
outWriter.printin(student.getLastName()+ "|" + student.getFirstName() + 
"|" + student.getPhoneNumber() + "|" + student.getSkillLevel()); 
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Table 4.564 


orsair (|:) >» NetBeans 7.4 > projects > itse2317-jsp » build » web » WEB-INF 


A 


Name v Date modified 

$ classes al x 
E ome 

-r Dijkstra] Edsger|5125556789| expert A 

> web.xm 


wv 


orsair (:) » NetBeans7.4 > projects > itse2317-jsp » build » web » WEB-INF 


A 


Name v Date modified 
a classes £j x 
e 
= Dijkstra|Edsger|5125556789| expert A 
"> web.xml 


v 


orsair (|:) » NetBeans7.4 > projects > itse2317-jsp » build » web » WEB-INF 


A 


Name v Date modified 

J classes Ëj x 
A 

anger Dijkstra] Edsger|5125556789| expert A 

> web.xm 


v 
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Image 7 . StudentInfo.txt 


| Corsair (:) » NetBeans 7.4 » projects > itse2317-jsp » build » web » WEB-INF 


Name 


Di classes 


+ lib 


"I web.xml 


vy Date modified 


Ej 


File Edit Format View Help 


Dijkstra|Edsger|5125556789| expert 


x 


A 


22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 


Table 4.565 


<tr> 
<td>First Name:</td> 
<td><$= firstName ></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><%= lastName %></td> 
</tr> 
<tr> 
<td>Phone Number:</td> 
<td><%= phoneNumber %></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><%= skillLevel ></td> 
</tr> 
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22 <tr> 

23 <td>First Name:</td> 

24 <td><t= firstName ></td> 
25 </tr> 

26 <tr> 

27 <td>Last Name:</td> 

28 <td><%= lastName %></td> 
29 </tr> 

30 <tz> 

31 <td>Phone Number:</td> 

32 <td><%= phoneNumber %></td> 
33 </tr> 

34 <tr> 

35 <td>Skill Level:</td> 

36 <td><%= skillLevel %></td> 
37 </tr> 

22 <tr> 

23 <td>First Name:</td> 

24 <td><%$= firstName %></td> 
25 </tr> 

26 <tr> 

27 <td>Last Name:</td> 

28 <td><%= lastName %></td> 
29 </tr> 

30 <tr> 

hl <td>Phone Number:</td> 

32 <td><%= phoneNumber %></td> 
33 </tr> 

34 <tr> 

35 <td>Skill Level:</td> 

36 <td><%= skillLevel %></td> 
37 </tr> 
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Image 8 . Code - Simple Variables Used 


22 <tr> 
23 <td>First Name:</td> 
24 <td><%= firstName %></td> 
25 </tr> 
26 <tr> 
27 <td>Last Name:</td> 
28 <td><%= lastName %></td> 
29 </tr> 
30 <tr> 
31 <td>Phone Number:</td> 
32 <td><%= phoneNumber %></td> 
33 </tr> 
34 <tr> 
35 <td>Skill Level:</td> 
36 <td><%= skillLevel %></td> 
37 </tr> 
Table 4.566 

<div class="center"> 
10 Academy</hi> 
11 irae ode Academy please enter your information.</p> 

(Alt-Enter shows hints) splay new member with classes.jsp" method="post"> 
<table class="inline-block"> p 

<div class="center"> 
10 Academy</hi> 
11 BA ode Academy please enter your information.</p> 

(Alt-Enter shows hints) splay_new member with_classes.jsp" method="post"> 
<table class="inline-block"> 

<div class="center"> 
10 Academy</hi> 
EB |7 ode Academy please enter your information.</p> 


(Alt-Enter shows hints) 
<table class="inline-block"> 
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Image 9 . Incorrect Warnings 

a <div class="center"> 

10 e Academy</hi> 

11 ea ode Academy please enter your information.</p> 
(Alt-Enter shows hints) splay new member with_classes.jsp" method="post"> 

a <table class="inline—-block"> 


Table 4.567 


4.5.11.10 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4360: Working with Java Classes 
e Author: Dr. R.L.Martinez 

e Maintainer: R.G.Baldwin 

e File: Java4360.htm 

e Published: 11/27/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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4.5.12 Java4360r: Review” 
4.5.12.1 Table of Contents 


Preface (p. 2410) 
Background information (p. 2410) 
Questions (p. 2414) 


1 (p. 2414) , 2 (p. 2414) , 3 (p. 2414) , 4 (p. 2414) , 5 (p. 2414) 


Image index (p. 2414) 
Answers (p. 2416) 
Images (p. 2417) 
Miscellaneous (p. 2455) 


4.5.12.2 Preface 


This module is one in a collection of modules on JavaServer Pages (JSP) designed for teaching ITSE2317 - 
Java Programming (Intermediate) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4360: Working with 
Java Classes 27! . 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 

The Images (p. 2417) section contains a number of images that you may find helpful as reference material 
in answering the questions. 


4.5.12.3 Background information 


The Student class 

The program in the following discussion was presented in Java4360: Working with Java Classes 
The main purpose of this module is to provide a series of review questions and answers that you can use to 
solidify the information in your mind. 

Image 4 (p. 2443) shows a typical definition for a simple class named Student 

The class has two overloaded constructors. The constructor with the empty argument list simply sets 
the four instance variables to empty String values. 

The other constructor, which is the one actually used in this program, receives four String values 
as incoming parameters and saves them in four private instance variables with the same names as the 
parameters: firstName , lastName , phoneNumber , and _ skillLevel . 

The class provides four public set methods that can be used to store values in the private instance 
variables individually. Those accessor methods are typical but are not used in this program. 

The class provides four public get methods that can be used to retrieve the values stored in the instance 
variables individually. The get methods are used in this program. 

The StudentFile class 

Image 6 (p. 2448) contains the definition of a class named StudentFile . The purpose of this class is 
to create and populate a file on the server containing information about students. 

This class defines a single static method named add . Because the method is declared static , it can 
be called by simply joining the name of the method to the name of the class as in StudentFile.add(...) 

The add method receives two incoming parameters: 


272 


270 This content is available online at <http://cnx.org/content /m48204/1.3/>. 
271http://cnx.org/content /m48087/latest /?collection=col11441 /latest 
272http://cnx.org/content /m48087/latest /?collection=col11441/latest 
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e a reference to an object of the class Student 
e areference toa String object containing a path to a location on the server where a new file can be 
created 


Line 8 of Image 6 (p. 2448) instantiates a new object of the standard library class named File . This 
object encapsulates a pathname for an output file in the location specified by the filePath parameter. 
This pathname can later be retrieved and used for a variety of purposes. (Note that this does not create a 
physical file at this point.) 

The statement that begins in line 9 of Image 6 (p. 2448) uses the syntax for Java’s try-with-resources 
statement 77° . You have not seen the use of this syntax earlier in this course or in the prerequisite course. 
In the final analysis, this statement simply 


e Calls the four accessor methods on the Student object to retrieve the four String values stored in 
that object. 

e Constructs anew String object as the concatenation of those four values separated by vertical bar 
"|" characters. 

e Appends that string onto the end of the output file. 


Image 7 (p. 2450) shows an example of the contents of that file inside the green Notepad frame. 

A somewhat more common example 

Rather than attempting to explain the format shown in Image 6 (p. 2448) , I will present and explain a 
stand-alone program named FileDemo that does essentially the same thing using a more common syntax. 

(I will refer you to try-with-resources statement ?"* for an understanding of the syntax used in Image 6 (p. 

2448) ). Because this is a stand alone program, you can experiment with it without a requirement for a 
JSP server. 

I will explain the program in fragments. A complete listing of the program is shown in Image 10 (p. 
2454) . 

The driver class 

The driver class for the program is shown in Image 11 (p. 2411) . 


Image 11 . The driver class. 


class FileDemo{ 
public static void main(String[] args){ 
Runner runner = new Runner(); 
runner .add("abcd") ; 
runner.add("efgh") ; 
}//end main 
}//end class FileDemo 


Table 4.568 


The driver class instantiates an object of a class named Runner and calls the add method on that 
object twice in succession. This causes an empty file to be created and causes two strings to be written into 
the file. 

This add method is intended to simulate the add method shown in Image 6 (p. 2448) . 

The constructor 
The constructor for the class named Runner is shown in Image 12 (p. 2412) . 


273http://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html 
274http://docs.oracle.com/javase/tutorial/essential/exceptions/tryResourceClose.html 
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Image 12 . The constructor. 


class Runner{ 
File file; 
Runner () { 
try{ 
file = new File("test.txt"); 
if (! (file.createNewFile())){ 
file.delete();//delete existing file. 
}//end if 
}catch(Exception ex){ 
ex.printStackTrace() ; 
}//end catch 
}//end constructor 


Table 4.569 


The constructor creates an abstract pathname for a new file as an object of the class named File . Ifa 
file with that name exists, it is deleted. A reference to the new File object is saved in the instance variable 
named file to make it available to the add method later. 

The add method 
The add method is shown in Image 13 (p. 2412) . 


Image 13 . The add method. 


void add(String value) { 
try{ 
PrintWriter outWriter = 
new PrintWriter ( 
new FileWriter(file,true)); 


outWriter.printlin(value) ; 
outWriter.close(); 

}catch(Exception ex){ 
ex.printStackTrace() ; 

}//end catch 

System.out.println(file.length()); 

}//end add 
}//end class Runner 


Table 4.570 
The add method receives a reference to a String object. The contents of the String object will be 


appended to the file. 
A Print Writer object 
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The first statement inside the try block in Image 13 (p. 2412) creates an object of the class named 
Print Writer . This object will be used to append the string onto the end of the file. If the file doesn’t 
exist, a new empty file with the specified pathname will be created. 

Note however that a PrintWriter object doesn’t inherently know anything about files. Rather, a 
Print Writer object "Prints formatted representations of objects to a text-output stream." It must be 
instructed to print into a file (or to some other stream) when it is constructed. 

There are several different overloaded constructors for the Print Writer class. One of those constructors 
accepts an input parameter that is a reference to an object of type Writer . That is the constructor that 
is used in Image 13 (p. 2412) . 

An object of type Writer 

There are numerous ways to create an object of type Writer . One of those ways is to instantiate an 
object of the class named FileWriter , (which is a subclass of java.io.Writer ) as shown in Image 13 
(p. 2412) . This class is a "convenience class for writing character files." 

The FileWriter class 

The FileWriter class also has several overloaded constructors. One of the constructors accepts two 

parameters: 


e areference toa File object 
e a boolean value 


This constructor constructs a FileWriter object that will write into the file specified by the pathname 
encapsulated in the File object. If the second argument is true , as in Image 13 (p. 2412) , characters 
will be appended to the end of the file instead of being written at the beginning of the file. 

Append the string onto the file 

The second statement inside the try block in Image 13 (p. 2412) appends the string onto the end of the 
file. The third statement closes the file before exiting the try block. 

The length of the file 

Finally, the last statement in the add method in Image 13 (p. 2412) displays the length of the file each 
time the method is called as shown in Image 14 (p. 2413) . 


Image 14 . The file length. 


12 


Table 4.571 


The contents of the file 
The contents of the file named test.txt are shown in Image 15 (p. 2413) . 


Image 15 . The file contents. 


continued on next page 
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abcd 
efgh 


Table 4.572 


Get and save the data 

Having taken a side trip to explain the file handling of Image 6 (p. 2448) , we will now turn our attention 
to the JSP code in Image 3 (p. 2435) . 

The code in the scriptlet tag beginning on line 10 in Image 3 (p. 2435) does the following: 


e It extracts the firstName , lastName , phoneNumber , and _ skillLevel values from the Request 
object and saves those values in String variables having the same names. 

e It gets areference toa String object containing a path on the server where it can create and store a 
file containing that information. You will learn more about the details of this operation (lines 17 and 
18) in the servlet portion of the next course. 

e It instantiates an object of the Student class and populates that object with the four String values 
that were extracted from the Request object. 

e It passes references to the Student object and the filePath string to the add method of the 
class named StudentFile described earlier. 


Retrieve and display the data 
Lines 31, 35, 39, and 43 of Image 3 (p. 2435) use JSP expression tags along with the accessor methods 
of the Student class to extract the four values from the Student object and send them back to the 
client. browser for display. 
4.5.12.4 Questions 
4.5.12.4.1 Question 1 
Objects, in their simplest form, consists of only 2 things. What are they? 
Go to answer 1 (p. 2417) 
4.5.12.4.2 Question 2 
JSP developers must contend with at least three different uses of the word "class," which can sometimes 
lead to confusion. What are those uses? 
Go to answer 2 (p. 2416) 
4.5.12.4.3 Question 3 
True or False? The word class that appears on line 38 in Image 1 (p. 2424) refers to a Java class. 
Go to answer 3 (p. 2416) 
4.5.12.4.4 Question 4 
True or False? A common design strategy in OO is to hide data behind public accessor methods. 
Go to answer 4 (p. 2416) 
4.5.12.4.5 Question 5 


True or False? The object. of the Student class that is instantiated on line 20 of Image 3 (p. 2435) is stored 
in an object-oriented database. 
Go to answer 5 (p. 2416) 
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4.5.12.5 Image index 


e Image 1 (p. 2424) . Code - join_acc_code_academy.html. 

e Image 2 (p. 2428) . Output - join _acc_code_academy.html. 

e Image 3 (p. 2435) . Code - display_new_member_with_classes.jsp. 
e Image 4 (p. 2443) . Code - Student.java. 

e Image 5 (p. 2447) . Output - display _new_member_with_classes.jsp. 
e Image 6 (p. 2448) . Code - StudentFile.java. 

e Image 7 (p. 2450) . StudentInfo.txt. 

e Image 8 (p. 2452) . Code - Simple Variables Used. 

e Image 9 (p. 2453) . Incorrect Warnings. 

e Image 10 (p. 2454) . FileDemo.java. 

e Image 11 (p. 2411) . The driver class. 

e Image 12 (p. 2412) . The constructor. 

e Image 13 (p. 2412) . The add method. 

e Image 14 (p. 2413) . The file length. 

e Image 15 (p. 2413) . The file contents. 


What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


Ee 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


4.5.12.6 Answers 
4.5.12.6.1 Answer 5 


False. A reference to the object is passed to the add method of the class named StudentFile where 
its contents are extracted and appended to an output file. A reference to the object along with its accessor 
methods is also used to extract its contents (lines 31, 35, 39, and 43) and echo them back to the user’s 
browser. However, neither the object itself nor a reference to the object is not saved in any form of long-term 
storage such as an object-oriented database. 

Go back to Question 5 (p. 2414) 
4.5.12.6.2 Answer 4 
True. 

Go back to Question 4 (p. 2414) 
4.5.12.6.3 Answer 3 
False. The word class that appears on line 38 in Image 1 (p. 2424) refers to a CSS selector. The word 


class that appears on line 2 of Image 4 (p. 2443) is the beginning of a Java class definition named Student 


Go back to Question 3 (p. 2414) 


4.5.12.6.4 Answer 2 


1. The Java class definition from which objects are instantiated. 
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2. The CSS class selector. 
3. The extension that appears on the file resulting from compilation of a class definition. 


Java developers also use the word "class" in many other contexts such as class variables, class methods, and 
anonymous inner classes. However, items 1 and 2 above are most likely to lead to confusion in Java4360: 
Working with Java Classes 2% . 

Go back to Question 2 (p. 2414) 


4.5.12.6.5 Answer 1 


e functionality 
e data 


Go back to Question 1 (p. 2414) 


4.5.12.7 Images 


This section contains images that may be referred to by more than one question or answer. These images 
may also be helpful as reference material for answering the questions. Other images may be interspersed 
within the questions and answers. 


275http://cnx.org/content /m48087 /latest /?collection=col11441 /latest 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


wo ont nD WO & & DY 


moe h em ew WO Www WwW WwW WwW WN HH DY YH DY YY N PRP RP RP RP RP Pr be 
Or WON FP OW OHA OF WKY FP OW DDH HF WNP OF WY MO NH OO fF WY NY PO 


2413 


<!DOCTYPE html> 
<!-- join acc code academy.html --> 
<html> 
<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new member with_classes.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</txr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="table header" 
value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 
<!-- join acc code academy.html --> 
<html> 
<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new member with_classes.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</txr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="table header" 
value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 
<!-- join acc code academy.html --> 
<html> 
<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new member with_classes.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</txr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="table header" 
value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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Image 1 . Code - join _acc_code_academy.html. 
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<!DOCTYPE html> 


<head> 
<title>Join Code Academy</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Join ACC Code Academy</hi> 
<p>To join ACC Code Academy please enter your information.</p> 
<form action="display new member with_classes.jsp" method="post"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</tr> 
<tzr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="table header" 
value="Join the College"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 


</html> À 
Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2420 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Table 4.573 


Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


— 
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Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


_ D 
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Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


Skill Level: oly 


| mna | 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2423 


Image 2 . Output - join_acc_code_academy.html. 


Join ACC Code Academy 


To join ACC Code Academy please enter your information. 


5125556789 | 
Saint [eet o 


| nen 


Table 4.574 
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<!DOCTYPE html> 


<!-- display new student with c 
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<%@ page import="college.*, data.*, java.io.*, java.util.*" %> 
<html> 
<head> 
<title>Display New Student with Classes</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<$% 
// get parameters from the Request object 
String firstName = request.getParameter ("firstName"); 
String lastName = request.getParameter ("lastName"); 
String phoneNumber = request.getParameter ("phoneNumber"); 
String skillLevel = request.getParameter("skillLevel"); 
// set filePath to a relative file name 
ServletContext sc = this.getServletContext(); 
String filePath = sc.getRealPath ("/WEB-INF/Studentinfo.txt"); 
// use custom Java objects to write to file 
Student student = new Student (firstName, lastName, 
phoneNumber, skillLevel); 
StudentFile.add(student, filePath); 
$> 
<div class="center"> 
<h1>Thank you for joining ACC Code Academy.</h1> 
<h2>This is the information entered:</h2> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
<tr> 
<td>First Name:</td> 
<td><$= student.getFirstName() ></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><%= student.getLastName() %></td> 
</tr> 
<tr> 
<td>Phone Number:</td> 
<td><$= student.getPhoneNumber() $></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><%$= student.getSkillLevel() %></td> 
</tr> 
</table> 
<p>To add another new student, select the button below.</p> 
<form action="join_acc_ code academy.html" method="get"> 
<input type="submit" class="table header" 
value="Enter Another New Student"> 
</form> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 


<!-- display new student with c 
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<%@ page import="college.*, data.*, java.io.*, java.util.*" %> 
<html> 
<head> 
<title>Display New Student with Classes</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<$% 
// get parameters from the Request object 
String firstName = request.getParameter ("firstName"); 
String lastName = request.getParameter ("lastName"); 
String phoneNumber = request.getParameter ("phoneNumber"); 
String skillLevel = request.getParameter("skillLevel"); 
// set filePath to a relative file name 
ServletContext sc = this.getServletContext(); 
String filePath = sc.getRealPath ("/WEB-INF/Studentinfo.txt"); 
// use custom Java objects to write to file 
Student student = new Student (firstName, lastName, 
phoneNumber, skillLevel); 
StudentFile.add(student, filePath); 
$> 
<div class="center"> 
<h1>Thank you for joining ACC Code Academy.</h1> 
<h2>This is the information entered:</h2> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
<tr> 
<td>First Name:</td> 
<td><$= student.getFirstName() ></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><%= student.getLastName() %></td> 
</tr> 
<tr> 
<td>Phone Number:</td> 
<td><$= student.getPhoneNumber() $></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><%$= student.getSkillLevel() %></td> 
</tr> 
</table> 
<p>To add another new student, select the button below.</p> 
<form action="join_acc_ code academy.html" method="get"> 
<input type="submit" class="table header" 
value="Enter Another New Student"> 
</form> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 


<!-- display new student with c 
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<%@ page import="college.*, data.*, java.io.*, java.util.*" %> 
<html> 
<head> 
<title>Display New Student with Classes</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<$% 
// get parameters from the Request object 
String firstName = request.getParameter ("firstName"); 
String lastName = request.getParameter ("lastName"); 
String phoneNumber = request.getParameter ("phoneNumber"); 
String skillLevel = request.getParameter("skillLevel"); 
// set filePath to a relative file name 
ServletContext sc = this.getServletContext(); 
String filePath = sc.getRealPath ("/WEB-INF/Studentinfo.txt"); 
// use custom Java objects to write to file 
Student student = new Student (firstName, lastName, 
phoneNumber, skillLevel); 
StudentFile.add(student, filePath); 
$> 
<div class="center"> 
<h1>Thank you for joining ACC Code Academy.</h1> 
<h2>This is the information entered:</h2> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
<tr> 
<td>First Name:</td> 
<td><$= student.getFirstName() ></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><%= student.getLastName() %></td> 
</tr> 
<tr> 
<td>Phone Number:</td> 
<td><$= student.getPhoneNumber() $></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><%$= student.getSkillLevel() %></td> 
</tr> 
</table> 
<p>To add another new student, select the button below.</p> 
<form action="join_acc_ code academy.html" method="get"> 
<input type="submit" class="table header" 
value="Enter Another New Student"> 
</form> 
</div> 
</body> 
</html> 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2429 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2430 


CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Image 3 . Code - display _new_member_with_classes.jsp. 
<!DOCTYPE html> 
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java.io.*, java.util.*" %> 
<html> 
<head> 
<title>Display New Student with Classes</title> 
<link rel="stylesheet" href="css/css-1.css"> 
</head> 
<body> 
<$% 
// get parameters from the Request object 
String firstName = request.getParameter ("firstName"); 
String lastName = request.getParameter ("lastName"); 
String phoneNumber = request.getParameter ("phoneNumber"); 
String skillLevel = request.getParameter("skillLevel"); 
// set filePath to a relative file name 
ServletContext sc = this.getServletContext(); 
String filePath = sc.getRealPath ("/WEB-INF/Studentinfo.txt"); 
// use custom Java objects to write to file 
Student student = new Student (firstName, lastName, 
phoneNumber, skillLevel); 
StudentFile.add(student, filePath); 
$> 
<div class="center"> 
<hi>Thank you for joining ACC Code Academy.</hi> 
<h2>This is the information entered:</h2> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Information Entered</th></tr> 
<tr> 
<td>First Name:</td> 
<td><%$= student.getFirstName() %></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><%= student.getLastName() %></td> 
</tr> 
<tr> 
<td>Phone Number:</td> 
<td><$= student.getPhoneNumber() ></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><%$= student.getSkillLevel() %></td> 
</tr> 
</table> 
<p>To add another new student, select the button below.</p> 
<form action="join_ acc code academy.html" method="get"> 
<input type="submit" class="table header" 
value="Enter Another New Student"> 
</form> 
</div> 
</body> 


</html> N 
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package college; 
public class Student 
{ 
private String firstName; 
private String lastName; 
private String phoneNumber; 
private String skillLevel; 
public Student () 
{ 
firstName = ""; 
lastName = ""; 
phoneNumber = ""; 
skillLevel = ""; 
} 
public Student (String firstName, String lastName, 
String phoneNumber, String skillLevel) 


{ 
this.firstName = firstName; 
this.lastName = lastName; 
this.phoneNumber = phoneNumber; 
this.skillLevel = skillLevel; 

} 

public void setPirstName (String firstName) 

{ 


this.firstName = firstName; 
} 
public String getFirstName () 
{ 
return firstName; 
} 
public void setLastName (String lastName) 
{ 
this.lastName = lastName; 


} 
public String getLastName () 
{ 
return lastName; 
} 


public void setPhoneNumber (String phoneNumber) 
{ 
this.phoneNumber = phoneNumber; 


} 
public String getPhoneNumber () 
{ 
return phoneNumber; 
} 
public void setSkillLevel (String skillLevel) 
{ 
this.skillLevel = skillLevel; 
} 
public String getSkillLevel () 
{ 
return skillLevel; 
} 
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package college; 
public class Student 
{ 
private String firstName; 
private String lastName; 
private String phoneNumber; 
private String skillLevel; 
public Student () 
{ 
firstName = ""; 
lastName = ""; 
phoneNumber = ""; 
skillLevel = ""; 
} 
public Student (String firstName, String lastName, 
String phoneNumber, String skillLevel) 


{ 
this.firstName = firstName; 
this.lastName = lastName; 
this.phoneNumber = phoneNumber; 
this.skillLevel = skillLevel; 

} 

public void setPirstName (String firstName) 

{ 


this.firstName = firstName; 
} 
public String getFirstName () 
{ 
return firstName; 
} 
public void setLastName (String lastName) 
{ 
this.lastName = lastName; 


} 
public String getLastName () 
{ 
return lastName; 
} 


public void setPhoneNumber (String phoneNumber) 
{ 
this.phoneNumber = phoneNumber; 


} 
public String getPhoneNumber () 
{ 
return phoneNumber; 
} 
public void setSkillLevel (String skillLevel) 
{ 
this.skillLevel = skillLevel; 
} 
public String getSkillLevel () 
{ 
return skillLevel; 
} 
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package college; 
public class Student 
{ 
private String firstName; 
private String lastName; 
private String phoneNumber; 
private String skillLevel; 
public Student () 
{ 
firstName = ""; 
lastName = ""; 
phoneNumber = ""; 
skillLevel = ""; 
} 
public Student (String firstName, String lastName, 
String phoneNumber, String skillLevel) 


{ 
this.firstName = firstName; 
this.lastName = lastName; 
this.phoneNumber = phoneNumber; 
this.skillLevel = skillLevel; 

} 

public void setPirstName (String firstName) 

{ 


this.firstName = firstName; 
} 
public String getFirstName () 
{ 
return firstName; 
} 
public void setLastName (String lastName) 
{ 
this.lastName = lastName; 


} 
public String getLastName () 
{ 
return lastName; 
} 


public void setPhoneNumber (String phoneNumber) 
{ 
this.phoneNumber = phoneNumber; 


} 
public String getPhoneNumber () 
{ 
return phoneNumber; 
} 
public void setSkillLevel (String skillLevel) 
{ 
this.skillLevel = skillLevel; 
} 
public String getSkillLevel () 
{ 
return skillLevel; 
} 
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CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Image 4 . Code - Student.java. 
1| package college; ~ 
2| public class Student 
3| í 
4 private String firstName; 
5 private String lastName; 
6 private String phoneNumber; 
7 private String skillLevel; 
8 public Student () 
9 { 
10 firstName = ""; 
E lastName = ""; 
12 phoneNumber = ""; 
13 skillLevel = ""; 
14 } 
15 public Student (String firstName, String lastName, 
16 String phoneNumber, String skillLevel) 
17 { 
18 this.firstName = firstName; 
19 this.lastName = lastName; 
20 this.phoneNumber = phoneNumber; 
21 this.skillLevel = skillLevel; 
22 } 
23 public void setFirstName (String firstName) 
24 { 
25 this.firstName = firstName; 
26 } 
27 public String getFirstName () 
28 { 
29 return firstName; 
30 } 
Eil public void setLastName (String lastName) 
32 { 
33 this.lastName = lastName; 
34 } 
35 public String getLastName () 
36 { 
37 return lastName; 
38 } 
39 public void setPhoneNumber (String phoneNumber) 
40 { 
41 this.phoneNumber = phoneNumber; 
42 } 
43 public String getPhoneNumber () 
44 { 
45 return phoneNumber; 
46 } 
47 public void setSkillLevel (String skillLevel) 
48 { 
49 this.skillLevel = skillLevel; 
50 } 
51 public String getSkillLevel() 
52 { 
53 return skillLevel; 
54 } 
SSj } : ` 
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Table 4.576 


Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 
First Name: Edsger 
Last Name: Dijkstra 


Phone Number:|/5 12555678 
Skill Level: expert 


To add another new student, select the button below. 
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Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 


Phone Number://512555678 


Skill Level: exp 


To add another new student, select the button below. 


i 
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Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 


Phone Number://512555678 


Skill Level: exp 


To add another new student, select the button below. 
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Thank you for joining ACC 
Code Academy. 


This is the information entered: 


Information Entered 


Phone Number:|/5 125556789 
Skill Level: expert 


To add another new student, select the button below. 


Table 4.577 


1|! package data; 

2| import java.io.*; 

3! import college.Student; 

4 public class StudentFile 

5| { 

6 public static void add(Student student, String filePath) throws IOException 
7, í 

8 File file = new File(filePath) ; 


9 try (PrintWriter outWriter = new PrintWriter(new FileWriter (file, true))) { 
10 outWriter.printin(student.getLastName()+ "|" + student.getFirstName() + 
11 "|" + student.getPhoneNumber() + "|" + student.getSkillLevel()); 
12 } 

13| } 

14) } 
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1 package data; 

2| import java.io.*; 

3| import college.Student; 

4 public class StudentFile 

5| ¢ 

6 public static void add(Student student, String filePath) throws IOException 

7 í 

8 File file = new File(filePath) ; 

9 try (PrintWriter outWriter = new PrintWriter(new FileWriter (file, true))) { 
10 outWriter.printin(student.getLastName()+ "|" + student.getFirstName() + 
11 "|" + student.getPhoneNumber() + "|" + student.getSkillLevel()); 
12 } 
13| } 

14, } 

1| package data; 

2| import java.io.*; 

3| import college.Student; 

4! public class StudentFile 

5| ¢ 

6 public static void add (Student student, String filePath) throws IOException 

7 í 

8 File file = new File (filePath); 

9 try (PrintWriter outWriter = new PrintWriter (new FileWriter (file, true))) { 
10 outWriter.printin(student.getLastName()+ "|" + student.getFirstName() + 
11 "|" + student.getPhoneNumber() + "|" + student.getSkillLevel()); 
12 } 
13| } 
14| } 

Image 6 . Code - StudentFile.java. 
g -= package data; | 
2| import java.io.*; 

3) import college.Student; 

4 public class StudentPile 

5 ¢ 

6 public static void add(Student student, String filePath) throws IOException 

7 í 

8 File file = new File(filePath) ; 

9 try (PrintWriter outWriter = new PrintWriter (new FileWriter (file, true))) { 
10 outWriter.printin(student.getLastName()+ "|" + student.getFirstName() + 
11 "|" + student.getPhoneNumber() + "|" + student.getSkillLevel()); 
12 } 
13| } 
14| } 
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Table 4.578 


orsair (I:) » NetBeans 7.4 » projects > itse2317-jsp » build » web » WEB-INF 


A 


Name v Date modified 

$ classes al x 
E ome 

-r Dijkstra] Edsger|5125556789| expert A 

> web.xm 


wv 


orsair (:) » NetBeans7.4 > projects > itse2317-jsp » build » web » WEB-INF 


A 


Name v Date modified 
a classes £j x 
e 
= Dijkstra|Edsger|5125556789| expert A 
"> web.xml 


v 


orsair (|:) » NetBeans7.4 > projects > itse2317-jsp » build » web » WEB-INF 


A 


Name v Date modified 

J classes Ëj x 
A 

anger Dijkstra] Edsger|5125556789| expert A 

> web.xm 


v 
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Image 7 . StudentInfo.txt. 


| Corsair (:) > NetBeans 7.4 » projects > itse2317-jsp » build » web » WEB-INF 


Name 


Di classes 


+ lib 


"I web.xml 


vy Date modified 


Ej 


File Edit Format View Help 


Dijkstra|Edsger|5125556789| expert 


x 


A 


22 
23 
24 
25 
26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 


Table 4.579 


<tr> 
<td>First Name:</td> 
<td><$= firstName ></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><%= lastName %></td> 
</tr> 
<tr> 
<td>Phone Number:</td> 
<td><%= phoneNumber %></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><%= skillLevel ></td> 
</tr> 
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22 <tr> 

23 <td>First Name:</td> 

24 <td><t= firstName ></td> 
25 </tr> 

26 <tr> 

27 <td>Last Name:</td> 

28 <td><%= lastName %></td> 
29 </tr> 

30 <tz> 

31 <td>Phone Number:</td> 

32 <td><%= phoneNumber %></td> 
33 </tr> 

34 <tr> 

35 <td>Skill Level:</td> 

36 <td><%= skillLevel %></td> 
37 </tr> 

22 <tr> 

23 <td>First Name:</td> 

24 <td><%$= firstName %></td> 
25 </tr> 

26 <tr> 

27 <td>Last Name:</td> 

28 <td><%= lastName %></td> 
29 </tr> 

30 <tr> 

hl <td>Phone Number:</td> 

32 <td><%= phoneNumber %></td> 
33 </tr> 

34 <tr> 

35 <td>Skill Level:</td> 

36 <td><%= skillLevel %></td> 
37 </tr> 
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Image 8 . Code - Simple Variables Used. 


22 <tr> 
23 <td>First Name:</td> 
24 <td><%= firstName %></td> 
25 </tr> 
26 <tr> 
27 <td>Last Name:</td> 
28 <td><%= lastName %></td> 
29 </tr> 
30 <tr> 
31 <td>Phone Number:</td> 
32 <td><%= phoneNumber %></td> 
33 </tr> 
34 <tr> 
35 <td>Skill Level:</td> 
36 <td><%= skillLevel %></td> 
37 </tr> 
Table 4.580 

<div class="center"> 
10 Academy</hi> 
11 irae ode Academy please enter your information.</p> 

(Alt-Enter shows hints) splay new member with classes.jsp" method="post"> 
<table class="inline-block"> p 

<div class="center"> 
10 Academy</hi> 
11 BA ode Academy please enter your information.</p> 

(Alt-Enter shows hints) splay_new member with_classes.jsp" method="post"> 
<table class="inline-block"> 

<div class="center"> 
10 Academy</hi> 
EB |7 ode Academy please enter your information.</p> 


(Alt-Enter shows hints) 
<table class="inline-block"> 
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Image 9 . Incorrect Warnings. 
@ <div class="center"> 
10 Academy</hi> 
11 ho l ode Academy please enter your information.</p> 
(Alt-Enter shows hints) splay _new_member_with_classes.jsp" method="post"> 
<table class="inline—-block"> 


Table 4.581 
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Image 10 . FileDemo.java. 


//File: FileDemo.java 
//Copyright 2013, R.G.Baldwin 


import java.io.*; 


class FileDemo{ 
public static void main(String[] args){ 
Runner runner = new Runner(); 
runner .add("abcd") ; 
runner.add("efgh") ; 
}//end main 
}//end class FileDemo 


class Runner{ 
File file; 
Runner () { 
try{ 
//Create a pathname for a new file. If a 
// file with that pathname exists, delete 
// it so as to begin with an empty file. 
file = new File("test.txt"); 
if(! (file.createNewFile())){ 
file.delete();//delete existing file. 
}//end if 
}catch(Exception ex){ 
ex.printStackTrace() ; 
}//end catch 
}//end constructor 


void add(String value) { 
try{ 
//Create an object that will append 
// characters onto the end of a file with 
// the specified pathname. 
//If the file doesn’t exist, create an 
// empty file with the specified pathname. 
PrintWriter outWriter = 
new PrintWriter ( 
new FileWriter(file,true)); 


//Append the string onto the end of the 
// file and close it. 
outWriter.printlin(value) ; 
outWriter.close(); 

}catch(Exception ex){ 
ex. printStackTrace() ; 

}//end catch 

System. out . prantihpGfd} ect engtdahddions <http://cnx.org/content /coll1441/1.181> 

}//end add 
}//end class Runner 
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Table 4.582 


4.5.12.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4360r: Review 
e File: Java4360r.htm 

e Published: 12/11/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


4.5.13 Java4370: Cookies with JSP” 
4.5.13.1 Table of Contents 
e Preface (p. 2456) 


Viewing tip (p. 2456) 
x Images (p. 2456) 


Preview (p. 2456) 

General background information (p. 2456) 
Discussion (p. 2456) 

Homework assignment (p. 2459) 
Summary (p. 2459) 

What’s next? (p. 2459) 

Images (p. 2460) 

Miscellaneous (p. 2517) 


276 This content is available online at <http://cnx.org/content/m48091/1.7/>. 
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4.5.13.2 Preface 


This module is one in a collection of modules designed for teaching ITSE 2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

In this module cookies are covered in the context of JSP. After reviewing this material and coding the 
examples, students will have a fundamental understanding of using cookies with JSP. 


4.5.13.2.1 Viewing tip 

I recommend that students open another copy of this module in a separate browser window and use the 
following links to easily find and view the Images while you are reading about them. 

4.5.13.2.1.1 Images 


Image 1 (p. 2463 
Image 2 (p. 


) . Output - cookiesAndSessions.html 
p ) . Code - css-3.css 
Image 3 (p. 2472) . Code - cookiesAndSessions.html 
Image 4 (p. 2476) . Output - cookieDataEntry.html 
Image 5 (p. 2481) . Code - cookieDataEntry.html 
Image 6 (p. 2485) . Output - cookieCreator.jsp 
) . Code - cookieCreator.jsp 
) . Code - cookieCreatorProcessor.jsp 
) . Output - readingCookies.jsp 


Image 7 (p. 2489 
Image 8 (p. 2493 
Image 9 (p 
Image 10 (p ) . Code - readingCookies.jsp 

Image 11 (p. 2505) . Output - deletingCookie.jsp (part 1 of 2) 
Image 12 (p. 2509) . Output - deletingCookie.jsp (part 2 of 2) 
Image 13 (p ) . Code - deletingCookie.jsp 

Image 14 (p. 2515) . Code - deletingCookieProcessor.jsp 
Image 15 (p. 2517) . Cookies and Site Data 


4.5.13.3 Preview 


No intermediate web discussion would be complete without addressing cookies and sessions. In this module 
cookies are considered and sessions are coming up next. The material may be a little involved at times 
in these two modules. However, after multiple reviews and practice with the code, students will acquire 
practical comprehension of cookies and sessions. 


4.5.13.4 General background information 


As mentioned in previous modules, HTTP is a stateless protocol. This is a fancy way of saying that HTTP 
has no memory of relationships between client and server. The server, with HTTP alone, records (or persists) 
no data about the client. Each client request to the server receives response(s) from the server and then the 
relationship is terminated. Often, web developers would like to retain information about the client so when 
the user returns to the site, the server can respond with custom content based on the identity of the client. 
A common and convenient way for this to occur is through the use of cookies. 


4.5.13.5 Discussion 


Cookies are simply small text files. They can be created on the server using server-side code or on the client 
with a scripting language such as JavaScript. In this course, the former technique will be utilized. That is, 
cookies will be created on the server, sent back to the browser, and stored on the client. During a connection 
between the client and server in the future, browsers can send the cookie information to the server so it can 
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be identified and the user experience customized. While there are a few data elements in cookies, the most 
important are the name::value pair. 

Browsers often refer to value as content. See Image 15 (p. 2517) for a listing of the cookies associated 
with the localhost domain (our development domain) presented by the browser. The name of the cookie 
highlighted is skillLevel and the value (or content) is beginner. To view cookies in Chrome, navigate to 
Settings | Show Advanced Settings | Content Settings | All cookies and site data... | and look for localhost 
to see a list of cookies created by our programs. 


4.5.13.5.1 Code - cookiesAndSessions. html 


To get started, take a look at the simple HTML page displayed in Image 1 (p. 2463) . It will be the 
navigation hub for this module and the next. The CSS code from Image 1 (p. 2463) is listed in Image 2 
(p. 2470) . The HTML file is listed in Image 3 (p. 2472) . The content in Image 2 (p. 2470) and Image 
3 (p. 2472) has been previously covered and should be familiar. One quick note about the CSS in Image 
2 (p. 2470) . One organizational technique (like that used here) is to separate CSS selectors by type. In 
the case of Image 2 (p. 2470) , the element selectors are listed first, followed by the class selectors, followed 
by the id selector. There are other ways to organize the content. Software development teams will often 
document what works best for them. An organizational technique of some form should be used to increase 
coding efficiency and consistency within the team. 


4.5.13.5.2 Code - cookieDataEntry.html 


Notice that the link Create Cookies is highlighted and is ready for activation in Image 1 (p. 2463) . When 
that link is selected, the page on Image 4 (p. 2476) is displayed. The code and resulting output are familiar 
from the Form Processing with JSP module. The three textboxes and one select list on the page all represent 
cookies that will be created based on the content of the controls submitted via the Create Cookies button 
(see the Form Processing with JSP module for a review). The code that outputs Image 4 (p. 2476) is listed 
in Image 5 (p. 2481) and was discussed in the Form Processing with JSP module. The appreciable difference 
in this case is that form data is submitted to the action cookieCreator.jsp. 


4.5.13.5.3 Code - cookieCreator.jsp 


When the submit button (Create Cookies) is selected, the form data is packaged into name::value pairs and 
sent to cookieCreator.jsp the output of which is displayed in Image 6 (p. 2485) . The values of all four 
cookies are listed in Image 6 (p. 2485) . Also, note the name::value pairs are pasted to the end of the URL 
which is displayed at the top of Image 6 (p. 2485) . Unlike the POST submission method which does not 
display form data, using GET (like Image 5 (p. 2481) ) adds the name::value pairs to the end of the Location 
object (the URL). 

It should be noted that another cookie also exists for localhost that is not displayed (because it is not 
requested). When a JSP page is accessed, Tomcat creates a session object and also creates a cookie to 
identify that session object. Much more on this later in the next module. 

Just for variety, lines 7-11 of Image 7 (p. 2489) show the use of embedded CSS. This is an acceptable 
technique when the CSS should only apply to that page. On line 13 of Image 7 (p. 2489) an include directive 
is specified. Recall from the JSP Fundamentals module that an include directive enables the separation of 
functionality into its own file and then include it with one line of code. 

On lines 19, 22, 25, and 28 of Image 7 (p. 2489) , the form values are read from the Request object using 
the getParameter method in Image 7 (p. 2489) . The form names are passed as arguments to the methods 
to return the appropriate values which are then displayed. The button on lines 31-32 of Image 7 (p. 2489) 
takes the user back to Image 1 (p. 2463) . 
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4.5.13.5.4 Code - cookieCreatorProcessor.jsp 


Lines 6-13 of Image 8 (p. 2493) show the creation of four cookies using the Request object which was 
populated by the submission action of cookieDataEntry.html. The cookies are assigned the same names as 
the form controls. The values are obtained from the call to getParameter. Four local variables of type cookie 
are defined and assigned on lines 6-13 and are then used to set the expiration (24 hours) of the cookies. After 
the cookies are created from the form data and expiration dates are set, the four cookies are then added to 
the Response object on lines 20-23 of Image 8 (p. 2493) . The Response object is then sent back to the 
client via the Response header and body content. The browser extracts the cookies from the Response data 
and creates the individual cookie files as shown in Image 15 (p. 2517) . 


4.5.13.5.5 Code - readingCookies.jsp 


Select the button labeled Back to Cookie... on Image 6 (p. 2485) to navigate back to Image 1 (p. 2463) . 
Then select Read Cookies on Image 1 (p. 2463) to display Image 9 (p. 2497) . Notice that the 4 cookies 
created in the previous steps are shown in Image 9 (p. 2497) . There is also a JSESSIONID cookie which 
is automatically created by Tomcat for session tracking. The code for readingCookies.jsp is shown in Image 
10 (p. 2501) . On line 12 an array of type Cookie is created and initialized to null. 

On line 14 of Image 10 (p. 2501) the cookies array is populated with all of the cookies for the localhost 
domain in the Request object that were supplied by the client. Line 15 checks that there were cookies on 
the client. Lines 18-21 show a loop that is used to display all of the cookies in the cookies array. Each of the 
cookie objects has a getName and get Value method which are used to display each of the name::value pairs 
of the cookies. 


4.5.13.5.6 Code - deletingCookie.jsp 


Select the button labeled Back to Cookie... on Image 9 (p. 2497) to navigate back to Image 1 (p. 2463) 
. Select Delete Cookie on Image 1 (p. 2463) to display Image 11 (p. 2505) . All of the localhost cookies 
are discovered and displayed. The red rounded rectangle is surrounding the cookie (skillLevel) that was 
identified for deletion in the code. It is shown here because it still exists in the cookies array. However, after 
deletion and the Response object is sent back to client, the cookie will be deleted and does not appear in 
Image 12 (p. 2509) . 

Then, when another request comes from the client, it will not contain the deleted cookie. This cycle 
can be demonstrated by selecting the See Cookie Removed button. That button simply reloads the page 
(resends another request to the server). This time, the skillLevel cookie no longer exists on the client, will 
not be sent to the server via the Request, and therefore will not be in the cookies array. On line 11 of Image 
13 (p. 2511) , the processor file is loaded which comprises all of the processing on the page. 


4.5.13.5.7 Code - deletingCookieProcessor.jsp 


On lines 5-6 of Image 14 (p. 2515) , the cookies array is populated with cookies sent from the client in the 
Request. A for loop on lines 9-20 is used to display the cookies contained in the cookies array. On lines 
12-17, the code is used to identify the skillLevel cookie and then delete it by the call to setMaxAge. Setting 
the max age of the cookie to 0 deletes the cookie. 

As mentioned above, the skillLevel cookie still exists in the local (server) cookie array and will not be 
deleted until the Response header is sent back to the client. Lines 24-32 of Image 14 (p. 2515) are used to 
display the See Cookie Removed button. That button should only be displayed if the skillLevel cookie still 
exists which will only be the case the first time this page is requested. 

When the See Cookie Removed button is selected, the skillLevel cookie which was updated with a new 
max age on line 13 and added to the Response object on line 14 is sent to the client and removed by the 
browser. So, the next time the browser sends a request to the server the skillLevel cookie will not be included 
in the request. As a side note, the warning icon on line 29 of Image 14 appears because the class color_ coral 
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is not recognized. Recall that this occurs because the CSS file is not listed on this page but is referenced on 
the page that includes this file which will recognize the class. 


4.5.13.5.8 Cookies and Site Data 


Image 15 (p. 2517) shows the cookies that exist on the client at that point in time. On the localhost 
site, there are a total of five cookies shown (the session cookie and the 4 created by cookieCreator.jsp and 
cookieCreatorProcessor.jsp). To access the Cookies and Site Data information, recall from above... To view 
cookies in Chrome, navigate to Settings | Show Advanced Settings | Content Settings | All cookies and site 
data... | and look for localhost to see a list of cookies created by our programs. Note that this shows the 
skillLevel cookie which will not exist after accessing deletingCookie.jsp. Also note that the name::value pair 
(skillLevel::beginner) are shown as Name and Content by the Chrome browser. Other browsers also refer to 
the value portion of the name::value pair as Content. 


4.5.13.6 Homework assignment 


See the JSP section in Blackboard for all JSP homework assignments. 


4.5.13.6.1 Supplemental Reading 


http:/ /docs.oracle.com /javase /tutorial /networking /cookies/ 277 
http://docs.oracle.com /javaee/5/api/javax/servlet /http/Cookie.htm 
http: //docs.oracle.com /javase/tutorial /deployment /doingMoreWithRIA /accessingCookies.html 77° 


ji 278 


4.5.13.7 Summary 


In this module, we covered the creation, reading, and deleting of cookies. Cookies are created on the server, 
stored on the client, and consist of name::value pairs. Each time the client accesses the server, the cookies 
array for that domain are sent to the server. The server can then apply custom settings based on the cookie. 
All browsers allow users to view cookies. See the Supplemental Reading list for more information about 
cookie settings and methods. 


4.5.13.8 What’s next? 


Now that cookies have been discussed, it is time to review how session objects are processed using JSP. We 
have already observed the creation of the JSESSIONID cookie which is created on the server, sent back to 
and stored on the client, and sent to the server when the browser requests a page. The server uses the value 
of the JSESSIONID cookie to associate the session object with the appropriate client. 


277http://docs.oracle.com/javase/ tutorial /networking/cookies/ 
278 http://docs.oracle.com/javaee/5/api/javax/servlet/http/Cookie.html 
279http://docs.oracle.com/javase/ tutorial /deployment /doingMoreWithRIA /accessingCookies.html 
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4.5.13.9 Images 


Cookies and Sessions 


Create ue okies 
Read Cookies 
Delete Cookie 
View Session Data 
Delete Session Attribute 
Delete Session Object 
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Cookies and Sessions 


Create af “ookies 
Read Cookies 
Delete Cookie 
View Session Data 
Delete Session Attribute 
Delete Session Object 
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Cookies and Sessions 


Create,Cookies 
Read Cookies 
Delete Cookie 


View Session Data 


Delete Session Attribute 


Delete Session Object 
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Image 1 . Output - cookiesAndSessions.html 


Cookies and Sessions 


f ‘ookies 
Read Cookies 
Delete Cookie 

View Session Data 

Delete Session Attribute 


Delete Session Object 


Ya a 4 ` 
( Teale 


Table 4.583 
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worn non ke WDM P 
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7 «/ 


article, aside, figure, footer, header, 
menu, nav, section { display: block; } 
body { 

width: 70%; 

margin: 0 auto; 

text-align: center; 

background-color: gainsboro; 


} 
ul { 
text-align: left; 
} 
table, th, td 
{ 
border:ipx solid black; 
} 
af 
text-decoration: none; 
} 
a:hover 
{ 
background-color: yellow; 
} 
pf 
font-size: 2em; 
margin: 10px Opx; 
} 
button { 
font-size: 1.2em; 
margin-top: 10px; 
} 


-inline-block { 
display: inline-table; 


} 
-center { 
width: 525px; 
margin: 0 auto; 
} 


-coral_color{ 
background-color: coral; 
} 
-blue_color { 
color: blue; 
} 
-red_color { 
color: red; 


} 
#th-idi { 

background-color: plum; 
} 
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7 «/ 


article, aside, figure, footer, header, 
menu, nav, section { display: block; } 
body { 

width: 70%; 

margin: 0 auto; 

text-align: center; 

background-color: gainsboro; 


} 
ul { 
text-align: left; 
} 
table, th, td 
{ 
border:ipx solid black; 
} 
af 
text-decoration: none; 
} 
a:hover 
{ 
background-color: yellow; 
} 
pf 
font-size: 2em; 
margin: 10px Opx; 
} 
button { 
font-size: 1.2em; 
margin-top: 10px; 
} 


-inline-block { 
display: inline-table; 


} 
-center { 
width: 525px; 
margin: 0 auto; 
} 


-coral_color{ 
background-color: coral; 
} 
-blue_color { 
color: blue; 
} 
-red_color { 
color: red; 


} 
#th-idi { 

background-color: plum; 
} 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


hgroup, 


2461 


2462 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


worn non ke WDM P 


OO me om Om Om Om Oe Oe Oe oe me WO wD WwW WWW WwW WH NH NY H HY NH HY NY DY N PR RPP RP RP RP RP RP bP 
POW MOD HOF WNHYPRP OO WO DO TDAH OF WNHP OW WAH UWF OUN PODC DO ADH WO & WH PO 


7 «/ 


article, aside, figure, footer, header, 
menu, nav, section { display: block; } 
body { 

width: 70%; 

margin: 0 auto; 

text-align: center; 

background-color: gainsboro; 


} 
ul { 
text-align: left; 
} 
table, th, td 
{ 
border:ipx solid black; 
} 
af 
text-decoration: none; 
} 
a:hover 
{ 
background-color: yellow; 
} 
pf 
font-size: 2em; 
margin: 10px Opx; 
} 
button { 
font-size: 1.2em; 
margin-top: 10px; 
} 


-inline-block { 
display: inline-table; 


} 
-center { 
width: 525px; 
margin: 0 auto; 
} 


-coral_color{ 
background-color: coral; 
} 
-blue_color { 
color: blue; 
} 
-red_color { 
color: red; 


} 
#th-idi { 

background-color: plum; 
} 
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Image 2 . Code - css-3.css 
al * css-3 
2 * For F 
3| article, 
4| menu, nav, section { display: block; } 
5| body { 
6 width: 70%; 
7 margin: 0 auto; 
& text-align: center; 
9 background-color: gainsboro; 
10| } 
11| ul { 
12 text-align: left; 
13| } 
14| table, th, td 
15; í 
16 border:1px solid black; 
17| 3} 
18| af 
19 text-decoration: none; 
20| } 
21| a:hover 
22 í 
23 background-color: yellow; 
24 } 
25| pf 
26 font-size: 2em; 
27 margin: 10px Opx; 
28| } 
29| button { 
30 font-size: 1.2em; 
31 margin-top: 10px; 
32] } 
33 -inline-block { 
34 display: inline-table; 
35| } 
36| .center { 
37 width: 525px; 
38 margin: 0 auto; 
39| } 
40| .coral_color{ 
41 background-color: coral; 
42| } 
43 -blue_color { 
44 color: blue; 
45| } 
46| .red color { 
47 color: red; 
48| } 
49| #th-id1 { 
50 background-color: plum; 
51| } 


hgroup, 
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Table 4.584 
<!DOCTYPE html> 
<!-- cookiesAndSessions.html --> 
<html> 
<head> 


<title>Cookies and Sessions</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class=" center"> 
<hi>Cookies and Sessions</hi> 
</div> 
<p><a href="cookieDataEntry.html">Create Cookies</a></p> 
<p><a href="readingCookies.jsp">Read Cookies</a></p> 
<p><a href="deletingCookie.jsp">Delete Cookie</a></p> 
<p><a href="viewSessionData.jsp">View Session Data</a></p> 
<p><a href="deleteSessionAttribute.jsp">Delete Session Attribute</a></p> 
<p><a href="deleteSessionObject.jsp">Delete Session Object</a></p> 
</body> 
</html> 


<!DOCTYPE html> 
<!-- cookiesAndSessions.html --> 
<html> 
<head> 
<title>Cookies and Sessions</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Cookies and Sessions</hi> 
</div> 
<p><a href="cookieDataEntry.html">Create Cookies</a></p> 
<p><a href="readingCookies.jsp">Read Cookies</a></p> 
<p><a href="deletingCookie.jsp">Delete Cookie</a></p> 
<p><a href="viewSessionData.jsp">View Session Data</a></p> 
<p><a href="deleteSessionAttribute.jsp">Delete Session Attribute</a></p> 
<p><a href="deleteSessionObject.jsp">Delete Session Object</a></p> 
</body> 
</html> 
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1| <!DOCTYPE html> 
2 <!-- cookiesAndSessions.html --> 
3| <html> 
4| <head> 
5 <title>Cookies and Sessions</title> 
6 <link rel="stylesheet" href="css/css-3.css"> 
7| </head> 
8| <body> 
9 <div class="center 
10 <hi>Cookies and Sessions</hi> 
11 </div> 
12 <p><a href="cookieDataEntry.html">Create Cookies</a></p> 
13 <p><a href="readingCookies.jsp">Read Cookies</a></p> 
14 <p><a href="deletingCookie.jsp">Delete Cookie</a></p> 
15 <p><a href="viewSessionData.jsp">View Session Data</a></p> 
16 <p><a href="deleteSessionAttribute.jsp">Delete Session Attribute</a></p> 
$? <p><a href="deleteSessionObject.jsp">Delete Session Object</a></p> 
18| </body> 
19| </html> 
Image 3 . Code - cookiesAndSessions.html 
| a] <!DOCTYPE html> | 
2 <!-- cookiesAndSessions.html --> 
3| <html> 
4| <head> 
5 <title>Cookies and Sessions</title> 
6 <link rel="stylesheet" href="css/css-3.css"> 
7| </head> 
8| <body> 
9 <div class="center"> 
10 <hi>Cookies and Sessions</hi> 
11 </div> 
12 <p><a href="cookieDataEntry.html">Create Cookies</a></p> 
13 <p><a href="readingCookies.jsp">Read Cookies</a></p> 
14 <p><a href="deletingCookie.jsp">Delete Cookie</a></p> 
15 <p><a href="viewSessionData.jsp">View Session Data</a></p> 
16 <p><a href="deleteSessionAttribute.jsp">Delete Session Attribute</a></p> 
17 <p><a href="deleteSessionObject.jsp">Delete Session Object</a></p> 
18| </body> 
19| </html> 


Table 4.585 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2468 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Enter Cookie Data 


Your Digits (all 10) 


|r a | 
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Enter Cookie Data 


Your Digits (all 10) 


|r a | 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2470 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Enter Cookie Data 


Your Digits (all 10) 


|r a | 
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Image 4 . Output - cookieDataEntry.html 


Enter Cookie Data 


Your Digits (all 10):|]5125558989| x 
Skill Level: 


| os 


Table 4.586 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
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<!DOCTYPE html> 
<!-- cookieDataEntry.html --> 
<html> 
<head> 
<title>Enter Cookie Data</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Enter Cookie Data</hi> 
<form action="cookieCreator.jsp" method="GET"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</txr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tz> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="coral color" 
value="Create Cookies"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 
<!-- cookieDataEntry.html --> 
<html> 
<head> 
<title>Enter Cookie Data</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Enter Cookie Data</hli> 
<form action="cookieCreator.jsp" method="GET"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tz> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="coral color" 
value="Create Cookies"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 
<!-- cookieDataEntry.html --> 
<html> 
<head> 
<title>Enter Cookie Data</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Enter Cookie Data</hi> 
<form action="cookieCreator.jsp" method="GET"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</txr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tz> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="coral color" 
value="Create Cookies"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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Image 5 . Code - cookieDataEntry.html 
| P| <!DOCTYPE html> | 
2| <!-- cookieDataEntry.html --> 
3| <html> 
4| <head> 
a <title>Enter Cookie Data</title> 
6 <link rel="stylesheet" href="css/css-3.css"> 
7| </head> 
8| <body> 
9| <div class="center"> 
10| <hi>Enter Cookie Data</hi> 
11| <form action="cookieCreator.jsp" method="GET"> 
12 <table class="inline-block"> 
13 <tr><th id="th-id1" colspan="2">Student Information</th></tr> 
14 <tr> 
15 <td>First Name:</td> 
16 <td><input type="text" name="firstName"></td> 
17 </tr> 
18 <tr> 
19 <td>Last Name:</td> 
20 <td><input type="text" name="lastName"></td> 
21 </tr> 
22 <tr> 
23 <td>Your Digits (all 10):</td> 
24 <td><input type="text" name="phoneNumber"></td> 
25 </tr> 
26 <tr> 
27 <td>Skill Level:</td> 
28 <td><select name="skillLevel"> 
29 <option value="beginner">Beginner</option> 
30 <option value="intermediate">Intermediate</option> 
as <option value="expert">Expert</option> 
32 </select> 
33 </td> 
34 </tr> 
35 <tr> 
36 <td></td> 
37 <td><br><input type="submit" class="coral cc p" 
38 value="Create Cookies"></td> 
39 </tr> 
40 </table> 
41| </form> 
42| </div> 
43| </body> 
44| </html> 
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Table 4.587 


?firstName=Ada&ilastName=Lovelace&phoneNumber=5125558989&iskillLevel=beginneie®) 
Á I | 


Four Cookies Created 


1. First Name: Lovelace 

2. Last Name: Ada 

3. Phone Number: 5125558989 
4. Skill Level: beginner 


_Back to Cookie & Session Main | 
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?firstName=Ada&ilastName=Lovelace&phoneNumber=5125558989&skillLevel=beginneie®) 


Four Cookies Created 


1. First Name: Lovelace 

2. Last Name: Ada 

3. Phone Number: 5125558989 
4. Skill Level: beginner 


_Back to Cookie & Session Main | 
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?firstName=Ada&ilastName=Lovelace&iphoneNumber=5125558989&iskillLevel=beginneie®) 


Four Cookies Created 


1. First Name: Lovelace 

2. Last Name: Ada 

3. Phone Number: 5125558989 
4. Skill Level: beginner 


_Back to Cookie & Session Main | 
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Image 6 . Output - cookieCreator.jsp 
firstName=Ada&lastName=Lovelace&iphoneNumber=5125558989&iskillLevel= beginner ®) 


Four Cookies Created 


1. First Name: Lovelace 

2. Last Name: Ada 

3. Phone Number: 5125558989 
4. Skill Level: beginner 


_Back to Cookie & Session Main | 
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<!DOCTYPE html> 
<!-- cookieCreator. 
<html> 
<head> 
<title>Cookies that were Created</title> 
<link rel="stylesheet" href="css/css-3.css"> 
<style type="text/css"> 
ol { margin-left: 80px; } 
li { font-size: 2em; text-align: left;} 
p { font-size: lem; line-height: 17} 
</style> 
</head> 
<%@ include file="cookieCreatorProcessor.jsp" %> 
<body> 
<div class="center"> 
<hi>Four Cookies Created</hi> 
<ol> 
<li><p><b>First Name:</b> 
<%= request.getParameter("lastName") $> 
</p></1i> 
<li><p><b>Last Name:</b> 
<= request.getParameter ("firstName")%> 
</p></1i> 
<1i><p><b>Phone Number:</b> 
<%= request.getParameter ("phoneNumber") $> 
</p></ li> 
<1i><p><b>Skill Level:</b> 
<%= request.getParameter ("skillLevel")%> 
</p></1li> 
</ol> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color">Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
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<!DOCTYPE html> 
<!-- cookieCreator. 
<html> 
<head> 
<title>Cookies that were Created</title> 
<link rel="stylesheet" href="css/css-3.css"> 
<style type="text/css"> 
ol { margin-left: 80px; } 
li { font-size: 2em; text-align: left;} 
p { font-size: lem; line-height: 17} 
</style> 
</head> 
<%@ include file="cookieCreatorProcessor.jsp" %> 
<body> 
<div class="center"> 
<hi>Four Cookies Created</hi> 
<ol> 
<li><p><b>First Name:</b> 
<%= request.getParameter("lastName") $> 
</p></1i> 
<li><p><b>Last Name:</b> 
<= request.getParameter ("firstName")%> 
</p></1i> 
<li><p><b>Phone Number:</b> 
<%= request.getParameter ("phoneNumber") $> 
</p></ li> 
<li><p><b>Skill Level:</b> 
<%= request.getParameter ("skillLevel")$> 
</p></li> 
</ol> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color">Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 
<!-- cookieCreator. 
<html> 
<head> 
<title>Cookies that were Created</title> 
<link rel="stylesheet" href="css/css-3.css"> 
<style type="text/css"> 
ol { margin-left: 80px; } 
li { font-size: 2em; text-align: left;} 
p { font-size: lem; line-height: 17} 
</style> 
</head> 
<%@ include file="cookieCreatorProcessor.jsp" %> 
<body> 
<div class="center"> 
<hi>Four Cookies Created</hi> 
<ol> 
<li><p><b>First Name:</b> 
<%= request.getParameter("lastName") $> 
</p></1i> 
<li><p><b>Last Name:</b> 
<= request.getParameter ("firstName")%> 
</p></1i> 
<1i><p><b>Phone Number:</b> 
<%= request.getParameter ("phoneNumber") $> 
</p></ li> 
<1i><p><b>Skill Level:</b> 
<%= request.getParameter ("skillLevel")%> 
</p></1li> 
</ol> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color">Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 
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Image 7 . Code - cookieCreator.jsp 


<!DOCTYPE html> 
<!-- cookieCreat 
<html> 
<head> 
<title>Cookies that were Created</title> 
<link rel="stylesheet" href="css/css-3.css"> 
<style type="text/css"> 
ol { margin-left: 80px; } 
li { font-size: 2em; text-align: left;} 
p { font-size: lem; line-height: 1;} 
</style> 
</head> 
<%@ include file="cookieCreatorProcessor.jsp" %> 
<body> 
<div class="center"> 
<hi>Four Cookies Created</hi> 
<ol> 
<li><p><b>First Name:</b> 
<%= request.getParameter("lastName") $> 
</p></li> 
<li><p><b>Last Name:</b> 
<%= request.getParameter ("firstName") $> 
</p></1i> 
<1i><p><b>Phone Number:</b> 
<%= request.getParameter ("phoneNumber") $> 
</p></1li> 
<1i><p><b>Skill Level:</b> 
<%= request.getParameter ("skillLevel")%> 
</p></li> 
</ol> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color">Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 
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$> 
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// Create four cookies from Request object 

Cookie firstName = new Cookie("firstName", 
request.getParameter ("firstName")); 

Cookie lastName = new Cookie("lastName", 
request.getParameter ("lastName")); 

Cookie phoneNumber = new Cookie ("phoneNumber", 
request.getParameter ("phoneNumber")); 

Cookie skillLevel = new Cookie ("skillLevel", 
request.getParameter ("skillLevel")); 

// Set expiration dates to 24 hours 

firstName.setMaxAge (60*60*24) ; 

lastName.setMaxAge (60*60*24) ; 

phoneNumber. setMaxAge (60*60*24) ; 

skillLevel.setMaxAge (60*60*24) ; 

// Add cookies to Response object - back to browser 

response. addCookie (firstName); 

response. addCookie (lastName); 

response .addCookie (phoneNumber) ; 

response.addCookie (skilliLevel) ; 
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// Create four cookies from Request object 
Cookie firstName = new Cookie("firstName", 
request.getParameter ("firstName"))-; 
Cookie lastName = new Cookie("lastName", 
request.getParameter ("lastName")); 
Cookie phoneNumber = new Cookie ("phoneNumber", 
request.getParameter ("phoneNumber") ); 
Cookie skillLevel = new Cookie ("skillLevel", 
request.getParameter ("skillLevel")); 
// Set expiration dates to 24 hours 
firstName.setMaxAge (60*60*24) ; 
lastName.setMaxAge (60*60*24) ; 
phoneNumber. setMaxAge (60*60*24) ; 
skillLevel.setMaxAge (60*60*24) ; 


// Add cookies to Response object - back to browser 


response .addCookie (firstName); 
response. addCookie (lastName); 
response. addCookie (phoneNumber) ; 
response .addCookie (skilliLevel); 
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// Create four cookies from Request object 

Cookie firstName = new Cookie("firstName", 
request.getParameter ("firstName")); 

Cookie lastName = new Cookie("lastName", 
request.getParameter ("lastName")); 

Cookie phoneNumber = new Cookie ("phoneNumber", 
request.getParameter ("phoneNumber")); 

Cookie skillLevel = new Cookie ("skillLevel", 
request.getParameter ("skillLevel")); 

// Set expiration dates to 24 hours 

firstName.setMaxAge (60*60*24) ; 

lastName.setMaxAge (60*60*24) ; 

phoneNumber. setMaxAge (60*60*24) ; 

skillLevel.setMaxAge (60*60*24) ; 

// Add cookies to Response object - back to browser 

response. addCookie (firstName); 

response. addCookie (lastName); 

response .addCookie (phoneNumber) ; 

response.addCookie (skilliLevel) ; 
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Image 8 . Code - cookieCreatorProcessor.jsp 
Q <!-- cookieCreatorProcessor.jsp -- 
2| <$ 
3 // Create four cookies from Request object 
4 Cookie firstName = new Cookie("firstName", 
5 request.getParameter ("firstName")); 
6 Cookie lastName = new Cookie("lastName", 
7 request.getParameter ("lastName")); 
8 Cookie phoneNumber = new Cookie ("phoneNumber", 
9 request.getParameter ("phoneNumber")); 
10 Cookie skillLevel = new Cookie("skillLevel", 
11 request.getParameter("skillLevel")); 
12 // Set expiration dates to 24 hours 
13 firstName.setMaxAge (60*60*24) > 
14 lastName.setMaxAge (60*60*24); 
15 phoneNumber. setMaxAge (60*60*24) ; 
16 skillLevel.setMaxAge (60*60*24) ; 
a // Add cookies to Response object - back to browser 
18 response.addCookie (firstName) ; 
19 response .addCookie (lastName); 
20 response. addCookie (phoneNumber) ; 
21 response.addCookie (skillLevel); 
22, > 
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Reading Cookies 


Found Cookies: Name --- Value 


Name: JSESSIONID --- Value: 
18BBD60D8A1163790F3D7A000C66F562 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name: phoneNumber --- Value: 5125558989 


Name: skillLevel --- Value: beginner 
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Reading Cookies 


Found Cookies: Name --- Value 


Name: JSESSIONID --- Value: 
18BBD60D8A1163790F3D7A000C66F562 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name: phoneNumber --- Value: 5125558989 


Name: skillLevel --- Value: beginner 
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Reading Cookies 


Found Cookies: Name --- Value 


Name: JSESSIONID --- Value: 
18BBD60D8A1163790F3D7A000C66F562 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name: phoneNumber --- Value: 5125558989 


Name: skillLevel --- Value: beginner 
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Image 9 . Output - readingCookies.jsp 


Reading Cookies 


Found Cookies: Name --- Value 


Name: JSESSIONID --- Value: 
18BBD60D8A1163790F3D7A000C66F562 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name: phoneNumber --- Value: 5125558989 


Name: skillLevel --- Value: beginner 


Table 4.591 
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<!DOCTYPE html> 
<!-- readingCookies.jsp --> 
<html> 
<head> 

<title>Reading Cookies</titie> 

<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Reading Cookies</hi> 
<$ 

Cookie cookies[] = null; 

// Get an array of Cookies associated with this domain 

cookies = request.getCookies(); 

if( cookies != null ){ 

out.printin("<h2 class=\"blue_color\"> " 


+ "Found Cookies: Name --- Value</h2>"); 
for (int i = 0; i < cookies.length; i++){ 
out.print ("<h3>Name: " + cookies[i].getName( ) +" --- "); 
out.print("Value: " + cookies[i].getValue( )+"</h3>"); 
} 
}else{ 
out.printin("<h2>No cookies founds</h2>"); 
} 
$> 


<button onclick="location.href='cookiesAndSessions.html'" class="coral color"> 
Back to Cookie & Session Main</button> 

</div> 

</body> 

</html> 
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1| <!DOCTYPE html> 

2| <i-— readingCookies.jsp --> 

3| <html> 

4 <head> 

5| <title>Reading Cookies</title> 

6 <link rel="stylesheet" href="css/css-3.css"> 

7, </head> 

8| <body> 

9| <div class="center"> 

10 <hi>Reading Cookies</ni> 

11) <$ 

12, Cookie cookies[] = null; 

13 // Get an array of Cookies associated with this domain 

14) cookies = request.getCookies(); 

15) if( cookies != null ){ 

16 out.printin("<h2 class=\"blue_ color\"> " 

17] + "Found Cookies: Name --- Value</h2>"); 

18 for (int i = 0; i < cookies.length; i++) { 

19 out.print ("<h3>Name: " + cookies[i].getName( ) +" --- "); 
20| out.print ("Value: " + cookies[i].getValue( )+"</h3>"); 
21| } 

22| }else{ 

23| out.printin("<h2>No cookies founds</h2>"); 

24 } 

25| $> 

26| <button onclick="location.href='cookiesAndSessions.html'" class="coral_color"> 
27| Back to Cookie & Session Main</button> 

28| </div> 

29| </body> 

30) </html> 
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<!DOCTYPE html> 
<!-- readingCookies.jsp --> 
<html> 
<head> 

<title>Reading Cookies</titie> 

<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Reading Cookies</hi> 
<$ 

Cookie cookies[] = null; 

// Get an array of Cookies associated with this domain 

cookies = request.getCookies(); 

if( cookies != null ){ 

out.printin("<h2 class=\"blue_color\"> " 


+ "Found Cookies: Name --- Value</h2>"); 
for (int i = 0; i < cookies.length; i++){ 
out.print ("<h3>Name: " + cookies[i].getName( ) +" --- "); 
out.print("Value: " + cookies[i].getValue( )+"</h3>"); 
} 
}else{ 
out.printin("<h2>No cookies founds</h2>"); 
} 
$> 


<button onclick="location.href='cookiesAndSessions.html'" class="coral color"> 
Back to Cookie & Session Main</button> 

</div> 

</body> 

</html> 
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Image 10 . Code - readingCookies.jsp 
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<!DOCTYPE html> 
<html> 
<head> 

<title>Reading Cookies</title> 

<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Reading Cookies</hi> 
<$% 

Cookie cookies{] = null; 


Get an array of Cookies associated with this domain 
cookies = request.getCookies(); 
if( cookies != null ){ 

out.printin("<h2 class=\"blue_ color\"> " 
+ "Found Cookies: Name --- Value</h2>"); 
for (int i = 0; i < cookies.length; i++){ 
out.print ("<h3>Name: " + cookies[i].getName( ) +" --- "); 
out.print ("Value: " + cookies[i].getValue( )+"</h3>"); 
} 
}else{ 
out.printiln("<h2>No cookies founds</h2>"); 
} 
$> 
<button onclick="location.href='cookiesAndSessions.html'" class="coral_color"> 
Back to Cookie & Session Main</button> 

</div> 

</body> 

</htmi> 


Table 4.592 
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Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name : phoneNumber --- Value: 5125558989 


Deleted cookie: skillLevel 


Name : skillLevel --- Value: expert 
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Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name : phoneNumber --- Value: 5125558989 


Deleted cookie: skillLevel 


Name : skillLevel --- Value: expert 
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Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name : phoneNumber --- Value: 5125558989 


Deleted cookie: skillLevel 


Name : skillLevel --- Value: expert 
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2500 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Image 11 . Output - deletingCookie.jsp (part 1 of 2) 


Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name : firstName --- Value: Ada 
Name : lastName --- Value: Lovelace 
Name : phoneNumber --- Value: 5125558989 


Deleted cookie: skillLevel 


Name : skillLevel --- Value: expert 


Table 4.593 
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Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name : firstName --- Value: Ada 
Name : lastName --- Value: Lovelace 


Name : phoneNumber --- Value: 5125558989 
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Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name : firstName --- Value: Ada 
Name : lastName --- Value: Lovelace 


Name : phoneNumber --- Value: 5125558989 
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Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name : firstName --- Value: Ada 
Name : lastName --- Value: Lovelace 


Name : phoneNumber --- Value: 5125558989 
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Image 12 . Output - deletingCookie.jsp (part 2 of 2) 


Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name : firstName --- Value: Ada 
Name : lastName --- Value: Lovelace 


Name : phoneNumber --- Value: 5125558989 


Table 4.594 
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<!DOCTYPE html> 
<!-- deletingCookie.jsp --> 
<html> 
<head> 
<title>Deleting a Cookie</titile> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Deleting a Cookie</hi> 
<%@ include file="deletingCookieProcessor.jsp" %> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


<!DOCTYPE html> 
<!--— deletingCookie.jsp --> 
<html> 
<head> 
<title>Deleting a Cookie</titile> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Deleting a Cookie</ni> 
<%@ include file="deletingCookieProcessor.jsp" %> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 
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1| <!DOCTYPE html> 

2| <!-- deletingCookie.jsp --> 

3| <html> 

4 <head> 

5 <title>Deleting a Cookie</title> 

6 <link rel="stylesheet" href="css/css-3.css"> 

7 </head> 

8|! <body> 

9 <div class="center"> 

10 <hi>Deleting a Cookie</hi> 

11; <%@ include file="deletingCookieProcessor.jsp" %> 

12; <button onclick="location.href='cookiesAndSessions.html'" 
13 class="coral color" style="margin-top: 20px"> 
14 Back to Cookie & Session Main</button> 

15| </div> 

16 </body> 

17| </html> 


Image 13 . Code - deletingCookie.jsp 
| 4] <!DOCTYPE html> E 
2| <!-- deletingCookie.jsp --> 
3|; <html> 
4 <head> 
5 <title>Deleting a Cookie</title> 
6 <link rel="stylesheet" href="css/css-3.css"> 
7! </head> 
8 <body> 
9| <div class="center"> 
10! <hi>Deleting a Cookie</hi> 
11; <%@ include file="deletingCookieProcessor.jsp" %> 
12! <button onclick="location.href='cookiesAndSessions.html'" 
13 class="coral color" style="margin-top: 20px"> 
14 Back to Cookie & Session Main</button> 
18. </div> 
16| </body> 
17, </html> 
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<!-- deletingCookieProcessor.jsp --> 
<$% 
Cookie cookies[] = null; 
cookies = request.getCookies(); 
if( cookies != null )f{ 
out.printin("<h2 class=\"blue_color\">Discovered Cookies</h2>") >; 
for (int i = 0; i < cookies.length; i++) { 
// Deleted cookie still in cookies[] array ist time through 
// Deleted cookie removed from cookies[{] > ist time through 
if((cookies[{i}].getName( )).compareTo("skillLevel") == 0 ){ 
cookies [i] .setMaxAge (0); // MaxAge=0 deletes cookie 
response .addCookie (cookies[i]); // Back to browser 
out.print ("<h3 class=\"red_ color\">Deleted cookie: " 
+ cookies[{i].getName( ) + "</h3>"); 


} 
out.print ("<h3>Name : " + cookies[i].getName( ) + " --- "); 
out.print("Value: " + cookies[i].getValue( )+" </h3>"); 
} 
}else{ 
out.println("<h2>No cookies found</h2>"); 


} 
for (int i = 0; i < cookies.length; i++){ 
// Deleted cookie still in cookies[{] array ist time through 
// Deleted cookie removed from cookies[] > ist time through 
if ((cookies[i].getName( )).compareTo("skillLevel") == 0){ $> 
<button onClick="history.go(0)" 
class="coral color" style="margin-top: 20px"> 
See Cookie Removed</button><br> 
<% } 
} &> 
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Q <!-- deletingCookieProcessor.jsp --> 

2| <$% 

3| Cookie cookies[] = null; 

4| cookies = request.getCookies(); 

5| if( cookies != null ){ 

6 out. .println("<h2 class=\"blue_color\">Discovered Cookies</h2>"); 
7 for (int i = 0; i < cookies.length; i++) { 

8 // Deleted cookie still in cookies[] array ist time through 
9 // Deleted cookie removed from cookies[{] > ist time through 
10 if((cookies[{i}].getName( )).compareTo("skillLevel") == 0 ){ 
F cookies [i] .setMaxAge (0); // MaxAge=0 deletes cookie 

12 response.addCookie (cookies[i]); // Back to browser 

13 out.print ("<h3 class=\"red color\">Deleted cookie: " 

14 + cookies[i].getName( ) + "</h3>"); 

15 } 

16 out.print ("<h3>Name : " + cookies[i].getName( ) + " --- "); 
17 out.print("Value: " + cookies[i].getValue( )+" </h3>"); 

18 } 

19| }elsef 

20 out.println("<h2>No cookies found</h2>"); 

21| } 

22| for (int i = 0; i < cookies.length; i++){ 

23 // Deleted cookie still in cookies[{] array ist time through 

24 // Deleted cookie removed from cookies[] > ist time through 

25 if ((cookies[i].getName( )).compareTo("skillLevel") == 0){ $> 
26 <button onClick="history.go(0)" 

oy class="coral color" style="margin-top: 20px"> 

28 See Cookie Removed</button><br> 

29 <% } 

30| } %> 
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<!-- deletingCookieProcessor.jsp --> 
<$% 
Cookie cookies[] = null; 
cookies = request.getCookies(); 
if( cookies != null )f{ 
out.printin("<h2 class=\"blue_color\">Discovered Cookies</h2>") >; 
for (int i = 0; i < cookies.length; i++) { 
// Deleted cookie still in cookies[] array ist time through 
// Deleted cookie removed from cookies[{] > ist time through 
if((cookies[{i}].getName( )).compareTo("skillLevel") == 0 ){ 
cookies [i] .setMaxAge (0); // MaxAge=0 deletes cookie 
response .addCookie (cookies[i]); // Back to browser 
out.print ("<h3 class=\"red_ color\">Deleted cookie: " 
+ cookies[{i].getName( ) + "</h3>"); 


} 
out.print ("<h3>Name : " + cookies[i].getName( ) + " --- "); 
out.print("Value: " + cookies[i].getValue( )+" </h3>"); 
} 
}else{ 
out.println("<h2>No cookies found</h2>"); 


} 
for (int i = 0; i < cookies.length; i++){ 
// Deleted cookie still in cookies[{] array ist time through 
// Deleted cookie removed from cookies[] > ist time through 
if ((cookies[i].getName( )).compareTo("skillLevel") == 0){ $> 
<button onClick="history.go(0)" 
class="coral color" style="margin-top: 20px"> 
See Cookie Removed</button><br> 
<% } 
} &> 
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Image 14 Code - deletingCookieProcessor.jsp 
| | Q| <!-- deletingCookieProcessor.jsp -- 

2 <$ 
3| Cookie cookies[{] = null; 
4 cookies = request.getCookies(); 
5| if( cookies != null ){ 
6 out.printin("<h2 class=\"blue color\">Discovered Cookies</h2>"); 
7 for (int i = 0; i < cookies.length; i++){ 
8 // Deleted cookie still in cookies[] array ist time through 
9 Deleted cookie removed from cookies{] > ist time through 
10 if ((cookies[{i].getName( )).compareTo("skillLevel") == 0 ){ 
11 cookies[i] .setMaxAge (0); // MaxAge=0 deletes cookie 
12 response. addCookie (cookies[i]); / Back to browser 
13 out.print ("<h3 class=\"red_ color\">Deleted cookie: " 
14 + cookies[i].getName( ) + "</h3>"); 
15 } 
16 out.print ("<h3>Name : " + cookies[i].getName( ) + " --- "); 
17 out.print("Value: " + cookies[i].getValue( )+" </h3>"); 
18 } 
19| }elsef{ 
20 out.printiln("<h2>No cookies found</h2>"); 
21 
22| for (int i = 0; i < cookies.length; i++){ 
23 // Deleted cookie still in cookies[] array ist time through 
24 / Deleted cookie removed from cookies[] > ist time through 
25 if ((cookies[i].getName( )).compareTo("skillLevel") == 0){ $> 
26 <button onClick="history.go(0)" 
@ class="coral color" style="margin-top: 20px"> 
28 See Cookie Removed</button><br> 
29 <$ } 
30 $> 
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Cookies and site data 


fitse2317-jsp 
Any kind of connection 

Yes 

Monday, November 18, 2013 11:51:32 PM 
Tuesday, November 19, 2013 11:51:32 PM 


fitse2317-jsp 

Any kind of connection 

Yes 

Monday, November 18, 2013 11:51:32 PM 
Tuesday, November 19, 2013 11:51:32 PM 
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Cookies and site data ” 


Search cookies 


Site Locally stored data 


/itse2317-jsp 

Any kind of connection 

Yes 

Monday, November 18, 2013 11:51:32 PM 
Tuesday, November 19, 2013 11:51:32 PM 


Image 15 . Cookies and Site Data 


Cookies and site data = 


Site Locally stored data 


fitse2317-jsp 

Any kind of connection 

Yes 

Monday, November 18, 2013 11:51:32 PM 
Tuesday, November 19, 2013 11:51:32 PM 


Table 4.597 


4.5.13.10 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 
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e Module name: Java4370: Cookies with JSP 
e Author: Dr. R.L.Martinez 

e Maintainer: R.G.Baldwin 

e File: Java4370.htm 

e Published: 11/27/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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4.5.14 Java4370r: Review” 
4.5.14.1 Table of Contents 


e Preface (p. 2519) 
e Background information (p. 2519) 


Create cookies (p. 2520) 
x The cookieCreatorProcessor code (p. 2520) 
Read cookies (p. 2521) 
Delete cookies (p. 2522) 
e Questions (p. 2523) 


1 (p. 2523) , 2 (p. 2523) , 3 (p. 2523) , 4 (p. 2523) , 5 (p. 2523) , 6 (p. 2524) , 7 (p. 2524) , 8 
(p. 2524) , 9 (p. 2524) , 10 (p. 2524) , 11 (p. 2524) , 12 (p. 2524) , 13 (p. 2524) , 14 (p. 2525) 


Image index (p. 2525) 
Answers (p. 2527) 
Images (p. 2528) 
Miscellaneous (p. 2587) 


4.5.14.2 Preface 


This module is one in a collection of modules on JavaServer Pages (JSP) designed for teaching ITSE2317 - 
Java Programming (Intermediate) at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4370: Cookies with 
JSPL 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 

The Images (p. 2528) section contains a number of images that you may find useful as reference material 
in answering the questions. 


4.5.14.3 Background information 


The program that is explained in Java4370: Cookies with JSP 78? is fairly complicated due mainly to the 
many parts that must work together to accomplish the desired result. Therefore, an alternate explanation 
from a more Java-centric viewpoint may be useful. 

Getting started 

The sequence of events begins when the user requests the web page shown in Image 3 (p. 2541) . This 
HTML code produces the screen output shown in Image 1 (p. 2532) . 

Six hyperlinks 

The HTML code in Image 3 (p. 2541) contains six hyperlink references. Only the first three are discussed 
in Java4370: Cookies with JSP 78 , so only those three will be discussed in this module. The last three are 
discussed in Java4380: Sessions with JSP ?84 . 

The following list shows the text content of the first three hyperlinks along with the image number 
showing the code that is executed when each hyperlink is selected in Image 1 (p. 2532) .. 


?80This content is available online at <http://cnx.org/content /m48218/1.3/>. 
81 http://cnx.org/content /m48091 /latest /?collection=col1 1441 /latest 
82http://cnx.org/content /m48091/latest /?collection=col11441/latest 
283 http://cnx.org/content /m48091 /latest /?collection=col11441 /latest 
84http://cnx.org/content /m48089/latest /?collection=col11441 /latest 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2515 


e Create Cookies - Image 5 (p. 2550) 
e Read Cookies - Image 10 (p. 2570) 
e Delete Cookies - Image 13 (p. 2580) 


4.5.14.3.1 Create cookies 


The code in Image 5 (p. 2550) is executed when the user selects the hyperlink labeled Create Cookies in 
Image 1 (p. 2532) . 

Image 5 (p. 2550) is an HTML page containing no JSP tags. It is downloaded to the browser producing 
the screen output shown in Image 4 (p. 2545) . You should recognize this as a data entry form similar to 
those that have been discussed in earlier modules. 

The value of the action attribute in the form tag near the top of Image 5 (p. 2550) tells us that the 
code in the file named cookieCreator.jsp ( Image 7 (p. 2558) ) will be executed when the user presses 
the submit button at the bottom of Image 4 (p. 2545) . 

Scrolling down through the code in Image 7 (p. 2558) , we see a JSP directive tag that causes the 
page to include the code in the file named cookieCreatorProcessor.jsp ( Image 8 (p. 2562) ) . Thus, 
the code in Image 8 (p. 2562) will be inserted into the code in Image 7 (p. 2558) at the location of the 
include directive . 


4.5.14.3.1.1 The cookieCreatorProcessor code 


Instantiate four Cookie objects 

Image 8 (p. 2562) contains a scriptlet tag containing standard Java code. 

The code in Image 8 (p. 2562) instantiates four objects of the class Cookie . Those objects are 
populated by calling the getParameter method on the request object passing the following names to 
the getParameter method: 


firstName 
lastName 
phoneNumber 
skillLevel 


The Cookie class 
The Cookie class is part of the javax.servlet.http package, which in turn is part of Java EE 7 . 
The purpose of the Cookie class is to create 


"a cookie, a small amount of information sent by a servlet to a Web browser, saved by the 
browser, and later sent back to the server." 


A name::value pair 

Once again we encounter the concept of a name::value pair . The constructor for the Cookie class 
requires two parameters of type String . The first parameter is the name that will be assigned to the new 
cookie. The second parameter is the value that will be assigned to the new cookie. 

In Image 8 (p. 2562) , we see that the name of the parameter being accessed by the getParameter 
method is assigned to the name for the new cookie. The value returned by the call to the getParameter 
method is assigned to the value for the new cookie. 

We also see in Image 8 (p. 2562) that references to the four new Cookie objects are saved in variables 
of type Cookie having the same names as described above. Note, however, that it is not necessary to use 
the same name throughout as shown in Image 8 (p. 2562) . You could use different names for the cookies 
and the variables if you choose to do so. 

Set the maximum age for each Cookie object 

The Cookie class defines several methods, including a method named setMaxAge . The setMaxAge 

method: 
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"Sets the maximum age in seconds for this Cookie. 


A positive value indicates that the cookie will expire after that many seconds have passed. Note 
that the value is the maximum age when the cookie will expire, not the cookie’s current age. 


A negative value means that the cookie is not stored persistently and will be deleted when the 
Web browser exits. A zero value causes the cookie to be deleted." 


When a cookie has expired, it will not be sent back to the website by the browser. 

The scriptlet code in Image 8 (p. 2562) calls the setMaxAge method on each of the Cookie object 
references passing 86,400 seconds (24 hours) as a parameter. This sets the maximum age for each of the 
new cookies to 24 hours. 

The request and response objects 

Backing up a bit for clarification, the JSP container on the server creates and maintains objects of the 

following two interface types: 


e ServletRequest 
e HttpServletResponse 


The ServletRequest interface is part of the javax.servlet package. The HttpServletResponse 
interface is part of the javax.servlet.http package. Both are part of Java EE 7 

(Note that these objects implement other interfaces as well.) 

Among other methods, the ServletRequest interface declares the method named getParameter 
that is called in Image 8 (p. 2562) . The getParameter method: 


"Returns the value of a request parameter as a String, or null if the parameter does not exist. 
Request parameters are extra information sent with the request. For HTTP servlets, parameters 
are contained in the query string or posted form data." 


Similarly, the HttpServletResponse interface declares a method named addCookie . The addCookie 
method: 


"Adds the specified cookie to the response. This method can be called multiple times to set 
more than one cookie." 


Add cookies to the response 

Having created four new cookies containing information obtained from the request object and setting 
the maximum age of the cookies, the code in Image 8 (p. 2562) adds the new cookies to the response 
object. This will cause them to be sent to the user’s browser where they will be saved for 24 hours unless 
purposely deleted. 

Display the parameter values 

Returning now to the file named cookieCreator.jsp shown in Image 7 (p. 2558) and scrolling down 
the page, we see four JSP expression tags that are unrelated to cookies. You have seen tags like this 
in earlier modules. They simply extract the four parameter values from the request object and cause those 
values to be displayed in the HTML ordered list shown in Image 6 (p. 2554) . 


4.5.14.3.2 Read cookies 


Selecting the hyperlink labeled Read Cookies in Image 1 (p. 2532) causes the code in the file named 
readingCookies.jsp (Image 10 (p. 2570) ) to be executed. 

A JSP scriptlet containing Java code is visible near the center of Image 10 (p. 2570) . 

An array of Cookie objects 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2517 


The scriptlet begins by declaring a reference to an array object of type Cookie named cookies 
Then the scriptlet calls the getCookies method on the request object assigning the return value to the 
variable named cookies 

In addition to implementing the ServletRequest interface, the request object also implements the 
HttpServletRequest interface. This interface declares the getCookies method, which 


"returns an array containing all of the Cookie objects the client sent with this request. This 
method returns null if no cookies were sent." 


At this point, the variable named cookies contains a reference to an array object whose elements contain 
references to individual Cookie objects. 

Display cookie names and values 

Then the scriptlet uses an if-else statement with an embedded for loop to access the names and 
values of the cookies and to send those names and values back to the browser for display as shown in Image 
9 (p. 2566) . 

(Note that calling the print or printIn methods on the reference named out causes the parameter 
to be displayed on the browser output screen. However, calling System.out.printIn causes text to be 
displayed on the server system console.) 

The for loop in Image 10 (p. 2570) calls the getName and getValue methods of the Cookie 
class to get and display the name and value for each cookie. 


4.5.14.3.3 Delete cookies 


Selecting the hyperlink labeled Delete Cookie in Image 1 (p. 2532) causes the code in the file named 
deletingCookie.jsp ( Image 13 (p. 2580) ) to be executed. 

Image 13 (p. 2580) contains a single JSP directive tag that causes the file named deletingCook- 
ieProcessor.jsp (Image 14 (p. 2584) ) to be included and executed. 

Two scriptlet tags 

Image 14 (p. 2584) contains two scriptlet tags with some ordinary HTML code in between. The first 
scriptlet tag ends on an if statement near the bottom. The second scriptlet tag appears on the final two 
lines and provides necessary closing curly brackets for the for loop and the if statement in the earlier 
scriptlet tag. 

The first scriptlet 

Beginning at the top of Image 14 (p. 2584) , the scriptlet code creates and displays the contents of an 
array of cookies and sends those cookies back to the browser, possibly modifying the maximum age in the 
process. 

Find and delete the skillLevel cookie 

An if statement inside the for loop tests the name of each cookie against "skillLevel" . If a match is 

found, the setMaxAge method for the matching cookie is called to set the maximum age to zero seconds. 
(Setting the maximum age to zero causes the cookie having that name to expire immediately when it is 
received by the browser.) 

Code in the scriptlet in Image 14 (p. 2584) also causes the message shown in red in Image 11 (p. 2574) 
to be inserted into the browser output indicating that the cookie has been deleted. The name and value of 
the deleted cookie is displayed in Image 11 (p. 2574) just like the names and values of the cookies that are 
not deleted. 

(Note that the cookie is not deleted from the server. Instead, it is caused to expire from the Browser’s 
cookie storage so that future requests from the browser will not include the deleted cookie.) 
An HTML button 

Near the end of the first scriptlet in Image 14 (p. 2584) , another for loop is used to compare the name 
of each cookie to "skillLevel". This time, if a match is found, HTML code is executed to create a button 
labeled "See Cookie Removed" as shown in Image 11 (p. 2574) . If this button is clicked, the HTML code 
shown in Image 17 (p. 2523) is executed. (Note that the style and color information was omitted from the 
HTML code in Image 17 (p. 2523) to emphasize the behavior of the button.) 
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Image 17 . HTML onClick code. 


<button onclick="history.go(0)" ... > 
See Cookie Removed 
</button> 
Table 4.598 


This HTML code causes the browser to request that the page be reloaded. By the time the reload request 
is sent to the server, the skillLevel cookie has expired from the browser and the skillLevel cookie is 
not sent to the server. Therefore, that cookie is missing from the display shown in Image 12 (p. 2578) . 

A second scriptlet tag 

As mentioned earlier, a second scriptlet tag is used at the end of the page in Image 14 (p. 2584) to 

provide the closing curly brackets required by the for loop and the if statement. 
Return to deletingCookie.jsp 

Returning from Image 14 (p. 2584) to the include directive in Image 13 (p. 2580) , we see that there 
are no more JSP tags to discuss. As mentioned earlier, the behavior of the bottom three hyperlinks in 
Image 1 (p. 2532) will be discussed in conjunction with the module named Java4380: Sessions with JSP 
285 Therefore, that concludes the background discussion of the program presented in the module named in 
Java4370: Cookies with JSP 7° . 


4.5.14.4 Questions 

4.5.14.4.1 Question 1 

True or False? HTTP is a stateless protocol. 
Go to answer 1 (p. 2528) 

4.5.14.4.2 Question 2 

True or False? HTTP has no memory of relationships between client and server. 
Go to answer 2 (p. 2528) 

4.5.14.4.3 Question 3 

True or False? Web cookies are little round edible things containing chips of chocolate. 
Go to answer 3 (p. 2528) 

4.5.14.4.4 Question 4 


True or False? Cookies are jpeg image files created on the server, sent back to the browser, and stored on 
the client. 
Go to answer 4 (p. 2528) 


4.5.14.4.5 Question 5 


Given: Previous modules have introduced the use of the name::value pair . 
True or False? Cookie format is another area where we deal with name::value pairs . 
Go to answer 5 (p. 2528) 


85 http://cnx.org/content /m48089/latest /?collection=col11441 /latest 
86http://cnx.org/content /m48091 /latest /?collection=col11441 /latest 
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4.5.14.4.6 Question 6 

True or False? Browsers often refer to value in a name::value pair as content . 
Go to answer 6 (p. 2528) 

4.5.14.4.7 Question 7 


True or False? Whenever a class such as Date or Cookie is referenced in a scriptlet, an import directive 
similar to that shown in Image 18 (p. 2524) must appear in the JSP. 


Image 18 . An import directive. 


<%@ page import="java.util.*,javax.servlet.http.*" %> 


Table 4.599 


Go to answer 7 (p. 2527) 


4.5.14.4.8 Question 8 
True or False? The getParameter method is a method of the Cookie class. 
Go to answer 8 (p. 2527) 
4.5.14.4.9 Question 9 
True or False? The addCookie method is a method of an object that implements the HttpServletRe- 
sponse interface. 
Go to answer 9 (p. 2527) 
4.5.14.4.10 Question 10 
True or False? The getCookies method is a method of the Cookie class. 
Go to answer 10 (p. 2527) 
4.5.14.4.11 Question 11 
True or False? A Cookie object provides the getName and getValue methods. 
Go to answer 11 (p. 2527) 
4.5.14.4.12 Question 12 


True or False? The constructor for the Cookie class requires two String parameters: name and value 


Go to answer 12 (p. 2527) 


4.5.14.4.13 Question 13 


True or False? The setMaxAge method of the Cookie class sets the age at which the cookie expires in 
units of days. 
Go to answer 13 (p. 2527) 
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4.5.14.4.14 Question 14 


True or False? Calling System.out.printIn inside a scriptlet causes text to be displayed by the browser. 
Go to answer 14 (p. 2527) 


4.5.14.5 Image index 


Image 1 (p. 2532) . Output - cookiesAndSessions.html 
) . Code - css-3.css 
) . Code - cookiesAndSessions.html 
) . Output - cookieDataEntry.html 
) . Code - cookieDataEntry.html 
p. 2554) . Output - cookieCreator.jsp 
) . Code - cookieCreator.jsp 
) . Code - cookieCreatorProcessor.jsp 
) . Output - readingCookies.jsp 
) . Code - readingCookies.jsp 
) . Output - deletingCookie.jsp (part 1 of 2) 
) . Output - deletingCookie.jsp (part 2 of 2) 
) . Code - deletingCookie.jsp 
Image 14 (p. 2584) . Code - deletingCookieProcessor.jsp 
) . Cookies and Site Data 
) . JSP tags. 
) . HTML onClick code. 
) . An import directive. 
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What is the meaning of the following two images? 
These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 
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None 


Display your nameshen 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Probosa.jpg -lolx 


Put your name here 
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4.5.14.6 Answers 
4.5.14.6.1 Answer 14 


False. Calling System.out.println inside a scriptlet causes text to be displayed on the server system 
console. To cause text to be displayed by the browser, call the print method or the println method on 
the reference variable named out 

Go back to Question 14 (p. 2525) 


4.5.14.6.2 Answer 13 
False. The setMaxAge method of the Cookie class sets the age at which the cookie expires in units of 
seconds . 

Go back to Question 13 (p. 2524) 
4.5.14.6.3 Answer 12 
True 

Go back to Question 12 (p. 2524) 
4.5.14.6.4 Answer 11 
True. 

Go back to Question 11 (p. 2524) 
4.5.14.6.5 Answer 10 


False. The getCookies method is a method of an object that implements the HttpServlet Request 
interface. 
Go back to Question 10 (p. 2524) 


4.5.14.6.6 Answer 9 
True. 
Go back to Question 9 (p. 2524) 


4.5.14.6.7 Answer 8 


False. The getParameter method is a method of an object that implements the ServletRequest 
interface. 
Go back to Question 8 (p. 2524) 


4.5.14.6.8 Answer 7 


False. According to the Default Package Imports 7°” documentation, by default, the JSP container imports 
the following packages into any JSP page, in accordance with the JSP specification. No page directive import 
settings are required for classes contained in these packages: 


e javax.servlet.* 
e javax.servlet.http.* 
e javax.servlet..jsp.* 


87http://docs.oracle.com/cd/A97688_16/generic.903/a97679/getstart.htm1007970 
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The Cookie class is contained in the javax.servlet.http package and therefore does not require an 
import directive. However, the Date class is not contained in one of the three packages listed above and 
does require an import directive. 

Go back to Question 7 (p. 2524) 


4.5.14.6.9 Answer 6 
True. 

Go back to Question 6 (p. 2524) 
4.5.14.6.10 Answer 5 
True. 

Go back to Question 5 (p. 2523) 
4.5.14.6.11 Answer 4 


False. Cookies are simply small text files created on the server, sent back to the browser, and stored on the 
client. During a connection in the future, browsers can send the cookie information to the server so it can 
be identified and the user experience customized. 

Go back to Question 4 (p. 2523) 


4.5.14.6.12 Answer 3 


False. The server, with HTTP alone, records (or persists) no data about the client. Each client request to the 
server receives response(s) from the server and then the relationship is terminated. Often, web developers 
would like to retain information about the client so when the user returns to the site, the server can respond 
with custom content based on the identity of the client. A common and convenient way for this to occur is 
through the use of cookies. 

Go back to Question 3 (p. 2523) 


4.5.14.6.13 Answer 2 
True. 

Go back to Question 2 (p. 2523) 
4.5.14.6.14 Answer 1 
True. 

Go back to Question 1 (p. 2523) 
4.5.14.7 Images 


This section contains images that may be referred to by more than one question or answer. These images 
may also be helpful as reference material for answering the questions. Many of them were copied directly 
from Java4370: Cookies with JSP 78° . Other images may be interspersed within the questions and answers. 


88http://cnx.org/content /m48091/latest /?collection=col11441/latest 
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Cookies and Sessions 


Create af “ookies 
Read Cookies 
Delete Cookie 
View Session Data 
Delete Session Attribute 
Delete Session Object 
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Create,Cookies 
Read Cookies 
Delete Cookie 


View Session Data 


Delete Session Attribute 


Delete Session Object 
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Cookies and Sessions 


Create af “ookies 
Read Cookies 
Delete Cookie 
View Session Data 
Delete Session Attribute 
Delete Session Object 
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Image 1 . Output - cookiesAndSessions.html 


Cookies and Sessions 


f ‘ookies 
Read Cookies 
Delete Cookie 

View Session Data 

Delete Session Attribute 


Delete Session Object 


o Eee Spee 
( Teale 


Table 4.600 
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1| /* css-3.css */ 

2 /* For HTMLS shiv */ 

3| article, aside, figure, footer, header, hgroup, 
4| menu, nav, section { display: block; } 
5| body { 

6 width: 70%; 

T margin: 0 auto; 

8 text-align: center; 

9 background-color: gainsboro; 
10| } 

TH ul { 

12 text-align: left; 

13] } 

14| table, th, td 

15| í 

16 border:1px solid black; 
17| } 

18| af 

19 text-decoration: none; 
20, 3} 

21| a:hover 

22) í 

23 background-color: yellow; 
24 } 

25| pf 

26 font-size: 2em; 

27 margin: 10px Opx; 

28| } 

29| button { 

30 font-size: 1.2em; 

31 margin-top: 10px; 

32| } 

33 -inline-block { 

34 display: inline-table; 
35| } 

36| .center { 

37 width: 525px; 

38 margin: 0 auto; 

39| } 

40| .coral_color{ 

41 background-color: coral; 
42| } 

43 -blue_color { 

44 color: blue; 

45| } 

46| .red color { 

47 color: red; 

48 } 

49| #th-id1 { 

50 background-color: plum; 
Si; } 
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1| /* css-3.css */ 

2 /* For HIMLS shiv */ 

3| article, aside, figure, footer, header, hgroup, 
4| menu, nav, section { display: block; } 
5| body { 

6 width: 70%; 

T margin: 0 auto; 

8 text-align: center; 

9 background-color: gainsboro; 
10| } 

TH ul { 

12 text-align: left; 

13] } 

14| table, th, td 

15| í 

16 border:1px solid black; 
17| } 

18| af 

19 text-decoration: none; 
20, 3} 

21| a:hover 

22) í 

23 background-color: yellow; 
24 } 

25| pf 

26 font-size: 2em; 

27 margin: 10px Opx; 

28| } 

29| button { 

30 font-size: 1.2em; 

31 margin-top: 10px; 

32| } 

33 -inline-block { 

34 display: inline-table; 
35| } 

36| .center { 

37 width: 525px; 

38 margin: 0 auto; 

39| } 

40| .coral_color{ 

41 background-color: coral; 
42| } 

43 -blue_color { 

44 color: blue; 

45| } 

46| .red color { 

47 color: red; 

48 } 

49| #th-id1 { 

50 background-color: plum; 
Si; } 
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1| /* css-3.css */ 

2 /* For HIMLS shiv */ 

3| article, aside, figure, footer, header, hgroup, 
4| menu, nav, section { display: block; } 
5| body { 

6 width: 70%; 

T margin: 0 auto; 

8 text-align: center; 

9 background-color: gainsboro; 
10| } 

TH ul { 

12 text-align: left; 

13] } 

14| table, th, td 

15| í 

16 border:1px solid black; 
17| } 

18| af 

19 text-decoration: none; 
20, 3} 

21| a:hover 

22) í 

23 background-color: yellow; 
24 } 

25| pf 

26 font-size: 2em; 

27 margin: 10px Opx; 

28| } 

29| button { 

30 font-size: 1.2em; 

31 margin-top: 10px; 

32| } 

33 -inline-block { 

34 display: inline-table; 
35| } 

36| .center { 

37 width: 525px; 

38 margin: 0 auto; 

39| } 

40| .coral_color{ 

41 background-color: coral; 
42| } 

43 -blue_color { 

44 color: blue; 

45| } 

46| .red color { 

47 color: red; 

48 } 

49| #th-id1 { 

50 background-color: plum; 
Si; } 
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Image 2 . Code - css-3.css 
J| /* * 
2 * For F 55 shiv * 
3| article, aside, figure, footer, header, hgroup, 
4| menu, nav, section { display: block; } 
5| body { 
6 width: 70%; 
7 margin: 0 auto; 
& text-align: center; 
9 background-color: gainsboro; 
10| } 
11| ul { 
12 text-align: left; 
13| } 
14| table, th, td 
15; í 
16 border:1px solid black; 
17| 3} 
18| af 
19 text-decoration: none; 
20| } 
21| a:hover 
22 í 
23 background-color: yellow; 
24 } 
25| pf 
26 font-size: 2em; 
27 margin: 10px Opx; 
28| } 
29| button { 
30 font-size: 1.2em; 
31 margin-top: 10px; 
32| } 
33 -inline-block { 
34 display: inline-table; 
35| } 
36| .center { 
37 width: 525px; 
38 margin: 0 auto; 
39| } 
40 -coral_color{ 
41 background-color: coral; 
42| } 
43 -blue_color { 
44 color: blue; 
45| } 
46, .red color { 
47 color: red; 
48 } 
49| #th-idi { 
50 background-color: plum; 
51| } 
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Table 4.601 
<!DOCTYPE html> 
<!-- cookiesAndSessions.html --> 
<html> 
<head> 


<title>Cookies and Sessions</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class=" center"> 
<hi>Cookies and Sessions</hi> 
</div> 
<p><a href="cookieDataEntry.html">Create Cookies</a></p> 
<p><a href="readingCookies.jsp">Read Cookies</a></p> 
<p><a href="deletingCookie.jsp">Delete Cookie</a></p> 
<p><a href="viewSessionData.jsp">View Session Data</a></p> 
<p><a href="deleteSessionAttribute.jsp">Delete Session Attribute</a></p> 
<p><a href="deleteSessionObject.jsp">Delete Session Object</a></p> 
</body> 
</html> 


<!DOCTYPE html> 
<!-- cookiesAndSessions.html --> 
<html> 
<head> 
<title>Cookies and Sessions</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Cookies and Sessions</hi> 
</div> 
<p><a href="cookieDataEntry.html">Create Cookies</a></p> 
<p><a href="readingCookies.jsp">Read Cookies</a></p> 
<p><a href="deletingCookie.jsp">Delete Cookie</a></p> 
<p><a href="viewSessionData.jsp">View Session Data</a></p> 
<p><a href="deleteSessionAttribute.jsp">Delete Session Attribute</a></p> 
<p><a href="deleteSessionObject.jsp">Delete Session Object</a></p> 
</body> 
</html> 
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1| <!DOCTYPE html> 
2| <!-- cookiesAndSessions.html --> 
3| <html> 
4| <head> 
5 <title>Cookies and Sessions</titie> 
6 <link rel="stylesheet" href="css/css-3.css"> 
7| </head> 
8| <body> 
9 <div class="ci £ 
10 <hi>Cookies and Sessions</h1> 
11 </div> 
12 <p><a href="cookieDataEntry.html">Create Cookies</a></p> 
13 <p><a href="readingCookies.jsp">Read Cookies</a></p> 
14 <p><a href="deletingCookie.jsp">Delete Cookie</a></p> 
15 <p><a href="viewSessionData.jsp">View Session Data</a></p> 
16 <p><a href="deleteSessionAttribute.jsp">Delete Session Attribute</a></p> 
$? <p><a href="deleteSessionObject.jsp">Delete Session Object</a></p> 
18| </body> 
19| </html> 
Image 3 . Code - cookiesAndSessions.html 
| a] <!DOCTYPE html> 
2 <!-- cookiesAndSessions.html --> 
3| <html> 
4| <head> 
5 <title>Cookies and Sessions</title> 
6 <link rel="stylesheet" href="css/css-3.css"> 
7| </head> 
8| <body> 
9 <div class="¢i BY 
10 <hi>Cookies and Sessions</hi> 
11 </div> 
12 <p><a href="cookieDataEntry.html">Create Cookies</a></p> 
13 <p><a href="readingCookies.jsp">Read Cookies</a></p> 
14 <p><a href="deletingCookie.jsp">Delete Cookie</a></p> 
15 <p><a href="viewSessionData.jsp">View Session Data</a></p> 
16 <p><a href="deleteSessionAttribute.jsp">Delete Session Attribute</a></p> 
17 <p><a href="deleteSessionObject.jsp">Delete Session Object</a></p> 
18| </body> 
19| </html> 


Table 4.602 
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Enter Cookie Data 


Your Digits (all 10) 


|r a | 
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Enter Cookie Data 


Your Digits (all 10) 


|r a | 
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Enter Cookie Data 


Your Digits (all 10) 


|r a | 
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Image 4 . Output - cookieDataEntry.html 


Enter Cookie Data 


Your Digits (all 10): 


Skill Level: Beginner V 


O 


Table 4.603 
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<!DOCTYPE html> 
<!-- cookieDataEntry.html --> 
<html> 
<head> 
<title>Enter Cookie Data</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Enter Cookie Data</hli> 
<form action="cookieCreator.jsp" method="GET"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tz> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="coral color" 
value="Create Cookies"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


<!DOCTYPE html> 
<!-- cookieDataEntry.html --> 
<html> 
<head> 
<title>Enter Cookie Data</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Enter Cookie Data</hi> 
<form action="cookieCreator.jsp" method="GET"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</txr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tz> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="coral color" 
value="Create Cookies"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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<!DOCTYPE html> 
<!-- cookieDataEntry.html --> 
<html> 
<head> 
<title>Enter Cookie Data</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Enter Cookie Data</hli> 
<form action="cookieCreator.jsp" method="GET"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
</tr> 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tz> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 
<option value="intermediate">Intermediate</option> 
<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="coral color" 
value="Create Cookies"></td> 
</tr> 
</table> 
</form> 
</div> 
</body> 
</html> 
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Image 5 . Code - cookieDataEntry.html 


1 
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<!DOCTYPE html> 
<!-- cookieDataEntry.html --> 
<html> 
<head> 
<title>Enter Cookie Data</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Enter Cookie Data</hi> 
<form action="cookieCreator.jsp" method="GET"> 
<table class="inline-block"> 
<tr><th id="th-idi" colspan="2">Student Information</th></tr> 
<tr> 
<td>First Name:</td> 
<td><input type="text" name="firstName"></td> 
Sfert 
<tr> 
<td>Last Name:</td> 
<td><input type="text" name="lastName"></td> 
</tr> 
<tr> 
<td>Your Digits (all 10):</td> 
<td><input type="text" name="phoneNumber"></td> 
</tr> 
<tr> 
<td>Skill Level:</td> 
<td><select name="skillLevel"> 
<option value="beginner">Beginner</option> 


<option value="intermediate">Intermediate</option> 


<option value="expert">Expert</option> 
</select> 
</td> 
</tr> 
<tr> 
<td></td> 
<td><br><input type="submit" class="coral 


value="Create Cookies"></td> 


</tr> 

</table> 
</form> 
</div> 
</body> 
</html> 
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Table 4.604 


?firstName=Ada&ilastName=Lovelace&phoneNumber=5125558989&iskillLevel=beginneie®) 
i | 


Four Cookies Created 


1. First Name: Lovelace 

2. Last Name: Ada 

3. Phone Number: 5125558989 
4. Skill Level: beginner 


_Back to Cookie & Session Main | 
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?firstName=Ada&ilastName=Lovelace&iphoneNumber=5125558989&iskillLevel=beginneie®) 


Four Cookies Created 


1. First Name: Lovelace 

2. Last Name: Ada 

3. Phone Number: 5125558989 
4. Skill Level: beginner 


_Back to Cookie & Session Main | 
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?firstName=Ada&ilastName=Lovelace&phoneNumber=5125558989&skillLevel=beginneie®) 


Four Cookies Created 


1. First Name: Lovelace 

2. Last Name: Ada 

3. Phone Number: 5125558989 
4. Skill Level: beginner 


_Back to Cookie & Session Main | 
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Image 6 . Output - cookieCreator.jsp 
firstName=Ada&lastName=Lovelace&iphoneNumber=5125558989&iskillLevel= beginner ®) 


Four Cookies Created 


1. First Name: Lovelace 

2. Last Name: Ada 

3. Phone Number: 5125558989 
4. Skill Level: beginner 


_Back to Cookie & Session Main | 
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CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


<!DOCTYPE html> 
<!-- cookieCreator. 
<html> 
<head> 
<title>Cookies that were Created</title> 
<link rel="stylesheet" href="css/css-3.css"> 
<style type="text/css"> 
ol { margin-left: 80px; } 
li { font-size: 2em; text-align: left;} 
p { font-size: lem; line-height: 17} 
</style> 
</head> 
<%@ include file="cookieCreatorProcessor.jsp" %> 
<body> 
<div class="center"> 
<hi>Four Cookies Created</hi> 
<ol> 
<li><p><b>First Name:</b> 
<%= request.getParameter("lastName") $> 
</p></1i> 
<li><p><b>Last Name:</b> 
<= request.getParameter ("firstName")%> 
</p></1i> 
<li><p><b>Phone Number:</b> 
<%= request.getParameter ("phoneNumber") $> 
</p></ li> 
<li><p><b>Skill Level:</b> 
<%= request.getParameter ("skillLevel")$> 
</p></li> 
</ol> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color">Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 
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PPPP PP PF 
OW & WN FP © 


e re 
co ~ 


OW WWW WH HH HY MY YH NY DY NH ND 
Or WON FF O WO MO DH WO & WN PAPO 


worn nD WO & WHY P 


AAA ret 


2551 


<!DOCTYPE html> 
<!-- cookieCreator. 
<html> 
<head> 
<title>Cookies that were Created</title> 
<link rel="stylesheet" href="css/css-3.css"> 
<style type="text/css"> 
ol { margin-left: 80px; } 
li { font-size: 2em; text-align: left;} 
p { font-size: lem; line-height: 17} 
</style> 
</head> 
<%@ include file="cookieCreatorProcessor.jsp" %> 
<body> 
<div class="center"> 
<hi>Four Cookies Created</hi> 
<ol> 
<li><p><b>First Name:</b> 
<%= request.getParameter("lastName") $> 
</p></1i> 
<li><p><b>Last Name:</b> 
<= request.getParameter ("firstName")%> 
</p></1i> 
<1i><p><b>Phone Number:</b> 
<%= request.getParameter ("phoneNumber") $> 
</p></ li> 
<1i><p><b>Skill Level:</b> 
<%= request.getParameter ("skillLevel")%> 
</p></1li> 
</ol> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color">Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
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CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


<!DOCTYPE html> 
<!-- cookieCreator. 
<html> 
<head> 
<title>Cookies that were Created</title> 
<link rel="stylesheet" href="css/css-3.css"> 
<style type="text/css"> 
ol { margin-left: 80px; } 
li { font-size: 2em; text-align: left;} 
p { font-size: lem; line-height: 17} 
</style> 
</head> 
<%@ include file="cookieCreatorProcessor.jsp" %> 
<body> 
<div class="center"> 
<hi>Four Cookies Created</hi> 
<ol> 
<li><p><b>First Name:</b> 
<%= request.getParameter("lastName") $> 
</p></1i> 
<li><p><b>Last Name:</b> 
<= request.getParameter ("firstName")%> 
</p></1i> 
<li><p><b>Phone Number:</b> 
<%= request.getParameter ("phoneNumber") $> 
</p></ li> 
<li><p><b>Skill Level:</b> 
<%= request.getParameter ("skillLevel")$> 
</p></li> 
</ol> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color">Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 
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Image 7 . Code - cookieCreator.jsp 
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<!DOCTYPE html> 


<!-- cookiet 


<head> 
<title>Cookies that were Created</title> 
<link rel="stylesheet" href="css/css-3.css"> 
<style type="text/css"> 
ol { margin-left: 80px; } 
li { font-size: 2em; text-align: left;} 
p { font-size: lem; line-height: 1;} 
</style> 
</head> 
<%@ include file="cookieCreatorProcessor.jsp" %> 
<body> 
<div class="center"> 
<hi>Four Cookies Created</hi> 
<ol> 
<li><p><b>First Name:</b> 
<%= request.getParameter("lastName") $> 
</p></li> 
<li><p><b>Last Name:</b> 
<%= request.getParameter ("firstName") $> 
</p></li> 
<li><p><b>Phone Number:</b> 
<%= request.getParameter ("phoneNumber") $> 
</p></1li> 
<1i><p><b>Skill Level:</b> 
<%= request.getParameter ("skillLevel")%> 
</p></li> 
</ol> 


<button onclick="location.href='cookiesAndSessions.html'" 
class="coral_ color">Back to Cookie & Session Main</button> 


</div> 
</body> 
</html> 


Table 4.606 
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CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


// Create four cookies from Request object 
Cookie firstName = new Cookie("firstName", 
request.getParameter ("firstName"))-; 
Cookie lastName = new Cookie("lastName", 
request.getParameter ("lastName")); 
Cookie phoneNumber = new Cookie ("phoneNumber", 
request.getParameter ("phoneNumber") ); 
Cookie skillLevel = new Cookie ("skillLevel", 
request.getParameter ("skillLevel")); 
// Set expiration dates to 24 hours 
firstName.setMaxAge (60*60*24) ; 
lastName.setMaxAge (60*60*24) ; 
phoneNumber. setMaxAge (60*60*24) ; 
skillLevel.setMaxAge (60*60*24) ; 


// Add cookies to Response object - back to browser 


response .addCookie (firstName); 
response. addCookie (lastName); 
response. addCookie (phoneNumber) ; 
response .addCookie (skilliLevel); 
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// Create four cookies from Request object 

Cookie firstName = new Cookie("firstName", 
request.getParameter ("firstName")); 

Cookie lastName = new Cookie("lastName", 
request.getParameter ("lastName")); 

Cookie phoneNumber = new Cookie ("phoneNumber", 
request.getParameter ("phoneNumber")); 

Cookie skillLevel = new Cookie ("skillLevel", 
request.getParameter ("skillLevel")); 

// Set expiration dates to 24 hours 

firstName.setMaxAge (60*60*24) ; 

lastName.setMaxAge (60*60*24) ; 

phoneNumber. setMaxAge (60*60*24) ; 

skillLevel.setMaxAge (60*60*24) ; 

// Add cookies to Response object - back to browser 

response. addCookie (firstName); 

response. addCookie (lastName); 

response .addCookie (phoneNumber) ; 

response.addCookie (skilliLevel) ; 
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CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


// Create four cookies from Request object 
Cookie firstName = new Cookie("firstName", 
request.getParameter ("firstName"))-; 
Cookie lastName = new Cookie("lastName", 
request.getParameter ("lastName")); 
Cookie phoneNumber = new Cookie ("phoneNumber", 
request.getParameter ("phoneNumber") ); 
Cookie skillLevel = new Cookie ("skillLevel", 
request.getParameter ("skillLevel")); 
// Set expiration dates to 24 hours 
firstName.setMaxAge (60*60*24) ; 
lastName.setMaxAge (60*60*24) ; 
phoneNumber. setMaxAge (60*60*24) ; 
skillLevel.setMaxAge (60*60*24) ; 


// Add cookies to Response object - back to browser 


response .addCookie (firstName); 
response. addCookie (lastName); 
response. addCookie (phoneNumber) ; 
response .addCookie (skilliLevel); 
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Image 8 . Code - cookieCreatorProcessor.jsp 
Q <!-- cookieCreatorProcessor.jsp --> 
2| <$ 
3 // Create four cookies from Request object 
4 Cookie firstName = new Cookie ("firstName", 
5 request.getParameter ("firstName")); 
6 Cookie lastName = new Cookie("lastName", 
7 request.getParameter ("lastName")); 
8 Cookie phoneNumber = new Cookie ("phoneNumber", 
9 request.getParameter ("phoneNumber")); 
10 Cookie skillLevel = new Cookie("skillLevel", 
11 request. a er ce tea a e 
12 / Set expiration dates to 24 hour 
13 firstName.setMaxAge (60*60*24) > 
14 lastName.setMaxAge (60*60*24); 
15 phoneNumber. setMaxAge (60*60*24) ; 
16 skillLevel.setMaxAge (60*60*24) ; 
E7 // Ada cookies to Response object - back to browser 
18 response.addCookie (firstName) ; 
19 response .addCookie (lastName); 
20 response. addCookie (phoneNumber) ; 
21 response. addCookie (skiliLevel) ; 
22, $> 


Table 4.607 
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Reading Cookies 


Found Cookies: Name --- Value 


Name: JSESSIONID --- Value: 
18BBD60D8A1163790F3D7A000C66F562 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name: phoneNumber --- Value: 5125558989 


Name: skillLevel --- Value: beginner 
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Reading Cookies 


Found Cookies: Name --- Value 


Name: JSESSIONID --- Value: 
18BBD60D8A1163790F3D7A000C66F562 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name: phoneNumber --- Value: 5125558989 


Name: skillLevel --- Value: beginner 
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Reading Cookies 


Found Cookies: Name --- Value 


Name: JSESSIONID --- Value: 
18BBD60D8A1163790F3D7A000C66F562 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name: phoneNumber --- Value: 5125558989 


Name: skillLevel --- Value: beginner 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2561 


Image 9 . Output - readingCookies.jsp 


Reading Cookies 


Found Cookies: Name --- Value 


Name: JSESSIONID --- Value: 
18BBD60D8A1163790F3D7A000C66F562 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name: phoneNumber --- Value: 5125558989 


Name: skillLevel --- Value: beginner 


Table 4.608 
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1| <!DOCTYPE html> 

2| <!-- readingCookies.jsp --> 

3| <html> 

4 <head> 

s| <title>Reading Cookies</title> 

6 <link rel="stylesheet" href="css/css-3.css"> 

7| </head> 

& <body> 

9| <div class="center"> 

10 <hi>Reading Cookies</hi> 

11, <$ 

12) Cookie cookies[] = null; 

13) // Get an array of Cookies associated with this domain 

14, cookies = request.getCookies(); 

15) if( cookies != nuill }{ 

16 out.printin("<h2 class=\"blue_color\"> " 

17) + "Found Cookies: Name --- Value</h2>"); 

18| for (int i = 0; i < cookies.length; i++){ 

19 out.print ("<h3>Name: " + cookies[i].getName( ) +" --- ")3 
20) out.print ("Value: " + cookies[i].getValue( )+"</h3>"); 
21| } 

22| }else{ 

23| out. .printin("<h2>No cookies founds</h2>"); 

24, i} 

25) $> 

26 <button onclick="location.href='cookiesAndSessions.html'" class="coral color"> 
27| Back to Cookie & Session Main</button> 

28) </div> 

29, </body> 

30| </html> 
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<!DOCTYPE html> 
<!-- readingCookies.jsp --> 
<html> 
<head> 
<title>Reading Cookies</titie> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Reading Cookies</hi> 
<$% 
Cookie cookies[] = null; 
// Get an array of Cookies associated with this domain 
cookies = request.getCookies(); 
if( cookies != null ){ 
out.printin("<h2 class=\"blue color\"> " 


+ "Found Cookies: Name --- Value</h2>"); 
for (int i = 0; i < cookies.length; i++) i{ 
out.print ("<h3>Name: " + cookies[i].getName( ) +" --- ")3 
out.print ("Value: " + cookies[i].getValue( )+"</h3>"); 
} 
telse{ 
out.printin("<h2>No cookies founds</h2>"); 
} 
> 


<button onclick="location.href='cookiesAndSessions.html'" class="coral_ color"> 
Back to Cookie & Session Main</button> 

</div> 

</body> 

</html> 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2563 


2564 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


1| <!DOCTYPE html> 

2| <!-- readingCookies.jsp --> 

3| <html> 

4 <head> 

s| <title>Reading Cookies</title> 

6 <link rel="stylesheet" href="css/css-3.css"> 

7| </head> 

& <body> 

9| <div class="center"> 

10 <hi>Reading Cookies</hi> 

11, <$ 

12) Cookie cookies[] = null; 

13) // Get an array of Cookies associated with this domain 

14, cookies = request.getCookies(); 

15) if( cookies != nuill }{ 

16 out.printin("<h2 class=\"blue_color\"> " 

17) + "Found Cookies: Name --- Value</h2>"); 

18| for (int i = 0; i < cookies.length; i++){ 

19 out.print ("<h3>Name: " + cookies[i].getName( ) +" --- ")3 
20) out.print ("Value: " + cookies[i].getValue( )+"</h3>"); 
21| } 

22| }else{ 

23| out. .printin("<h2>No cookies founds</h2>"); 

24, i} 

25) $> 

26 <button onclick="location.href='cookiesAndSessions.html'" class="coral color"> 
27| Back to Cookie & Session Main</button> 

28) </div> 

29, </body> 

30| </html> 
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Image 10 . Code - readingCookies.jsp 
<!DOCTYPE html> 
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<head> 
<title>Reading Cookies</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Reading Cookies</hi> 
<$ 
Cookie cookies[] = null; 
// Get an array of Cookies as 
cookies = request.getCookies ( 
if( cookies != null ){ 
out .printin("<h2 class=\"blue_color\"> = 
+ "Found Cookies: Name --- Value</h2>"); 
for (int i = 0; i < cookies.length; i++) { 
out.print ("<h3>Name: " + cookies[i].getName( ) +" --- "); 
out.print("Value: " + cookies[i].getValue( )+"</h3>"); 


)e 


} 
}else{ 
out.printin("<h2>No cookies founds</h2>"); 
} 
$> 
<button onclick="location.href='cookiesAndSessions.html'" class="coral_color"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


Table 4.609 
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Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name : phoneNumber --- Value: 5125558989 


Deleted cookie: skillLevel 


Name : skillLevel --- Value: expert 
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Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name : phoneNumber --- Value: 5125558989 


Deleted cookie: skillLevel 


Name : skillLevel --- Value: expert 
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2568 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name: firstName --- Value: Ada 
Name: lastName --- Value: Lovelace 
Name : phoneNumber --- Value: 5125558989 


Deleted cookie: skillLevel 


Name : skillLevel --- Value: expert 
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Image 11 . Output - deletingCookie.jsp (part 1 of 2) 


Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name : firstName --- Value: Ada 
Name : lastName --- Value: Lovelace 
Name : phoneNumber --- Value: 5125558989 


Deleted cookie: skillLevel 


Name : skillLevel --- Value: expert 


Table 4.610 
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Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name : firstName --- Value: Ada 
Name : lastName --- Value: Lovelace 


Name : phoneNumber --- Value: 5125558989 
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Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name : firstName --- Value: Ada 
Name : lastName --- Value: Lovelace 


Name : phoneNumber --- Value: 5125558989 
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Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name : firstName --- Value: Ada 
Name : lastName --- Value: Lovelace 


Name : phoneNumber --- Value: 5125558989 
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Image 12 . Output - deletingCookie.jsp (part 2 of 2) 


Deleting a Cookie 


Discovered Cookies 


Name : JSESSIONID --- Value: 
BC505779761F7703C919AASA2BC146A3 


Name : firstName --- Value: Ada 
Name : lastName --- Value: Lovelace 


Name : phoneNumber --- Value: 5125558989 


Table 4.611 
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1| <!DOCTYPE html> 

2| <!-- deletingCookie.jsp --> 

3) <html> 

4 <head> 

5| <title>Deleting a Cookie</title> 

6l <link rel="stylesheet" href="css/css-3.css"> 

7 </head> 

8 <body> 

9 <div class="center"> 

10| <hi>Deleting a Cookie</h1> 

11| <%@ include file="deletingCookieProcessor.jsp" %> 

12| <button onclick="location.href='cookiesAndSessions.html'" 
13| class="coral color" style="margin-top: 20px"> 
14| Back to Cookie & Session Main</button> 

15| </div> 

16| </body> 

17| </html> 

1| <!DOCTYPE html> 

2| <!-- deletingCookie.jsp --> 

3| <html> 

4| <head> 

5| <title>Deleting a Cookie</title> 

6 <link rel="stylesheet" href="css/css-3.css"> 

7| </head> 

8 <body> 

9 <div class="center"> 

10| <h1>Deleting a Cookie</h1> 

11| <%@ include file="deletingCookieProcessor.jsp" %> 

12| <button onclick="location.href='cookiesAndSessions.html'" 
13, class="coral color" style="margin-top: 20px"> 
14| Back to Cookie & Session Main</button> 

15| </div> 

16 </body> 

17| </html> 
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<!DOCTYPE html> 
<!~— deleringCookie.jsp -~> 
<html> 
<head> 
<title>Deleting a Cookie</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Deleting a Cookie</hi> 
<%@ include file="deletingCookieProcessor.jsp" %> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


Image 13 . Code - deletingCookie.jsp 


1 
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<!DOCTYPE html> 
<!-- deletingCookie.jsp --> 
<html> 
<head> 
<title>Deleting a Cookie</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Deleting a Cookie</hi> 
<%@ include file="deletingCookieProcessor.jsp" %> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


Table 4.612 
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Q <!-- deletingCookieProcessor.jsp --> 

2| <$% 

3| Cookie cookies[] = null; 

4| cookies = request.getCookies(); 

5| if( cookies != null ){ 

6 out. .println("<h2 class=\"blue_color\">Discovered Cookies</h2>"); 
7 for (int i = 0; i < cookies.length; i++) { 

8 // Deleted cookie still in cookies[] array ist time through 
9 // Deleted cookie removed from cookies[{] > ist time through 
10 if((cookies[{i}].getName( )).compareTo("skillLevel") == 0 ){ 
F cookies [i] .setMaxAge (0); // MaxAge=0 deletes cookie 

12 response.addCookie (cookies[i]); // Back to browser 

13 out.print ("<h3 class=\"red color\">Deleted cookie: " 

14 + cookies[i].getName( ) + "</h3>"); 

15 } 

16 out.print ("<h3>Name : " + cookies[i].getName( ) + " --- "); 
17 out.print("Value: " + cookies[i].getValue( )+" </h3>"); 

18 } 

19| }elsef 

20 out.println("<h2>No cookies found</h2>"); 

21| } 

22| for (int i = 0; i < cookies.length; i++){ 

23 // Deleted cookie still in cookies[{] array ist time through 

24 // Deleted cookie removed from cookies[] > ist time through 

25 if ((cookies[i].getName( )).compareTo("skillLevel") == 0){ $> 
26 <button onClick="history.go(0)" 

oy class="coral color" style="margin-top: 20px"> 

28 See Cookie Removed</button><br> 

29 <% } 

30| } %> 
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<!-- deletingCookieProcessor.jsp --> 
<$% 
Cookie cookies[] = null; 
cookies = request.getCookies(); 
if( cookies != null )f{ 
out.printin("<h2 class=\"blue_color\">Discovered Cookies</h2>"); 
for (int i = 0; i < cookies.length; i++) { 
// Deleted cookie still in cookies[] array ist time through 
// Deleted cookie removed from cookies[{] > ist time through 
if((cookies[{i}].getName( )).compareTo("skillLevel") == 0 ){ 
cookies [i] .setMaxAge (0); // MaxAge=0 deletes cookie 
response .addCookie (cookies[i]); // Back to browser 
out.print ("<h3 class=\"red_ color\">Deleted cookie: " 
+ cookies[{i].getName( ) + "</h3>"); 


} 
out.print ("<h3>Name : " + cookies[i].getName( ) + " --- "); 
out.print("Value: " + cookies[i].getValue( )+" </h3>"); 
} 
}else{ 
out.println("<h2>No cookies found</h2>"); 


} 
for (int i = 0; i < cookies.length; i++){ 
// Deleted cookie still in cookies[{] array ist time through 
// Deleted cookie removed from cookies[] > ist time through 
if ((cookies[i].getName( )).compareTo("skillLevel") == 0){ $> 
<button onClick="history.go(0)" 
class="coral color" style="margin-top: 20px"> 
See Cookie Removed</button><br> 
<% } 
} &> 
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9 <!-- deletingCookieProcessor.jsp --> 

2| <$% 

3| Cookie cookies[] = null; 

4| cookies = request.getCookies(); 

5| if( cookies != null ){ 

6 out. .println("<h2 class=\"blue_color\">Discovered Cookies</h2>"); 
7 for (int i = 0; i < cookies.length; i++) { 

8 // Deleted cookie still in cookies[] array ist time through 
9 // Deleted cookie removed from cookies[{] > ist time through 
10 if((cookies[{i}].getName( )).compareTo("skillLevel") == 0 ){ 
F cookies [i] .setMaxAge (0); // MaxAge=0 deletes cookie 

12 response.addCookie (cookies[i]); // Back to browser 

13 out.print ("<h3 class=\"red color\">Deleted cookie: " 

14 + cookies[i].getName( ) + "</h3>"); 

15 } 

16 out.print ("<h3>Name : " + cookies[i].getName( ) + " --- "); 
17 out.print("Value: " + cookies[i].getValue( )+" </h3>"); 

18 } 

19| }elsef 

20 out.println("<h2>No cookies found</h2>"); 

21| } 

22| for (int i = 0; i < cookies.length; i++){ 

23 // Deleted cookie still in cookies[{] array ist time through 

24 // Deleted cookie removed from cookies[] > ist time through 

25 if ((cookies[i].getName( )).compareTo("skillLevel") == 0){ $> 
26 <button onClick="history.go(0)" 

oy class="coral color" style="margin-top: 20px"> 

28 See Cookie Removed</button><br> 

29 <% } 

30| } %> 
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Image 14 . Code - deletingCookieProcessor.jsp 
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<!-- deleting 
<$% 

Cookie cookies[] = null; 
cookies = request.getCookies(); 
if( cookies != null )f{ 


out.printin("<h2 class=\"blue color\">Discovered Cookies</h2>"); 


for (int i = 0; i < cookies.length; i++) { 

// Deleted cookie still in cookies[] array ist time through 

// Deleted cookie removed from cookies[{] > ist time throug 

if ((cookies[i].getName( )).compareTo("skillLevel") == 0 
cookies [i] .setMaxAge (0); // MaxAge=0 deletes cookie 
response .addCookie (cookies[i}); // Back to browser 
out.print ("<h3 class=\"red_ color\">Deleted cookie: " 

+ cookies[i].getName( ) + "</h3>"); 


} 
out.print ("<h3>Name : " + cookies[i].getName( ) + " --- "); 
out.print("Value: " + cookies[i].getValue( )+" </h3>"); 
} 
}else{ 
out.println("<h2>No cookies found</h2>"); 


} 
for (int i = 0; i < cookies.length; i++){ 

// Deleted cookie still in cookies[] array ist time through 
// Deleted cookie removed from cookies[{] > ist time through 
if ((cookies[i].getName( )).compareTo("skillLevel") == 0){ $> 

<button onClick="history.go(0)" 

class="coral color" style="margin-top: 20px"> 
See Cookie Removed</button><br> 


Table 4.613 
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Cookies and site data 


Site Locally stored data 


fitse2317-jsp 
Any kind of connection 

Yes 

Monday, November 18, 2013 11:51:32 PM 
Tuesday, November 19, 2013 11:51:32 PM 


/itse2317-jsp 

Any kind of connection 

Yes 

Monday, November 18, 2013 11:51:32 PM 
Tuesday, November 19, 2013 11:51:32 PM 
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fitse2317-jsp 

Any kind of connection 

Yes 

Monday, November 18, 2013 11:51:32 PM 
Tuesday, November 19, 2013 11:51:32 PM 
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Image 15 Cookies and Site Data 
Cookies and site data 
Site Locally stored data 


/itse2317-jsp 

Any kind of connection 

Yes 

Monday, November 18, 2013 11:51:32 PM 
Tuesday, November 19, 2013 11:51:32 PM 


A 
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JSP Tag JSP Name 
<% %> _ | Scriptlet Insert Java statements 


<%= %> Display string value 
<%H@ %> Set whole page conditions 


<%-- --%> 
<%! %> 


Comment Not returned to browser 
Declaration Declare instance variables or methods 


<%@ %> 
<%-- --%> 


<%!__%> 


Image 16 . JSP tags. 


<%= %> Display string value 


Table 4.615 


4.5.14.8 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 
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e Module name: Java4370r: Review 
e File: Java4370r.htm 

e Published: 12/15/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


4.5.15 Java4380: Sessions with JSP” 
4.5.15.1 Table of Contents 
e Preface (p. 2588) 


Viewing tip (p. 2588) 
x Images (p. 2589) 


Preview (p. 2589) 

General background information (p. 2589) 
Discussion (p. 2589) 

Homework assignment (p. 2592) 
Summary (p. 2592) 

What’s next? (p. 2592) 

Images (p. 2593) 

Miscellaneous (p. 2642) 


4.5.15.2 Preface 


This module is one in a collection of modules designed for teaching ITSE 2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

In this module sessions are covered in the context of JSP. After reviewing this material and coding the 
examples, students will have a fundamental understanding of using sessions with JSP. 


4.5.15.2.1 Viewing tip 


I recommend that students open another copy of this module in a separate browser window and use the 
following links to easily find and view the Images while you are reading about them. 


289This content is available online at <http://cnx.org/content /m48089/1.7/>. 
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4.5.15.2.1.1 Images 


e Image 1 (p. 2596) . Output - cookiesAndSessions.html 

e Image 2 (p. 2598) . Code - cookiesAndSessions.html 

e Image 3 (p. 2602) . Output - viewSessionData.jsp (part 1 of 4) 
e Image 4 (p. 2606) . Output - viewSessionData.jsp (part 2 of 4) 
e Image 5 (p. 2610) . Output - viewSessionData.jsp (part 3 of 4) 
e Image 6 (p. 2617) . Code - viewSessionData.jsp 

e Image 7 (p. 2621) . Code - viewSessionProcessor.jsp 

e Image 8 (p. 2622) . Output - deleteSessionAttribute.jsp 

e Image 9 (p. 2624) . Code - deleteSessionAttribute.jsp 

e Image 10 (p. 2628) . Output - viewSessionData.jsp (part 4 of 4) 
e Image 11 (p. 2629) . Output - deleteSessionObject.jsp 

e Image 12 (p. 2631) . Code - deleteSessionObject.jsp 

e Image 13 (p. 2633) . Cookies and Site Data - session created with jsp 
e Image 14 (p. 2635) . Output - readingCookies.jsp 

e Image 15 (p. 2639) . Code - readingCookies.jsp 

e Image 16 (p. 2641) . Session Timeout 

e Image 17 (p. 2642) . Session Attributes 


4.5.15.3 Preview 


No intermediate web discussion would be complete without addressing cookies and sessions. In this module, 
the topic of state management is continued with coverage of sessions. The material may be a little involved at 
times in this and the previous module. However, after multiple reviews and practice with the code, students 
will acquire practical comprehension of cookies and sessions. 


4.5.15.4 General background information 


In the last module, an overview of cookies was presented. Sessions are another technique used to maintain 
state information and they are the topic of this module. Cookies and sessions are both objects and therefore 
contain methods and data elements. Both provide the developer with techniques to preserve small amounts 
of information about the user which can be utilized on subsequent visits to the website. Cookies are stored 
in files on the client and can have long life spans. 

Session data however, are stored on the server (with the exception of the JSESSIONID cookie), and are 
designed to retain information during the current working session of the user. When a browser first visits a 
site and requests a servlet or JSP, a session object is created. Note: a session object is not created on the 
site when requesting an HTML page. The session object is stored on the server and associated with that 
brower via a JSESSIONID stored in a cookie. The session object is accessible to both JSP and servlets but 
not to HTML pages. 

The exact method employed to store session data is dependent upon the JSP server (Tomcat for this 
course) and can range from in-memory objects, to server-side files, to databases. For the purposes of this 
module, we will interact with session objects as though they were stored in-memory, making method calls 
to set and get data. By default, this is the session strategy employed by Tomcat and is the most common 
approach. 


4.5.15.5 Discussion 


For the work with sessions, we will create session data, delete attributes of the session objects, and delete 
entire session objects. It is important to note, that like form data, cookies, and many other web facilities, 
session data is stored as name::value pairs. Session attributes consist of key::value pairs where key is the 
same mechanism as name. Image 17 (p. 2642) contains a table of sample session attributes used in this 
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module. Each of the key::value pairs is known as an attribute which is analogous to the way name::value 
pairs in cookie objects are known as individual cookies. 

Just as individual cookies were created and added to the cookie object (array of cookies), individual 
key::value pairs are added to the session object for subsequent retrieval. Cookies are designed primarily to 
retain client identity between different browser sessions, over extended periods of time. On the other hand, 
sessions are designed to retain client data as users navigate between pages during the same browser session, 
not over extended time periods. 


4.5.15.5.1 Output - cookiesAndSessions.html 


The output shown in Image 1 (p. 2596) is familiar from the last module. The first three activities have 
already been covered and in this module the last three operations are discussed. The code for cookiesAnd- 
Sessions. html is shown in Image 2 (p. 2598) as a convenience and by now is quite familiar. The css-3.css 
file is displayed in the cookies module. To get started with sessions, select the View Session Data button on 
Image 1 (p. 2596) . 


4.5.15.5.2 Output - viewSessionData.jsp 


When the View Session Data button in selected on Image 1 (p. 2596) the output in Image 3 (p. 2602) is 
shown. Each one of the 6 elements of session info in the left column are actually key::value pairs stored in 
the session object. Session objects are created by the JSP container (Tomcat in our case), when a JSP page 
is accessed. However, accessing an HTML page does not create a session. Notice the Welcome header is 
displayed the first time the page is accessed (the session is new). Welcome Back is displayed on all subsequent 
visits. The Number of visits of 1 in Image 3 (p. 2602) also verifies that it is the first time the page has 
been accessed (with that particular session id). Like cookies, sessions have an expiration date. The session 
expiration date can be set at the server level but it can also be more specific to individual applications by 
modifying the web.xml file. Recall that web applications are also known as contexts by the JSP server. 

In Image 16 (p. 2641) , the session-timeout element is shown from the local web.xml file. The timeout 
was set to 1 minute for demonstration purposes. The default is 30 minutes for the timeout value. Notice in 
Image 4 (p. 2606) that the Number of Visits is 1 but the session id has changed. 

Also note that the creation time is 2 minutes and 13 seconds after the session in Image 3 (p. 2602) was 
created. In Image 4 (p. 2606) , a new session was created after the one created in Image 3 (p. 2602) had 
expired beyond the 1 minute limit. Therefore, a new session was created for Image 4 (p. 2606) . On the 
other hand, in Image 5, the session id remains the same but the header has changed to Welcome Back and 
the Number of visits has incremented to 2. Image 5 (p. 2610) was produced by selecting the View Session 
Data button of Image 1 (p. 2596) less than 1 minute after creating Image 4 (p. 2606) (i.e. within the 
expiration timeout). 


4.5.15.5.3 Code - viewSessionData.jsp 


The code for viewSessionData.jsp is shown in Image 6 (p. 2617) . There are only a couple of points to make 
here. First, all of the processing takes place in the include file (viewSessionProcessor.jsp). Second, most of 
the output in the table is produced by script statements like that on lines 25 and 29 of Image 6 (p. 2617) 
. On line 21 a call to session.getID is used to retrieve the value for JSESSIONID from the session object. 
Also, just for variety, an expression statement is used to produce the output on line 41. Any of the three 
techniques can be used to display content. 


4.5.15.5.4 Code - viewSessionProcessor.jsp 


The processing code for view sessions is shown in Image 7 (p. 2621) . The error messages on lines 6 and 
8 appear because the java.util.Date is not recognized in the current file. However, as observed in previous 
modules, this issue is resolved at runtime when the file is included in Image 6 (p. 2617) . Lines 10-12 of 
Image 7 (p. 2621) define variables that are used later in the session processing. On line 14 the code checks 
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for the presence of a session attribute value. If that value is null, then the attributes do not exist because it 
is a new visitor. The attributes are therefore created on lines 16-18. 

Another technique to check for the existence of the session object is using the session.isNew method call. 
However, checking for the existence of an exact attribute value may be preferable when that is the question 
since session.isNew can produce different results based on the precise timing of the call and settings on the 
client. If line 14 evaluates to true then session attributes should be and are set on lines 16-18. The session 
attributes are set using keys and values created on lines 10-12. These are the key::value pairs of the attributes 
in the session object. Notice that all of the key identifiers end in Key and all of the value identifiers end in 
Value. 

This approach emphasizes semantics and is encouraged for code clarity and comprehension. Otherwise, it 
can be difficult to differentiate between attribute, key, and value identifiers. On line 21 of Image 7 (p. 2621) , 
the value associated with the visitCountKey attribute is assigned to the local variable visitCount Value which 
is then incremented on line 22. Note that this visitCount Value will be 1 if it is the first visit or incremented 
to greater than 1 if it is a recent visit to the page. Recency is relative and is determined by the session 
timeout setting previously discussed. The visitCountKey attribute is then set on line 23. The userID Value 
and favoriteBookValue values are then retrieved from the session object on lines 24 and 25. By the end 
of viewSessionData.jsp, the session object is populated with the six session attributes and values shown in 
Image 3 (p. 2602) . 


4.5.15.5.5 Output and Code - deleteSession Attribute.jsp 


When the Delete Session Attribute button is selected on Image 1 (p. 2596) , the output of Image 8 (p. 2622) 
is produced. The message Removed favortieBookKey is displayed which was the attribute targeted in the 
code for removal. The code is shown in Image 9 (p. 2624) . Line 12 contains a call to removeAttribute 
which removes a Session object attribute based on the key identifier supplied as an argument to the method 
call which in this case is favorticBookKey. That session attribute had the key of favortieBookKey and 
favortieBookValue as the value identifier. The output displayed by Image 10 (p. 2628) shows that the 
favoriteBookKey attribute no longer exists since the call to getAttribute produces a null value. Note in 
images 3, 4, and 5 the value for the favoriteBookKey attribute was The Americans but has been changed to 
null after running deleteSessionAttribute.jsp. 


4.5.15.5.6 Output and Code - deleteSessionObject.jsp 


The output of Image 11 (p. 2629) is produced when the Delete Session Object button of Image 1 (p. 
2596) is selected. The code is displayed in Image 12 (p. 2631) . Line 12 is the important line that calls 
session.invalidate to eliminate the current session. After a call to Delete Session Object, it can be verified 
that the JSESSIONID cookie no longer exist on the client. The output of Image 13 (p. 2633) can be accessed 
in Chrome by selecting Settings | Show Advanced Settings | Content Settings | All cookies and site data... | 
and look for localhost to see a list of cookies created by our programs. 

To observe session object and cookie creation students should practice the following: first remove all 
cookies except the JSESSIONID cookie, then select Delete Session Object on Image 1 (p. 2596) and observe 
that the JSESSIONID cookie has disappeared. Next, access a JSP and observe the cookie and therefore 
session object being created again. After a session object has been invalidated (removed), a call to View 
Session Data in Image 1 (p. 2596) will display attributes associated with a new Session object. Also, selecting 
Read Cookies on Image 1 (p. 2596) before creating any cookies will produce output shown in Image 14 (p. 
2635) in which only the JSESSIONID cookie is shown. The code for reading cookies is reproduced as a 
convenience in Image 15 (p. 2639) . 


4.5.15.5.7 Alternatives to Using Cookies for Sessions 


Most modern browsers are set to accept cookies by default. However, since cookie acceptance and storage 
can be disabled on the browser, alternatives for storing and communicating the JSESSIONID should be 
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considered. The first alternative is to use a technique known as URL rewriting. This concept is sometimes 
referred to as URL encoding but encoding is only a portion of the operations required for URL rewriting. 

Essentially, when using URL rewriting, all URLs sent back to the client (and communicated between 
server pages) have to be rewritten to include the JSESSIONID. The id is appended to the end of URLs and 
the JSP container associates the session id with the appropriate client. Furthermore, all pages required to 
programmatically access the JSESSIONID must be JSP and not HTML. Another method to pass the id 
involves the use of forms and the hidden input elements. When this technique is utilized, the hidden element 
is populated with the JSESSIONID and then the form is submitted from page to page. 


4.5.15.6 Homework assignment 


See the JSP section in Blackboard for all JSP homework assignments. 


4.5.15.6.1 Supplemental Reading 


http://tomcat.apache.org /tomcat-5.5-doc/servletapi /javax/servlet /http/HttpSession.html 7°° 


4.5.15.7 Summary 


In this module session data was created and expiration behavior observed. A session attribute was deleted 
while others remained intact. An entire Session object was removed and the elimination of the JSESSIONID 
cookie was also demonstrated. Finally, alternatives to the use of cookies for JSESSIONID storage were 
considered. 


4.5.15.8 What’s next? 


Congratulations on your progress through ITSE 2317. If interested, you might consider the INEW 2338 
course offering on the schedule which is the advanced Java course at ACC. Good luck with your academic 
endeavors. 


29°http://tomcat.apache.org/tomcat-5.5-doc/servletapi/javax/servlet/http/HttpSession html 
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4.5.15.9 Images 


Cookies and Sessions 


Create Cookies 
Read Cookies 
Delete Cookie 


View, Session Data 


Delete Jesuit Attribute 


Delete Session Object 


Cookies and Sessions 


Create Cookies 
Read Cookies 
Delete Cookie 
V: ews ession Data 


Delete eee Attribute 
Delete Session Object 
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Cookies and Sessions 


Create Cookies 
Read Cookies 
Delete Cookie 


Delete Erioa Attribute 
Delete Session Object 
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Image 1 . Output - cookiesAndSessions.html 


Cookies and Sessions 


Create Cookies 
Read Cookies 
Delete Cookie 
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h eS: 
Delete Session Attribute 


Delete Session Object 


Table 4.616 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2592 


wow nw &§ WN 


PPPPRPPPPRP PRP 
fo OI HH & WN PO 


wont nw & WH 


PPPPRPPPRPR ER 
fo OIHN HO & WNP O 


CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


<!DOCTYPE html> 
<!-- cookiesAndSessions.html -- 
<html> 
<head> 
<title>Cookies and Sessions</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Cookies and Sessions</hi> 
</div> 
<p><a href="cookieDataEntry.html">Create Cookies</a></p> 
<p><a href="readingCookies.jsp">Read Cookies</a></p> 
<p><a href="deletingCookie.jsp">Delete Cookie</a></p> 
<p><a href="viewSessionData.jsp">View Session Data</a></p> 
<p><a href="deleteSessionAttribute.jsp">Delete Session Attribute</a></p> 
<p><a href="deleteSessionObject.jsp">Delete Session Object</a></p> 
</body> 
</html> 


Vv 


<!DOCTYPE html> 
<!-- cookiesAndSessions.html --> 
<html> 
<head> 
<title>Cookies and Sessions</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Cookies and Sessions</hi> 
</div> 
<p><a href="cookieDataEntry.html">Create Cookies</a></p> 
<p><a href="readingCookies.jsp">Read Cookies</a></p> 
<p><a href="deletingCookie.jsp">Delete Cookie</a></p> 
<p><a href="viewSessionData.jsp">View Session Data</a></p> 
<p><a href="deleteSessionAttribute.jsp">Delete Session Attribute</a></p> 
<p><a href="deleteSessionObject.jsp">Delete Session Object</a></p> 
</body> 
</html> 
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1| <!DOCTYPE html> 
2 <!-- cookiesAndSessions.html --> 
3| <html> 
4| <head> 
5 <title>Cookies and Sessions</title> 
6 <link rel="stylesheet" href="css/css-3.css"> 
7| </head> 
8| <body> 
9 <div class="center 
10 <hi>Cookies and Sessions</hi> 
11 </div> 
12 <p><a href="cookieDataEntry.html">Create Cookies</a></p> 
13 <p><a href="readingCookies.jsp">Read Cookies</a></p> 
14 <p><a href="deletingCookie.jsp">Delete Cookie</a></p> 
15 <p><a href="viewSessionData.jsp">View Session Data</a></p> 
16 <p><a href="deleteSessionAttribute.jsp">Delete Session Attribute</a></p> 
$? <p><a href="deleteSessionObject.jsp">Delete Session Object</a></p> 
18| </body> 
19| </html> 
Image 2 . Code - cookiesAndSessions.html 
| a] <!DOCTYPE html> | 
2 <!-- cookiesAndSessions.html --> 
3| <html> 
4| <head> 
5 <title>Cookies and Sessions</title> 
6 <link rel="stylesheet" href="css/css-3.css"> 
7| </head> 
8| <body> 
9 <div class="center"> 
10 <hi>Cookies and Sessions</hi> 
11 </div> 
12 <p><a href="cookieDataEntry.html">Create Cookies</a></p> 
13 <p><a href="readingCookies.jsp">Read Cookies</a></p> 
14 <p><a href="deletingCookie.jsp">Delete Cookie</a></p> 
15 <p><a href="viewSessionData.jsp">View Session Data</a></p> 
16 <p><a href="deleteSessionAttribute.jsp">Delete Session Attribute</a></p> 
17 <p><a href="deleteSessionObject.jsp">Delete Session Object</a></p> 
18| </body> 
19| </html> 


Table 4.617 
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Session Tracking 
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Session Tracking 


ime of Last Access 
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Session Tracking 
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Image 3 . Output - viewSessionData.jsp (part 1 of 4) 


Session Tracking 


Welcome 


Tue Nov 19 22:37:40 CST 2013 
Time of Last Access Tue Nov 19 22:37:40 CST 2013 
Turing 00 


Table 4.618 
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Session Tracking 


Welcome 


Tue Nov 19 22:39:53 CST 2013 
SS Tue Nov 19 22:39:53 CST 2013 


Tang 00 
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Session Tracking 
Welcome 
[| Session info | Value | 


Tue Nov 19 22:39:53 CST 2013 
Time of Last Access Tue Nov 19 22:39:53 CST 2013 


Tg 0 
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Session Tracking 


Welcome 


Tue Nov 19 22:39:53 CST 2013 
SS Tue Nov 19 22:39:53 CST 2013 


Tang 00 
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Image 4 . Output - viewSessionData.jsp (part 2 of 4) 


Session Tracking 


Welcome 


Tue Nov 19 22:39:53 CST 2013 


Time of Last Access Tue Nov 19 22:39:53 CST 2013 
Tag 00 


Table 4.619 
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Session Tracking 


Tue Nov 19 22:39:53 CST 2013 


Time of Last Access Tue Nov 19 22:39:53 CST 2013 
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Session Tracking 


Welcome Back 


Tue Nov 19 22:39:53 CST 2013 
Time of Last Access|| Tue Nov 19 22:39:53 CST 2013 
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Session Tracking 


Tue Nov 19 22:39:53 CST 2013 


Time of Last Access Tue Nov 19 22:39:53 CST 2013 
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Image 5 . Output - viewSessionData.jsp (part 3 of 4) 


Session Tracking 


Welcome Back 


Creation Time Tue Nov 19 22:39:53 CST 2013 


Time of Last Access Tue Nov 19 22:39:53 CST 2013 


Table 4.620 
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<!DOCTYPE html> 
<html> 
<head> 
<title>JSP Session Tracking</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<%@ page import="java.util.*" $> 
<%@ include file="viewSessionProcessor.jsp" %> 
<body> 
<div class="center"> 
<hi>Session Tracking</hi> 
<hi><% out.print (title); %></hi> 
<table class="inline-block"> 
<tr id="th-idi"> 
<th>Session info</th> 
<th>Value</th> 
</tr> 
<tr> 
<td>id</td> 
<td><$ out.print (se 
</tr> 
<tr> 
<td>Creation Time</td> 
<td><% out.print (createTimeValue); %></td> 
</tr> 
<tr> 
<td>Time of Last Access</td> 
<td><% out.print (lastAccessTimeValue); ></td> 
</tr> 
<tr> 
<td>User ID</td> 
<td><% out.print (userIDValue); ></td> 
</tr> 
<tr> 
<td>Number of visits</td> 
<td><$ out.print (visitCountValue); %$></td> 
</tr> 
<tr> 
<td>Favorite Book</td> 
<td><%= favoriteBookValue %></td> 
</tr> 
</table> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


vO 


m 


ssionData.jsp --> 


on.getId()); %></td> 
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<!DOCTYPE html> 
<html> 
<head> 
<title>JSP Session Tracking</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<%@ page import="java.util.*" $> 
<%@ include file="viewSessionProcessor.jsp" %> 
<body> 
<div class="center"> 
<hi>Session Tracking</hi> 
<hi><% out.print (title); %></hi> 
<table class="inline-block"> 
<tr id="th-idi"> 
<th>Session info</th> 
<th>Value</th> 
</tr> 
<tr> 
<td>id</td> 
<td><$ out.print (se 
</tr> 
<tr> 
<td>Creation Time</td> 
<td><% out.print (createTimeValue); %></td> 
</tr> 
<tr> 
<td>Time of Last Access</td> 
<td><% out.print (lastAccessTimeValue); ></td> 
</tr> 
<tr> 
<td>User ID</td> 
<td><% out.print (userIDValue); ></td> 
</tr> 
<tr> 
<td>Number of visits</td> 
<td><$ out.print (visitCountValue); %$></td> 
</tr> 
<tr> 
<td>Favorite Book</td> 
<td><%= favoriteBookValue %></td> 
</tr> 
</table> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


vO 


m 


ssionData.jsp --> 


on.getId()); %></td> 
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<!DOCTYPE html> 
<html> 
<head> 
<title>JSP Session Tracking</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<%@ page import="java.util.*" $> 
<%@ include file="viewSessionProcessor.jsp" %> 
<body> 
<div class="center"> 
<hi>Session Tracking</hi> 
<hi><% out.print (title); %></hi> 
<table class="inline-block"> 
<tr id="th-idi"> 
<th>Session info</th> 
<th>Value</th> 
</tr> 
<tr> 
<td>id</td> 
<td><$ out.print (se 
</tr> 
<tr> 
<td>Creation Time</td> 
<td><% out.print (createTimeValue); %></td> 
</tr> 
<tr> 
<td>Time of Last Access</td> 
<td><% out.print (lastAccessTimeValue); ></td> 
</tr> 
<tr> 
<td>User ID</td> 
<td><% out.print (userIDValue); ></td> 
</tr> 
<tr> 
<td>Number of visits</td> 
<td><$ out.print (visitCountValue); %$></td> 
</tr> 
<tr> 
<td>Favorite Book</td> 
<td><%= favoriteBookValue %></td> 
</tr> 
</table> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


vO 


m 


ssionData.jsp --> 


on.getId()); %></td> 
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Image 6 . Code - viewSessionData.jsp 
| a) <!DOCTYPE html> | 
2| <!-- viewSessionData.jsp -- 
3| <html> 
4| <head> 
5 <title>JSP Session Tracking</title> 
6 <link rel="stylesheet" href="css/css-3.css"> 
7| </head> 
8| <%@ page import="java.util.*" %> 
9| <%@ include file="viewSessionProcessor.jsp" %> 
10| <body> 
11; <div class="center"> 
12| <hi>Session Tracking</ni> 
13| <hi><% out.print (title); %></hi> 
14| <table class="inline-block"> 
15| <tr id="th-idi"> 
16 <th>Session info</th> 
17 <th>Value</th> 
18| </tr> 
19; <tr> 
20 <td>id</td> 
21 <td><% out.print (s n.getId()); %></td> 
22| </tr> 
23| <tr> 
24 <td>Creation Time</td> 
25 <td><% out.print (createTimeValue); %></td> 
26) </tr> 
27; <tr> 
28 <td>Time of Last Access</td> 
29 <td><% out.print (lastAccessTimeValue); %></td> 
30; </tr> 
31; <tr> 
32 <td>User ID</td> 
33 <td><% out.print (userIDValue); %></td> 
34| </tr> 
35; <tr> 
36 <td>Number of visits</td> 
37 <td><% out.print (visitCountValue); %$></td> 
38| </tr> 
39| <tr> 
40 <td>Favorite Book</td> 
41 <td><$= favoriteBookValue %></td> 
42| </tr> 
43| </table> 
44; <button onclick="location.href='cookiesAndSessions.html'" 
45 class="coral color" style="margin-top: 20px"> 
46 Back to Cookie & Session Main</button> 
47| </div> 
48| </body> 
49° </html> 
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Table 4.621 


// Get session creation time 
Date createTimeValue = new Date (session.getCreationTime()); 
// Get last access time 
Date lastAccessTimeValue = new Date (session.getLastAccessedTime ()); 
String title = "Welcome Back"; 
Integer visitCountValue = 0; 
String userIDValue = "Turing-001"; 
String favoriteBookValue = "The Americans"; 
// If attribute == null, a new session 
if (session.getAttribute ("userIDKey") == null) i 
title = "Welcome"; 
session.setAttribute("useriIDKey", userIDValue); 
session.setAttribute ("visitCountKey", visitCountValue) ; 
session.setAttribute ("favoriteBookKey", favoriteBookValue) ; 
} 
// Now increment visitCountValue and get the Session attributes 
visitCountValue = (Integer) session.getAttribute ("visitCountKey"); 
visitCountValue = visitCountValue + i; 
session.setAttribute("visitCountKey", visitCountValue) ; 
userIDValue = (String) session.getAttribute ("userIDKey") ; 
favoriteBookValue = (String) session.getAttribute ("favoriteBookKey"); 
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Q <!-- viewSessionProcessor.jsp --> 

2| <5% 

3 // Get session creation time 

o Date createTimeValue = new Date (session.getCreationTime()); 

5 // Get last access time 

@ Date lastAccessTimeValue = new Date (session.getLastAccessedTime ()); 
7 String title = "Welcome Back"; 

8 Integer visitCountValue = 0; 

9 String userIDValue = "Turing-00i"; 

10 String favoriteBookValue = "The Americans"; 

11 // If attribute == null, a new session 

12 if (session.getAttribute ("userIDKey") == null) { 

13 title = "Welcome"; 

14 session.setAttribute ("userIDKey", userIDValue) ; 

15 session.setAttribute ("visitCountKey", visitCountValue) ; 

16 session.setAttribute ("favoriteBookKey", favoriteBookValue) ; 

17 } 

18 // Now increment visitCountValue and get the Session attributes 
19 visitCountValue = (Integer) session.getAttribute ("visitCountKey")>; 
20 visitCountValue = visitCountValue + i; 

21 session.setAttribute ("visitCountKey", visitCountValue) ; 

22 userIDValue = (String) session.getAttribute ("userIDKey"); 

23 favoriteBookValue = (String) session.getAttribute ("favoriteBookKey"); 
24 $> 
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$> 


// Get last access time 
Date lastAccessTimeValue = new Date (session.getLastAccessedTime ()); 
String title = "Welcome Back"; 
Integer visitCountValue = 0; 
String userIDValue = "Turing-00i"; 
String favoriteBookValue = "The Americans"; 
// If attribute == null, a new session 
if (session.getAttribute ("userIDKey") == null) { 
title = "Welcome"; 
session.setAttribute ("userIDKey", userIDValue) ; 
session.setAttribute ("visitCountKey", visitCountValue) ; 
session.setAttribute ("favoriteBookKey", favoriteBookValue) ; 
} 
// Now increment visitCountValue and get the Session attributes 
visitCountValue = (Integer) session.getAttribute ("visitCountKey")>; 
visitCountValue = visitCountValue + 1; 
session.setAttribute ("visitCountKey", visitCountValue) ; 
userIDValue = (String) session.getAttribute ("useriIDKey"); 
favoriteBookValue = (String) session.getAttribute ("favoriteBookKey"); 
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Image 7 Code - viewSessionProcessor.jsp 
Q < - iewSessionProcessor.jsp -- 
2| <$ 
3 / Get l 2 time 
© Date createTimeValue = new Date (session.getCreationTime ()); 
5 / Get 1 
& Date lastAccessTimeValue = new Date (session.getLastAccessedTime () ); 
7 String title = "Welcome Back"; 
g Integer visitCountValue = 0; 
9 String userIDValue = "Turing-00i"; 
10 String favoriteBookValue = "The Americans"; 
11 / If attribute == null, a new session 
12 if (session.getAttribute ("userIDKey") == null) { 
13 title = "Welcome"; 
14 session.setAttribute ("userIDKey", useriIDValue) ; 
15 session.setAttribute ("visitCountKey", visitCountValue) ; 
16 session.setAttribute ("favoriteBookKey", favoriteBookValue) ; 
17 } 
18 / Now increment visitCountValue and get the Session attributes 
19 visitCountValue = (Integer) session.getAttribute ("visitCountKey"); 
20 visitCountValue = visitCountValue + i; 
21 session.setAttribute ("visitCountKey", visitCountValue) ; 
22 userIDValue = (String) session.getAttribute ("userIDKey"); 
23 favoriteBookValue = (String) session.getAttribute ("favoriteBookKey"); 
24 $> 


Table 4.622 


Removed favoriteBookKey 
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Removed favoriteBookKey 


Removed favoriteBookKey 


Image 8 . Output - deleteSessionAttribute.jsp 


Removed favoriteBookKey 


Table 4.623 
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1| <!DOCTYPE html> 

2| <!-- deleteSessionAttribute.jsp --> 

3|! <html> 

4 <head> 

5 <title>Delete Session Attribute</title> 

6 <link rel="stylesheet" href="css/css-3.css"> 
7 </head> 

e <body> 

9 <div class="cenEece*> 

10 <hi>Removed favoriteBookKey</hi> 

11 <$ 

12 session.removeAttribute ("favoriteBookKey"); 
1s] $> 

14 <button onclick="location.href='cookiesAndSessions.html'" 
15 class="coral color" style="margin-top: 20px"> 
16 Back to Cookie & Session Main</button> 

17 </div> 

18 </body> 

19| </html> 

1| <!DOCTYPE htmi> 

2| <!-- deleteSessionAttribute.jsp --> 

3| <html> 

4 <head> 

5 <title>Delete Session Attribute</title> 

6 <link rel="stylesheet" href="css/css-3.css"> 
7 </head> 

& <body> 

9 <div class="center"> 

10 <hi>Removed favoriteBookKey</hi> 

11 <$% 

12 session.removeAttribute ("favoriteBookKey"); 
13 $> 

14 <button onclick="location.href='cookiesAndSessions.html'" 
15 class="coral color" style="margin-top: 20px"> 
16 Back to Cookie & Session Main</button> 

17 </div> 

18 </body> 

19| </html> 
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<!DOCTYPE html> 


<!-- deleteSessionAttribute.jsp --> 
<html> 
<head> 


<title>Delete Session Attribute</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Removed favoriteBookKey</hi> 
<$ 
session.removeAttribute ("favoriteBookKey"); 
$> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral_color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 
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<!DOCTYPE htmli> 


<!-- deleteSessionAttribute.jsp --> 
<html> 
<head> 
<title>Delete Session Attribute</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 


<div class="center"> 
<hi>Removed favoriteBookKey</hi> 
<3 
session.removeAttribute ("favoriteBookKey"); 
$> 
<button onclick="location.href='cookiesAndSessions.html'" 
class="coral color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


Table 4.624 
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Session Tracking 


Welcome Back 


| Session info | Value 
a cr era ret el | | mec S 
40486452D2741 1D0DC5014AD6E29CDD7 
Tue Nov 19 22:42:14 CST 2013 
Time of Last Access Tue Nov 19 22:42:25 CST 2013 
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Session Tracking 


Welcome Back 


| Session info || Value | 
40486452D27411D0DC5014AD6E29CDD7 
Tue Nov 19 22:42:14 CST 2013 
Time of Last Access Tue Nov 19 22:42:25 CST 2013 
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Session Tracking 


Welcome Back 


| Session info | Value 
a cr era ret el | | mec S 
40486452D2741 1D0DC5014AD6E29CDD7 
Tue Nov 19 22:42:14 CST 2013 
Time of Last Access Tue Nov 19 22:42:25 CST 2013 
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Image 10 . Output - viewSessionData.jsp (part 4 of 4) 


Session Tracking 


Welcome Back 


tt) 


40486452D27411D0DC5014AD6E29CDD 
| Creation Time | Tue Nov 19 22:42:14 CST 2013 


ao i -. 
JIESSIVLE iil. 
. . 


| ‘FavoriteBook || mt o 


Table 4.625 


Deleted Session Object 
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Deleted Session Object 


Deleted Session Object 


Image 11 . Output - deleteSessionObject.jsp 


Deleted Session Object | 
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<!DOCTYPE html> 


<!-- deleteSessionObject.jsp --> 
<html> 
<head> 


<title>Deleted Session Object</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Deleted Session Object</hi> 
<$% 
session.invalidate(); 
$> 
<button onclick="1ocation.href='cookiesAndSessions.html'" 
class="coral color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


<!DOCTYPE html> 


<!-- deleteSessionObject.jsp --> 
<html> 
<head> 


<title>Deleted Session Object</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Deleted Session Object</hi> 
<$% 
session.invalidate(); 
$> 
<button onclick="location.href='cookiesAndSessions.htmi'" 
class="coral color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 
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<head> 
<title>Deleted Session Object</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Deleted Session Object</hi> 
<$% 
session.invalidate(); 
$> 
<button onclick="location.href='cookiesAndSessions.htmi'" 
class="coral color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


Image 12 . Code - deleteSessionObject.jsp 
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<!DOCTYPE html> 


<html> 
<head> 
<title>Deleted Session Object</title> 
<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Deleted Session Object</hi> 
<$% 
session.invalidate(); 
$> 
<button onclick="location.href='cookiesAndSessions.htmi'" 
class="coral_color" style="margin-top: 20px"> 
Back to Cookie & Session Main</button> 
</div> 
</body> 
</html> 


Table 4.627 
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Cookies and site data 


Cookies and site data 


Site 


Locally stored data 


Accessible to script: 
Created: 
Expires: 


Locally stored data 


Accessible to script: 
Created: 


Expires: 


x 


JSESSIONID 
946AD29D5835F499188F6C8D52636195. 
localhost 


fitse2317-jsp/ 

Any kind of connection 

No (HttpOnly) 

Tuesday, November 19, 2013 1:16:07 AM 
When the browsing session ends 


x 


JSESSIONID 
946AD29D5835F499188F6C8D52636195) 
localhost 

fitse2317-jsp/ 

Any kind of connection 

No (HttpOnly) 

Tuesday, November 19, 2013 1:16:07 AM 
When the browsing session ends 
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Cookies and site data a 


st lc stored dt 


JSESSIONID 
946AD29D5835F499188F6C8D52636195. 


Domain: localhost 


Path: fitse2317-jsp/ 

Send for: Any kind of connection 

Accessible to script: No (HttpOnly) 

Created: Tuesday, November 19, 2013 1:16:07 AM 
Expires: When the browsing session ends 


[ Remove | 


Image 13 . Cookies and Site Data - session created with jsp 
Cookies and site data x 


sie Lc stored dita (aa Ser coe i) 


JSESSIONID 
946AD29D5835F499188F6C8D52636195) 
localhost 


fitse2317-jsp/ 

Any kind of connection 
Accessible to script: No (HttpOnly) 
Created: Tuesday, November 19, 2013 1:16:07 AM 
Expires: When the browsing session ends 


Table 4.628 
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Reading Cookies 


Found Cookies: Name --- Value 


Name: JSESSIONID --- Value: 
946AD29D5835F 499188F 6C8D52636195 


Reading Cookies 


Found Cookies: Name --- Value 


Name: JSESSIONID --- Value: 
946AD29D5835F 499188F 6C8D52636195 
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Reading Cookies 


Found Cookies: Name --- Value 


Name: JSESSIONID --- Value: 
946AD29D5835F 499188F 6C8D52636195 


Image 14 . Output - readingCookies.jsp 


Reading Cookies 


Found Cookies: Name --- Value 


Name: JSESSIONID --- Value: 
946AD29D5835F 499188F 6C8D52636195 


Table 4.629 
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<!DOCTYPE html> 
<!-- readingCookies.jsp --> 
<html> 
<head> 

<title>Reading Cookies</titie> 

<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Reading Cookies</hi> 
<$ 

Cookie cookies[] = null; 

// Get an array of Cookies associated with this domain 

cookies = request.getCookies(); 

if( cookies != null ){ 

out.printin("<h2 class=\"blue_color\"> " 


+ "Found Cookies: Name --- Value</h2>"); 
for (int i = 0; i < cookies.length; i++){ 
out.print ("<h3>Name: " + cookies[i].getName( ) +" --- "); 
out.print("Value: " + cookies[i].getValue( )+"</h3>"); 
} 
}else{ 
out.printin("<h2>No cookies founds</h2>"); 
} 
$> 


<button onclick="location.href='cookiesAndSessions.html'" class="coral color"> 
Back to Cookie & Session Main</button> 

</div> 

</body> 

</html> 
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1| <!DOCTYPE html> 

2| <i-— readingCookies.jsp --> 

3| <html> 

4 <head> 

5| <title>Reading Cookies</title> 

6 <link rel="stylesheet" href="css/css-3.css"> 

7, </head> 

8| <body> 

9| <div class="center"> 

10 <hi>Reading Cookies</ni> 

11) <$ 

12, Cookie cookies[] = null; 

13 // Get an array of Cookies associated with this domain 

14) cookies = request.getCookies(); 

15) if( cookies != null ){ 

16 out.printin("<h2 class=\"blue_ color\"> " 

17] + "Found Cookies: Name --- Value</h2>"); 

18 for (int i = 0; i < cookies.length; i++) { 

19 out.print ("<h3>Name: " + cookies[i].getName( ) +" --- "); 
20| out.print ("Value: " + cookies[i].getValue( )+"</h3>"); 
21| } 

22| }else{ 

23| out.printin("<h2>No cookies founds</h2>"); 

24 } 

25| $> 

26| <button onclick="location.href='cookiesAndSessions.html'" class="coral_color"> 
27| Back to Cookie & Session Main</button> 

28| </div> 

29| </body> 

30) </html> 
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<!DOCTYPE html> 
<!-- readingCookies.jsp --> 
<html> 
<head> 

<title>Reading Cookies</titie> 

<link rel="stylesheet" href="css/css-3.css"> 
</head> 
<body> 
<div class="center"> 
<hi>Reading Cookies</hi> 
<$ 

Cookie cookies[] = null; 

// Get an array of Cookies associated with this domain 

cookies = request.getCookies(); 

if( cookies != null ){ 

out.printin("<h2 class=\"blue_color\"> " 


+ "Found Cookies: Name --- Value</h2>"); 
for (int i = 0; i < cookies.length; i++){ 
out.print ("<h3>Name: " + cookies[i].getName( ) +" --- "); 
out.print("Value: " + cookies[i].getValue( )+"</h3>"); 
} 
}else{ 
out.printin("<h2>No cookies founds</h2>"); 
} 
$> 


<button onclick="location.href='cookiesAndSessions.html'" class="coral color"> 
Back to Cookie & Session Main</button> 

</div> 

</body> 

</html> 
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Image 15 . Code - readingCookies.jsp 


1| <!DOCTYPE html> 
2 <! readingCookies.jsp - 
3| <html> 
4| <head> 
5 <title>Reading Cookies</title> 
6 <link rel="stylesheet" href="css/css-3.css"> 
7; </head> 
8&8 <body> 
9| <div class="center"> 
10| <hi>Reading Cookies</hi> 
11| <% 
12 Cookie cookies{] = null; 
13 Get an array of Cookies associated with this domain 
14 cookies = request.getCookies(); 
15 if( cookies != null ){ 
16 out.printin("<h2 class=\"blue _color\"> " 
17 + "Found Cookies: Name --- Value</h2>"); 
18 for (int i = 0; i < cookies.length; i++) { 
19 out.print ("<h3>Name: " + cookies[i].getName( ) +" --- ")3 
20 out.print("Value: " + cookies[i].getValue( )+"</h3>"); 
21 } 
22 }else{ 
23 out.printiln("<h2>No cookies founds</h2>"); 
24 } 
25. &> 
26, <button onclick="location.href='cookiesAndSessions.html'" class="coral color"> 
27 Back to Cookie & Session Main</button> 
28| </div> 
29| </body> 
30; </html> 
Table 4.630 
-M web 
: È-0) META-INF 
T context. xml 
6-[) WEB-INF 
18| <session-config> 
19 <session-timeout>i</session-timeout> 
20 </session-config> 
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18 
19° 
20 


18 
19 
20, 


<session-config> 
<session-timeout>1</session-timeout> 
</session-config> 


<session-config> 
<session-timeout>1</session-timeout> 
</session-config> 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2635 


2636 CHAPTER 4. ITSE2317 - JAVA PROGRAMMING (INTERMEDIATE) 


Image 16 . Session Timeout 


18| <session-config> 
19 <session-timeout>1</session-timeout> 
20 </session-conficg> 


Table 4.631 


Session Attributes 


visitCountKey visitCountValue 


favoriteBookKey favoriteBookValue 


favoriteBookKey favoriteBookValue 
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Image 17 . Session Attributes 
Session Attributes 


Key Identifier Value Identifier 
userlDKey userlDValue 


visitCountKey visitCountValue 
favoriteBookKey favoriteBookValue 


Table 4.632 


4.5.15.10 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4380: Sessions with JSP 
e Author: Dr. R.L.Martinez 

e Maintainer: R.G.Baldwin 

e File: Java4380.htm 

e Published: 11/27/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


IĮ also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


4.5.16 Java4390: Assessment Questions’ 


4.5.16.1 Table of Contents 


e Preface (p. 2643) 
e Assessment Questions (p. 2643) 
e Miscellaneous (p. 2644) 


291 This content is available online at <http://cnx.org/content /m48129/1.3/>. 
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4.5.16.2 Preface 


This module is one in a collection of modules designed for teaching ITSE 2317 - Java Programming (Inter- 
mediate) at Austin Community College in Austin, TX. 

Assessment questions for the JSP section of the course are presented in this module. The questions 
should not be used as a study guide for the JSP exam. Rather, after extensive preparation, the questions 
can be of value to assess current understanding and command of the topics covered in the JSP modules. 
All exam questions will be extracted from material in the JSP modules and those modules should be the 
primary source for exam preparation. 


4.5.16.3 Assessment Questions 


What characteristic of web development can make it particularly challenging? 
Define the two meanings for "web server". 
What is a JSP container? Name two JSP servers. 
Describe the purposes of Tomcat, Jasper, Catalina, and Coyote. 
When are .jsp files compiled into byte code? 
When a user types oracle.com in the address box and selects "Enter", what page is served by the web 
server? 
7. Describe the purpose of the Request header and Request object. 
8. When are the Request header and Request object created? 
9. Describe the purpose of the Response object and Response header. 
10. When are the Response object and Response header created? 
11. Explain the concept that HTML is designed to represent web page structure. 
12. Explain the concept that CSS is designed to represent web page style. 
13. What is the difference between an HTML element and HTML tag? 
14. What are used to modify HTML elements? 
15. CSS styles consist of what 3 components? 
16. Explain the differences between type, class, and id selectors. 
17. At what levels can CSS be applied? 
18. What is meant by the term "semantic" as it applies to HTML5? 
19. Describe and explain the BOM and DOM. 
20. What is ECMAScript and how does it apply to web development? 
21. What are JSP (Java Server Pages)? 
22. Explain client-side and server-side development /processing. 
23. List the five JSP tag types. 
24. Describe uses for each of the five JSP tag types. 
25. Describe the differences in the way HTML and JSP comments are processed. 
26. What is meant by an "included file"? 
27. Why are some errors diplayed in included files irrelevant? 
28. What is the purpose of the page directive? 
29. Describe the potential issues with the declaration tag. 
30. What is meant by the term "thread-safe"? 
31. What is the purpose of the HTML form element? 
32. What is special about the type="submit" input control? 
33. Can a page have more than one form? 
34. Describe the purpose of name::value pairs. 
35. Define mutually exclusive. 
36. Describe the purposes of the method and action attributes of the form element. 
37. How does the id attribute differ from the name attribute? 
38. Describe the dfferences between the GET and POST methods. 
39. Is element content sent as part of the form submission process? 


COM He GONE, 
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What does the getParameter method do and in what object is it contained? 
Describe the benefits of OO. 

What two things do objects contain? 

What is a servlet context according to Oracle? 

In OO, explain why data is usually private and methods are public. 
Describe the characteristics of the static method in StudentFile.java. 

What is meant by "extracting data from the Request object"? 

Describe how custom Java objects were used in the "Working with Java Classes" module. 
In the "Working with Java Classes" module, explain the purposes for both constructors in Student.java. 
Describe how "this" is used in Student.java. 

What is outWriter in StudentFile.java? 

What is a cookie? 

How are cookies used by websites? 

What is the cookies array? 

When and in what is the cookies array sent to the server? 

Explain how name::value pairs are used with cookies. 

How are cookies added to the Response object? 

What methods are used to obtain the names and values of cookies? 

How is a cookie deleted via code? 

What method (and from what object) is used to populate a local cookie array? 
How do cookies relate to the Request and Response objects? 

Under what circumstances would sessions be used instead of cookies? 
Explain how a session attribute is deleted. 

Explain how a session object is deleted. 

When is a session object created? 

What is the JSESSIONID and where is it stored? 

What is the session key::value pair? 

Why should variables be named with key and/or value appended? 

What is the default session timeout? 

Why might URL rewriting be used? 

What technique could be used to process all cookies in the cookies array? 


4.5.16.4 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4380: Sessions with JSP 
e Author: Dr. R.L.Martinez 

e Maintainer: R.G.Baldwin 

e File: Java4380.htm 

e Published: 11/27/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


Chapter 5 


INEW 2338 Advanced Java (Web) 


5.1 Preface 


5.1.1 Java4510: Preface to INEW 2338' 
5.1.1.1 Table of Contents 


Welcome (p. 2647) 

Programming Oldies but Goodies (p. 2648) 
Downloads (p. 2648) 

Miscellaneous (p. 2648) 


5.1.1.2 Welcome 


Welcome to the course material for INEW2338 - Advanced Java Programming _, which I teach at 
Austin Community College ? in Austin, TX. 

Information about the course 

The college website for this course is: http://www-.austincc.edu/baldwin/ 3 

The prerequisite for the course is ITSE 2317 4 or department approval. 

Beginning in the Fall 2014 semester and updated in the Summer 2015 semester, this course has been 
designed to take on a more web-centric flavor than was previously the case. The course now covers three 
major topics : 


e Network Programming * 
e Search Engines ê 
e Java EE and Frameworks 7 


This material is contained in three major sub-collections in the section titled INEW 2338 Advanced 
Java (Web) at Object-Oriented Programming (OOP) with Java 8. 


1This content is available online at <http://cnx.org/content /m48259/1.7/>. 
*http://www.austincc.edu/ 

3http://www.austincc.edu/baldwin/ 
“http://cnx.org/contents/2554dded-b5f5-4597-a163-4666d529e8b5 
*http://cnx.org/contents/b875bb90-d6a5-44e0-9f24-d89f801ccf44 
Shttp://cnx.org/contents/6c2bdcff-1009-4c30-b04b-70053485043b 
“http://cnx.org/contents/573b7f31-066d-4a71-8ba2-ab2836cc7d88 
Shttp://cnx.org/content /col11441/latest / 
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Note: As of Summer 2015, the servlet material beginning here °? and ending here 1° is no longer 
a required part of this course. However, students are encouraged to study that material for their 
own educational purposes and to enhance their prospects of landing a job as a Java programmer. 


5.1.1.3 Programming Oldies but Goodies 


While much of the material required to succeed in this course is contained in the modules in this sub-collection 
titled INEW 2338 Advanced Java (Web) , a large amount of relevant material is also contained in 
the collection titled Programming Oldies but Goodies !! , which is a work in process. The material in that 
collection has not yet been converted to the cnxml format required by cnx.org. Instead, the material in that 
collection is still in its original html format. 

You would do well to familiarize yourself with that material as well. 


5.1.1.4 Downloads 


I encourage you to take advantage of all of the download options that cnx.org has to offer in order to 
customize this material for use in your organized courses or for personal self study. 


5.1.1.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4510: Preface to INEW 2338 
e File: Java4510.htm 

e Published: 12/17/13 

e Revised 09/04/15 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


®http://cnx.org/contents/d065b23c-7c70-493d-95fd-7e4f9 1f0d99e 
Mhttp://cnx.org/contents/94aa8d30-9b75-4£98-b08£ 6cb526ae24aa 
http://cnx.org/content /coll11478 /latest / 
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5.2 Network Programming 


5.2.1 Java4610-Preface” 
5.2.1.1 Table of Contents 


e Discussion (p. 2649) 
e What’s next? (p. 2649) 
e Miscellaneous (p. 2649) 


5.2.1.2 Discussion 


This module serves as the preface to a sub-collection of modules on network programming. The modules in 
this sub-collection are designed for teaching INEW 2338 Advanced Java (Web) at Austin Community 
College in Austin, TX. 


5.2.1.3 What’s next? 


The next module is titled Java4620: General Information . 
As you might surmise from the title, it deals with such topics as communication protocols, clients, servers, 
IP, TCP, ports, etc. 


5.2.1.4 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4610-Preface 
e File: Java4610.htm 

e Published: 03/02/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


12This content is available online at <http://cnx.org/content /m49532/1.3/>. 
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5.2.2 Java4620: General Information” 
5.2.2.1 Table of Contents 


e Preface (p. 2650) 
e Introduction (p. 2650) 
e Background Information (p. 2651) 


Communication Protocol (p. 2651) 
Network Layers (p. 2651) 

Clients and Servers (p. 2652) 

IP, TCP, and, UDP (p. 2652) 


x IP (p. 2652) 
x TCP (p. 2652) 
* UDP (p. 2652) 


IP Addresses (p. 2653) 

Domain Names (p. 2653) 

What is Your IP Address? (p. 2653) 
Ports (p. 2654) 

Firewalls (p. 2654) 

Proxy Servers (p. 2654) 

Standards and Protocols (p. 2655) 
URL (p. 2655) 


e Socket Classes and the URL Class (p. 2656) 
Socket Programming (p. 2656) 
URL Programming (p. 2657) 


A local area network (p. 2658) 
The operating system (p. 2658) 
What’s Next? (p. 2658) 
Miscellaneous (p. 2658) 


5.2.2.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. More specifically, it is one in a sub-collection of modules 
designed for teaching network programming in that course. The purpose of this module is to introduce the 
student to various aspects of network programming that will be incorporated into future modules. 


5.2.2.3 Introduction 


One of the Java books on my bookshelf makes the following analogy (or one very similar) . Just because 
you may know how to speak conversational French doesn’t mean that you know how to interpret an autopsy 
report written in French. In order to interpret the autopsy report, you must also know a good deal about 
the meaning of the medical terms used in such reports. 

A similar situation exist for networking. It isn’t very difficult to learn how to use the Java programming 
language to implement some network operations. However, in order to achieve depth in this area, you 
probably also need to know something about the many other technical aspects of networking. 

This is not a new field, and many good books have been written on the technical details of networking. 
you are referred to one or more of those books to gain an in-depth knowledge of networking. In particular, 
I would refer you to Java Network Programming 14 by Elliotte Rusty Harold. 


13This content is available online at <http://cnx.org/content /m49533/1.2/>. 
'4http://shop.oreilly.com/product /0636920028420.do 
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In addition there are many other books that contain excellent sections on network programming. I would 
recommend that you take a look at the following: 


Exploring Java by Patrick Niemeyer and Joshua Peck 
Just Java 1.1 and Beyond by Peter van der Linden 
Java Primer Plus by Tyma, Torok, and Downing 
Java How to Program by Deitel and Deitel 


These books have been around for a long time, so you should be able to find a used copy online for a 
reasonable price. 

For the most part, this and the next few modules will be restricted to how you can use the programming 
capabilities of Java to write and execute network programs and won’t attempt to go into overall network 
programming in depth. However, a minimal amount of background information will be required, so we will 
attempt to provide that background in this module. Subsequent modules will use this background along with 
the network programming capabilities of Java to write some simple, but interesting networking programs. 


5.2.2.4 Background Information 


For our purposes, a network is a group of computers and other devices that are connected in some fashion 
for the purpose of exchanging data. 

Each of the devices on the network can be thought of as a node , and each node has a unique address. 
The manner in which addresses are assigned will vary from one type of network to another, but in all cases, 
the address of each device must be unique so as to distinguish it from the other devices. 

Addresses are numeric quantities that are easy for computers to work with, but are not easy for humans 
to remember. Therefore, some networks also provide names that humans can more easily remember than 
numbers. 

Modern networks transfer data using a concept known as packet switching . This means that the data 
are encapsulated into packets that are transferred from the source to the destination. It is necessary to 
extract the data from one or more packets at the destination and use it to reconstruct the original message. 


5.2.2.4.1 Communication Protocol 


In order for two or more computers connected to a network to be able to exchange data in an orderly manner, 
they must adhere to a mutually acceptable communication protocol. The protocol defines the rules by which 
they communicate. 

Teaching your children to say please and thank you involves teaching them something about a protocol. 
If they occasionally forget to say please, however, they will probably get the cookie anyway. 


If a computer protocol requires the participating computers to say please, and they forget to say 
please, they probably won’t get the cookie. 


There are many protocols available. For example, the HTTP protocol defines how web browsers and servers 
communicate and the SMTP protocol defines how email is transferred (we will write programs that imple- 
ment part of the HTTP protocol) . 

Note here that I have been discussing application protocols that operate at the surface level. We will 
also be making mention of lower-level protocols that operate below the application level. Fortunately, as 
high-level Java programmers, we don’t have to be too concerned about the lower-level protocols. We’ll let 
the systems people worry about them. 


5.2.2.4.2 Network Layers 


Networks are logically separated into layers ranging from the Application Layer at the top to the 
Physical Layer at the bottom. The technical details of network layering are beyond the scope of this 
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module. Fortunately, you will be able to write useful network programs using Java without understanding 
the details of network layering. 

The Application Layer is the layer that delivers data to the user. The layers below that are involved 
with getting data from the Application Layer at one end of the conversation to the Application Layer at 
the other end. For the most part, we will be concerned only with the Application Layer 


5.2.2.4.3 Clients and Servers 


In these modules, we will be concerned with networked communications that involve client computers and 
a server computers. How do we know which is which? 


For the purposes of our studies, it will be sufficient to say that the client always initiates the 
conversation, and the server waits and listens for a client to initiate a conversation. 


5.2.2.4.4 IP, TCP, and UDP 


We need to know something about the following acronyms: 


e IP 
e TCP 
e UDP 


5.2.2.4.4.1 IP 


IP , which stands for Internet Protocol , is the protocol that will be involved below the Application 
Layer to move our data between a client and a server. Beyond knowing that it exists, we probably don’t 
need to concern ourselves with the fact that IP is being used 

In fact, in some situations, some other protocol could be used to move our data between a client and a 
server. As long as it works, we really don’t care too much. 

In a nutshell, IP is a network protocol that moves packets of data from a source to a destination. As the 
name implies, this is the protocol normally used on the Internet. 


5.2.2.4.4.2 TCP 


It is sometimes important to be able to have confidence that all packets that make up a message arrive at 
the destination undamaged and in proper order. 

The Transmission Control Protocol ( TCP ) was added to IP to give each end of a connection the 
ability to acknowledge receipt of IP packets and to request retransmission of corrupted or lost packets. 
Also TCP makes it possible to put the packets back together at the destination in the same order that 
they were sent. 

Therefore, you will often hear people using both acronyms in the same breath, as in TCP/IP . The 
two work together to provide a reliable method of encapsulating a message into data packets, sending the 
packets to a destination, and reconstructing the message from the packets at the destination. 


5.2.2.4.4.3 UDP 


Sometimes it may not be critically important that all the packets arrive at the destination or that they 
arrive in the proper order. Further, sometimes, you may not want to incur the time delays and overhead 
cost associated with those guarantees. 

For example, if one computer is sending date and time information to another computer every 100 
milliseconds, and the data in the packets is displayed on a digital clock as it is received, you might prefer 
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that each packet make the trip as quickly as possible even if that means that occasionally a packet will be 
lost or damaged. 

The User Datagram Protocol ( UDP) is available to support this type of operation. UDP is often 
referred to as an unreliable protocol because there is no guarantee that a series of packets will arrive in the 
right order, or that they will arrive at all. 

As Java programmers, we have the choice of TCP or UDP , and we need to know enough about the 
characteristics of each to be able to make informed choices between them. 


5.2.2.4.5 IP Addresses 


We don’t really need to know very much about IP to be able to use it, but we do need to know about the 
addressing scheme used in IP 

Every computer attached to an IP network has a unique address, typically consisting of four bytes or 
32 bits ( IPv415 ) . 

Thirty-two bits are sufficient to define a large number of unique addresses, but the manner in which 
addresses are allocated is wasteful, and many of the addresses that have been allocated are not being used. 

Efforts are underway to expand the number of possible unique addresses to a much larger number. The 
planned number is the number of unique addresses that can be represented with a 128-bit address. The new 
scheme is known as IPv6 !¢ . 

For human consumption, we usually convert the value of each of the bytes to an unsigned decimal value 
and display them connected by periods to make them easier to remember. For example, as near as I can tell, 
as of this writing, the IP address of www.austincc.edu !” (the college where I teach) is 206.77.150.222 


5.2.2.4.6 Domain Names 


What do I mean by www.austincc.edu 18 ? 


Even though we can do some tricks to make the numeric IP addresses easier to remember, humans 
don’t do a very good job of remembering long strings of numbers. Humans remember words and names 
better. Therefore, most IP addresses have a corresponding name known as a domain name . The domain 
name for the IP address 206.77.150.222 is www.austincc.edu 1° . 

The Domain Name System (DNS) was developed to translate between IP addresses and domain names. 
Whenever you log your browser onto the internet and attempt to connect to a server using its domain name, 
the browser first communicates with a DNS server to learn the corresponding numeric IP address. The 
numeric IP address (and not the domain name) is encapsulated into the data packets and used by the 
internet protocol to route those packets from the source to the destination. 


(You should also be able to enter 206.77.150.222 into the address field of your browser and access 
the college where I teach.) 


We will learn how to use the Java InetAddress class to find the domain name corresponding to an IP 
address, and to find the IP address corresponding to a domain name. 


5.2.2.4.7 What is Your IP Address? 


Do you have an IP address and a domain name ? 
If (like me) you use a commercial Internet Service Provider (ISP) for your Internet service at home, 
you probably don’t have a fixed IP address or a fixed domain name . Rather, the ISP has a block of 


l5http://en.wikipedia.org/wiki/IPv6 
16http://en.wikipedia.org /wiki/IPv6 
'Thttp://www.austincc.edu 
'8http://www.austincc.edu 
'9http://www.austincc.edu 
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IP addresses reserved. When you subscribe to the ISP, the ISP temporarily assigns an IP address to you. 
That IP address may or may not change over time, but probably will change unless you pay the extra fee 
for a fixed IP address. 

On the other hand, I currently pay for server space from a company in North Carolina under the domain 
name www.dickbaldwin.com 7° . My domain has an IP address of 98.129.229.162 . For as long as I 
continue to pay the bill, that domain name and that IP address will be assigned to me for use as my personal 
website. 


I suppose that the company could change the IP address at some point provided that they make 
certain that all of the domain name servers get updated to reflect the new IP address that 
corresponds to the domain name. 


5.2.2.4.8 Ports 


Each server computer that you may connect to will be logically organized into ports . These are not physical 
ports in the sense of the VGA or HDMI port on the back of your computer. Rather, they are simply logical 
sub-addresses which you provide to the operating system on the server so that the operating system can 
cause the appropriate server software to "answer the call." We will write a simple server software package 
that will service several different ports on independent threads in a future module. 

One of the Java books on my bookshelf refers to the IP address as being analogous to the telephone 
number of a company and the port to be analogous to the employee’s telephone extension within that 
company. (At least that is how telephone systems in companies were organized when I was working in 
industry.) 

Theoretically, there are 65,535 available ports. Port numbers between 1 and 1023 are predefined to be used 
for certain standard services. For example, if you want to connect with server software that communicates 
using the HTTP protocol, you would normally connect to port 80 on the server of interest. 

Similarly, if you want to connect to a port that will tell you the time, you should connect to port 13, 
assuming that you can find a server somewhere that is willing to support port 13. If you want to connect 
to a port that will simply echo whatever you send to it (usually for test purposes) , you should connect to 
port 7. We will write Java applications that connect to all of these ports. 

In the interest of brevity, I am not going to provide a complete list of ports and their services. However, 
you should be able to find all the information you might need about port numbers and the services they 
support by starting your favorite search engine and searching for " well known ports 7! "". 


5.2.2.4.9 Firewalls 


You may have heard about firewalls . A firewall is the common name given to the equipment and 
associated software that is used to insulate the network inside of a company from the Internet at large 
outside the company. Typically, the firewall will restrict the degree to which computers inside the company 
can communicate with the Internet for security and other reasons. 


5.2.2.4.10 Proxy Servers 


You may also have heard about proxy servers . A proxy server acts as an interface between computers 
inside the company and the Internet at large. 

Oftentimes the proxy server will have the ability to cache web pages for limited periods of time. For 
example, if ten people inside the company attempt to connect to the same Internet server and download the 
same web page within a (hopefully) short period of time, that page may be saved on the proxy server on 
the first attempt and then delivered to the next nine people without re-acquiring it from the outside web 


2°http://www.dickbaldwin.com 
21 http://en.wikipedia.org/wiki/List of TCP and UDP_port numbers 
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server. This can significantly improve delivery time and reduce network traffic into and out of the company. 
It can also result in the delivery of stale pages in some cases. 


5.2.2.4.11 Standards and Protocols 


At some point, you may be interested in obtaining technical information about Internet stan- 
dards and protocol specifications. A good place to start looking for such information is 
http://www.w3.org/pub/WWW /Protocols/ 7? . 


5.2.2.4.12 URL 


URL isan acronym for Uniform Resource Locator . (It is also the name of a class in Java.) A URL 
is a pointer to a particular resource at a particular location on the Internet. A URL specifies the following: 


the protocol used to access the server (such as http) 

the name of the server 

the port on the server (optional) 

the path and name of a specific file on the server (sometimes optional) 
the anchor or reference point within the file (optional) 


Sometimes the name of the file can be omitted, in which case an HTTP browser will usually append the file 
name index.html to the specified path and try to load that file. For example, as of this writing, you can 
connect to my home page on the HTTP server at Austin Community College using either of the following 
URLs: 


e http://www.austincc.edu/baldwin/ 7° 
e http://www.austincc.edu/baldwin/index.html 74 


In addition to specifying the name of the file of interest, it is also sometimes possible to specify an anchor 
or reference that has been established inside the file. The anchor is identified by the text following the # 
character in the URL. 

For example, as of this writing, the following URL will take you to a specific location inside one of my 
modules on Java servlets. 

http: //cnx.org/content /m48518/latest /#¢Images 7° 

(Note the Images at the end of the URL. That is commonly known as the anchor .) 

The general syntax of a URL is as follows: 

protocol: //hostname|:port] /path /filename#ref 

The port is optional, and is not normally required if you are accessing a server that provides the required 
service on a standard port. The browser (or other software being used to connect) should know which port 
supports the specified protocol and should connect to that port by default. 

You could fill in the optional port number and use the following URL to access the same location in my 
servlets module, but that would simply require you to do some extra typing. 

http: //cnx.org:80/content /m48518/latest /#¢Images 7° 

However, if you were to change the 80 to a 25, you would not be able to connect and successfully 
communicate with the server because the server does not support the HTTP protocol on port 25. In fact, 
here is the text of the Firefox error message that resulted from me doing that: 


"This address is restricted This address uses a network port which is normally used for purposes 
other than Web browsing. Firefox has canceled the request for your protection." 


2http://www.w3.org/pub/WWW /Protocols/ 
3http://www.austincc.edu/baldwin/ 
4http://www.austincc.edu/baldwin/index.html 
>http://cnx.org/content /m48518/latest /#+Images 
6http://cnx.org:80/content /m48518/latest /#+Images 
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The Google Chrome browser simply provided the following error message when I attempted to do that. 
"This webpage is not available." 
When I clicked a "More" button on the Chrome error message, this is what I got: 


"The webpage at http://cnx.org:25/content /m48518/latest/#Images might be temporarily down 
or it may have moved permanently to a new web address. Error code: ERR_UNSAFE_PORT" 


Note, however, that we will be properly addressing port 8080 on a particular server in some future modules. 
Since 8080 is not a standard port, it will be necessary for us to enter the port number following a colon in 
order to access the material on the server. 


5.2.2.5 Socket Classes and the URL Class 


Java provides at least two different approaches for doing network programming (and possibly more) , insofar 
as the web is concerned. The two approaches are associated with 


e The Socket , DatagramSocket , and ServerSocket classes 
e The URL, URLEncoder, and URLConnection classes. 


5.2.2.5.1 Socket Programming 


Socket programming primarily makes use of two socket classes named Socket and DatagramSocket along 
with the ServerSocket class. The first two socket classes represent TCP and UDP communications 
respectively. 

Generally, the two socket classes are used to implement both clients and servers , while the Server- 
Socket class is only used to implement servers . We will see several examples of socket programming in 
this series of modules. 

Socket programming provides a low-level approach by which you can connect two computers for the 
exchange of data. One of those is generally considered to be the client while the other is considered to be 
the server 

Although the distinction between client and server is becoming less clear each day, there is one funda- 
mental distinction that is inherent in the Java programming language. 


The client initiates conversations with servers, while servers block and wait for a client to initiate 
a conversation. 


The governing application-level protocol will determine what happens after the connection is made and the 
conversation has begun. The fact that the two computers can connect doesn’t necessarily mean that they 
can communicate. In order to communicate, they must implement some mutually acceptable application 
protocol 

For example, the fact that I can dial a telephone number for a telephone located in France doesn’t mean 
that I can communicate with the person who answers the phone. I don’t know how to speak the French 
language. Unless the person who answers the phone speaks English, very little communication is likely to 
take place. 

Socket programming has been around for quite a while in the Unix world. Java simply makes it easier 
by encapsulating much of the complexity of socket programming into classes, and allowing you to approach 
the task on an object-oriented basis. 

On the other hand, according to some authors, some of the generality and capability that Unix socket 
programmers have enjoyed has been lost in the encapsulation process. 

Basically, socket programming makes it possible for you to cause data to flow in a full-duplex mode 
between a client and a server. This data flow can be viewed in almost exactly the same way that we view 
data flow to and from a disk: as a stream of bytes. 
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As with most stream data processing, the system is responsible for moving the bytes from the source to 
the destination. It is the responsibility of the programmer to assign meaning to those bytes. 

Assigning meaning takes on a special significance for socket programming. In particular, as mentioned 
above, it is the responsibility of the programmer to implement a mutually acceptable communication protocol 
at the application level to cause the data to flow in an orderly manner. 

An application protocol is a set of rules by which the programs in the two computers can carry on a 
conversation and transfer data in the process. For example, we will also write a program that implements a 
very abbreviated form of the HTTP protocol to download web pages from a server and display them. 

We will also write a program that functions as an (abbreviated) HTTP server to deliver web pages to 
a client and also supports the echo protocol for both TCP and UDP programming. 

Each of these programs will involve adherence to a fairly simple protocol. (At least the part that we 
implement will be fairly simple) . 

In addition, we will also write a program that obtains the date and time from another computer. In this 
case, the protocol will be about as simple as it can possibly be. The client will simply make the connection 
and listen for a string containing the date and time. This will be sort of like dialing the local time service, 
except that we won’t have to listen to an advertisement before getting the time. 

The bottom line is that with socket programming, it is easy to write code that will cause a stream of 
bytes to flow in both directions between a client and a server. This is no more difficult than causing a stream 
of bytes to flow in both directions between memory and a file on a disk. 

However, getting the bytes to flow is the easy part. Beyond that, you must do all of the programming to 
implement an application protocol that is understood by both the client and the server. 


5.2.2.5.2 URL Programming 


URL programming occurs at a higher level than socket programming, and in theory represents a very powerful 
idea. 

In theory, by using the URL class, you can open a connection to a resource on the web, specified by 
a URL object, and simply call the getContent method on that URL object. The content of the 
resource will then be magically downloaded and will appear as an object on the client machine, even if it 
requires an application protocol that didn’t exist when you wrote the program, and contains content that 
you didn’t understand when you wrote the program. 

This description may be a bit of an overstatement, but it is pretty close to the claims being made. This 
is a powerful idea, which may or may not bear fruit in the future. 

If fully implemented by browsers, the idea means that you can place new and unusual material on a web 
site along with special content handlers and protocol handlers. Then a cooperating browser will use those 
special handlers to move that material from the web site to the client and interpret its content once it gets 
there without a requirement to install software (such as plug-ins) on the client computer on a permanent 
basis. 

Here is what Peter van der Linden has to say about this topic in his excellent book titled Just Java 1.1 
and Beyond: 


"If a browser doesn’t recognize a media type, it should be able to download the code to process 
it from the same place it got the file. If they ever get this working, it will be ... a good thing." 


Is it working, or will they ever get it working? I don’t know. If it depends on cooperation among all the 
major players, including the major browser vendors - probably not. Therefore, I don’t plan to spend much 
time on the topic of protocol and content handlers until I see some evidence that it is working to such an 
extent that it is practically useful. 

That is not to say that you couldn’t use the capability right now if you were developing an intranet and 
wanted the clients to have access to new and unusual content. It would be necessary for you to provide the 
appropriate protocol and content handlers, and it would probably be necessary for the clients to run Java 
applications written by you instead of standard browsers to access the data. 
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Also, the URL class provides an alternative way to connect one computer to another and transfer 
data on a stream basis, so we will see some examples of retrieving data from a server by obtaining a URL 
connection, and then opening and servicing I/O streams between the client and the server. We will see some 
sample programs that make use of this technique, but we will also see that it is somewhat redundant with 
the socket programming approach. 


5.2.2.6 A local area network 


This is part of a sub-collection of modules designed for teaching network programming. Therefore, you may 
find some of the modules more meaningful if you are able to connect two or more computers in a local area 
network and run the sample programs across the network. 

However, it is possible to simulate a network inside a single computer. If you are unable to create an 
actual network, you should be able to run all of the sample programs by simulating a network in your single 
computer. 


5.2.2.7 The operating system 


While the capabilities of Java are generally independent of the operating system in use, the manner in 
which an individual computer must be configured for network operation is generally not independent of the 
operating system. 

In those cases where these modules provide instructions for configuring the computer, those instructions 
will assume a Windows operating system. If you are using a different operating system, you will need to 
translate those instructions into your operating system. 


5.2.2.8 What’s Next? 


We will learn how to use the Java InetAddress class to find the domain name corresponding to an IP 
address, and to find the IP address corresponding to a domain name in our sample program in the next 
module. 


5.2.2.9 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4620: General Information 
e File: Java4620.htm 

e Published: 03/02/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 
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Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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5.2.3 Java4620r-Review™ 
5.2.3.1 Table of Contents 


e Preface (p. 2660) 
e Questions (p. 2660) 


1 (p. 2660) , 2 (p. 2660) , 3 (p. 2660) , 4 (p. 2660) , 5 (p. 2661) , 6 (p. 2661) , 7 (p. 2661) , 8 
(p. 2661) , 9 (p. 2661) , 10 (p. 2661) , 11 (p. 2661) , 12 (p. 2662) , 13 (p. 2662) , 14 (p. 2662) 
, 15 (p. 2662) , 16 (p. 2662) , 17 (p. 2662) , 18 (p. 2662) , 19 (p. 2663) , 20 (p. 2663) , 21 (p. 
2663) , 22 (p. 2663) , 23 (p. 2663) , 24 (p. 2663) 


e Answers (p. 2665) 
e Miscellaneous (p. 2668) 


5.2.3.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4620: General Infor- 
mation 7° in the Network Programming sub-collection. 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


5.2.3.3 Questions 
5.2.3.3.1 Question 1 


True or False? 

A network is a group of computers and other devices that are connected in some fashion for the purpose 
of exchanging data. 

Go to answer 1 (p. 2668) 


5.2.3.3.2 Question 2 


True or False? 
Each of the devices on the network can be thought of as a node , and each node has the same address. 
Go to answer 2 (p. 2668) 


5.2.3.3.3 Question 3 


True or False? 
Modern networks transfer data using a concept known as packet switching . 
Go to answer 3 (p. 2668) 


5.2.3.3.4 Question 4 


True or False? 

In order for two or more computers connected to a network to be able to exchange data in an orderly 
manner, each computer must use a different protocol. The protocol defines the rules by which they commu- 
nicate. 

Go to answer 4 (p. 2668) 


2"This content is available online at <http://cnx.org/content/m49577/1.3/>. 
8http://cnx.org/content /m49533/latest /?collection=coll 1441 /latest 
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5.2.3.3.5 Question 5 


True or False? 

The HTTP protocol defines how web browsers and servers communicate and the SMTP protocol defines 
how some email is transferred 

Go to answer 5 (p. 2667) 


5.2.3.3.6 Question 6 


True or False? 
IP is an acronym that stands for Interconnection Protocol. 
Go to answer 6 (p. 2667) 


5.2.3.3.7 Question 7 


True or False? 
IP is a network protocol that moves packets of data from a source to a destination. As the name 
implies, this is the protocol normally used on the Internet. 
Go to answer 7 (p. 2667) 


5.2.3.3.8 Question 8 


True or False? 

The Transmission Control Protocol ( TCP ) was added to IP to give each end of a connection the 
ability to acknowledge receipt of IP packets and to request retransmission of corrupted or lost packets. 
Also TCP makes it possible to put the packets back together at the destination in the same order that 
they were sent. 

Go to answer 8 (p. 2667) 


5.2.3.3.9 Question 9 


True or False? 
TCP and IP work together to provide a reliable method of encapsulating a message into data packets, 
sending the packets to a destination, and reconstructing the message from the packets at the destination. 
Go to answer 9 (p. 2667) 


5.2.3.3.10 Question 10 


True or False? 

The User Datagram Protocol ( UDP) is even more reliable than TCP/IP in guaranteeing that a 
series of packets will arrive in the right order. However, UDP involves a high level of overhead and the 
data transfer rate may be slow. 

Go to answer 10 (p. 2667) 


5.2.3.3.11 Question 11 


True or False? 

Every computer attached to an IP network has a unique address, typically consisting of four bytes or 
32 bits. Efforts are underway to expand the number of possible unique addresses to a much larger number. 
The planned number is the number of unique addresses that can be represented with a 128-bit address. 

Go to answer 11 (p. 2667) 
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5.2.3.3.12 Question 12 


True or False? 

For human consumption, we usually convert the value of each of the IP address bytes to an unsigned 
decimal value and display them connected by periods to make them easier to remember. For example, a 
typical IP address might be 206.777.150.222 

Go to answer 12 (p. 2667) 


5.2.3.3.13 Question 13 


True or False? 
Most IP addresses have a corresponding name known as a domain name . 
Go to answer 13 (p. 2667) 


5.2.3.3.14 Question 14 


True or False? 

The Domain Name of a destination server is encapsulated into data packets and used by the internet 
protocol to route those packets from the source to the destination. 

Go to answer 14 (p. 2667) 


5.2.3.3.15 Question 15 


True or False? 

The Java InetAddress class can often be used to find the domain name corresponding to an IP 
address, and to find the IP address corresponding to a domain name. 

Go to answer 15 (p. 2666) 


5.2.3.3.16 Question 16 


True or False? 

Each server computer that you may connect to will be logically organized into ports . Theoretically, 
there are a large number of available ports. A subset of those port numbers are predefined to be used for 
certain standard services. For example, if you want to connect with a public server that communicates using 
the HTTP protocol, you would normally connect to port 80 on the server of interest. 

Go to answer 16 (p. 2666) 


5.2.3.3.17 Question 17 


True or False? 
A firewall is the common name given to the equipment and associated software that is used to improve 
the communication speed of computers inside of a company with the Internet at large outside the company. 
Go to answer 17 (p. 2666) 


5.2.3.3.18 Question 18 


True or False? 

A proxy server is the common name given to the equipment and associated software that is used to 
insulate the network inside of a company from the Internet at large outside the company. Typically, the 
firewall will restrict the degree to which computers inside the company can communicate with the Internet 
for security and other reasons. 

Go to answer 18 (p. 2666) 
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5.2.3.3.19 Question 19 


True or False? 

URL is an acronym for Uniform Resource Locator . (It is also the name of a class in Java.) A 
URL is a pointer to a particular resource at a particular location on the Internet. 

Go to answer 19 (p. 2666) 


5.2.3.3.20 Question 20 


True or False? 
A URL specifies the following: 


the protocol used to access the server (such as http) 

the name of the server 

the port on the server (optional) 

the path and name of a specific file on the server (sometimes optional) 
the anchor or reference point within the file (optional) 


Go to answer 20 (p. 2666) 


5.2.3.3.21 Question 21 


True or False? 
Java provides at least two different approaches for doing network programming (and possibly more) , 
insofar as the web is concerned. The two approaches are associated with 


e The Connector , DatagramConnector , and ServerConnector classes 
e The URL, URLEncoder, and URLConnection classes. 


Go to answer 21 (p. 2666) 


5.2.3.3.22 Question 22 


True or False? 

The two socket classes named Socket and DatagramSocket represent TCP and UDP commu- 
nications respectively. 

Go to answer 22 (p. 2665) 


5.2.3.3.23 Question 23 


True or False? 

Generally, the Socket and DatagramSocket classes are used to implement both clients and 
servers , while the ServerSocket class is only used to implement servers . 

Go to answer 23 (p. 2665) 


5.2.3.3.24 Question 24 


True or False? 
Although the distinction between client and server is becoming less clear each day, there is one funda- 
mental distinction that is inherent in the Java programming language. 


The server initiates conversations with clients, while clients block and wait for a server to initiate 
a conversation. 
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Go to answer 24 (p. 2665) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None KEX] 


Display your name 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


5.2.3.4 Answers 
5.2.3.4.1 Answer 24 


False. 
Although the distinction between client and server is becoming less clear each day, there is one funda- 
mental distinction that is inherent in the Java programming language. 


The client initiates conversations with servers, while servers block and wait for a client to initiate 
a conversation. 


Go back to Question 24 (p. 2663) 


5.2.3.4.2 Answer 23 


True. 
Go back to Question 23 (p. 2663) 


5.2.3.4.3 Answer 22 


True. 
Go back to Question 22 (p. 2663) 
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5.2.3.4.4 Answer 21 


False. 
Java provides at least two different approaches for doing network programming (and possibly more) , 
insofar as the web is concerned. The two approaches are associated with 


e The Socket , DatagramSocket , and ServerSocket classes 
e The URL, URLEncoder, and URLConnection classes. 


Go back to Question 21 (p. 2663) 


5.2.3.4.5 Answer 20 


True. 
Go back to Question 20 (p. 2663) 


5.2.3.4.6 Answer 19 


True. 
Go back to Question 19 (p. 2663) 


5.2.3.4.7 Answer 18 


False. A proxy server is often used to improve the communication speed of computers inside of a company 
with the Internet at large outside the company. For example, if ten people inside the company attempt to 
connect to the same Internet server and download the same web page within a (hopefully) short period of 
time, that page may be saved on the proxy server on the first attempt and then delivered to the next nine 
people without re-acquiring it from the outside web server. This can significantly improve delivery time and 
reduce network traffic into and out of the company. 

Go back to Question 18 (p. 2662) 


5.2.3.4.8 Answer 17 


False. A firewall is the common name given to the equipment and associated software that is used to insulate 
the network inside of a company from the Internet at large outside the company. Typically, the firewall will 
restrict the degree to which computers inside the company can communicate with the Internet for security 
and other reasons. 

Go back to Question 17 (p. 2662) 


5.2.3.4.9 Answer 16 
True. 

Go back to Question 16 (p. 2662) 
5.2.3.4.10 Answer 15 


True. 
Go back to Question 15 (p. 2662) 
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5.2.3.4.11 Answer 14 
False. The Domain Name System (DNS) was developed to translate between IP addresses and domain 
names. Whenever you log your browser onto the internet and attempt to connect to a server using its domain 
name, the browser first communicates with a DNS server to learn the corresponding numeric IP address. 
The numeric IP address (and not the domain name) is encapsulated into the data packets and used by 
the internet protocol to route those packets from the source to the destination. 

Go back to Question 14 (p. 2662) 
5.2.3.4.12 Answer 13 
True. 

Go back to Question 13 (p. 2662) 
5.2.3.4.13 Answer 12 
True. 

Go back to Question 12 (p. 2662) 
5.2.3.4.14 Answer 11 
True. 

Go back to Question 11 (p. 2661) 
5.2.3.4.15 Answer 10 


False. The User Datagram Protocol ( UDP) is often referred to as an unreliable protocol because there 
is no guarantee that a series of packets will arrive in the right order, or that they will arrive at all. 
Go back to Question 10 (p. 2661) 
5.2.3.4.16 Answer 9 
True. 
Go back to Question 9 (p. 2661) 
5.2.3.4.17 Answer 8 
True. 
Go back to Question 8 (p. 2661) 
5.2.3.4.18 Answer 7 
True. 
Go back to Question 7 (p. 2661) 
5.2.3.4.19 Answer 6 
False. IP is an acronym that stands for Internet Protocol. 
Go back to Question 6 (p. 2661) 
5.2.3.4.20 Answer 5 


True. 
Go back to Question 5 (p. 2661) 
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5.2.3.4.21 Answer 4 


False. In order for two or more computers connected to a network to be able to exchange data in an orderly 
manner, they must adhere to a mutually acceptable communication protocol. The protocol defines the rules 
by which they communicate. 

Go back to Question 4 (p. 2660) 


5.2.3.4.22 Answer 3 


True. 
Go back to Question 3 (p. 2660) 


5.2.3.4.23 Answer 2 


False. Each of the devices on the network can be thought of as a node , and each node has a unique 
address. 
Go back to Question 2 (p. 2660) 


5.2.3.4.24 Answer 1 


True. 
Go back to Question 1 (p. 2660) 


5.2.3.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4620r-Review 
e File: Java4620r.htm 

e Published: 03/08/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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5.2.4 Java4630: The InetAddress Class” 
5.2.4.1 Table of Contents 
e Preface (p. 2669) 


Viewing tip (p. 2669) 


x Images (p. 2669) 
x Listings (p. 2669) 


General background information (p. 2670) 
Discussion and sample code (p. 2670) 
Run the program (p. 2678) 

What’s next? (p. 2678) 

Miscellaneous (p. 2678) 

Complete program listing (p. 2679) 


5.2.4.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. More specifically, it is one in a sub-collection of modules 
designed for teaching network programming in that course. The purpose of this module is to introduce the 
student to the InetAddress class that can be used to deal with IP addresses and domain names . 


5.2.4.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


5.2.4.2.1.1 Images 


Image 1 (p. 2671) . Program output. 
Image 2 (p ) . The list of Google IP addresses. 
Image 3 (p. 2673) . The IP Address for my localhost. 
Image 4 (p. 2674) . Name and IP address of my localhost. 
Image 5 (p. 2675) . Canonical host name for Google. 

( ) 


Image 6 (p. 2677) . Google host name using reverse lookup. 


5.2.4.2.1.2 Listings 


Listing 1 (p. 2671) . Beginning of the program. 
Listing 2 (p. 2672) . Display the Google Inet Address objects. 
Listing 3 (p. 2673) . Get InetAddress object for localhost. 


) 
( ) 
( ) 
Listing 4 (p. 2674) . Extract name and IP address of my localhost. 
Listing 5 (p. 2675) . Get and display canonical host name for Google. 
Listing 6 (p. 2676) . Do a reverse lookup on Google. 

Listing 7 (p. 2677) . End of the program. 

Listing 8 (p. 2679) . Complete program listing. 


?°This content is available online at <http://cnx.org/content /m49534/1.2/>. 
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5.2.4.3 General background information 


Every computer attached to an IP network has a unique 32-bit or 128-bit IP address. 

For human consumption, we usually convert each of the bytes in the IP address to an unsigned decimal 
value and display them connected by periods to make them easier to remember. As of this writing, the IP 
address of www.austincc.edu 3° (the college where I teach) is 206.77.150.222. 

The domain name 

What do we mean when we speak of www.austincc.edu 

Each IP address can have a corresponding name known as a domain name . The domain name for 
the IP address 206.77.150.222 is www.austincc.edu 3? . 

For example, I can enter either the IP address or the domain name into the address field of my browser 
and use it to connect to the ACC web site. 

The Domain Name System (DNS) 

The Domain Name System (DNS) was developed to translate between IP addresses and domain names. 
Whenever you log your browser onto the internet and attempt to connect to a server using its domain name 
, the browser first communicates with a DNS server to learn the corresponding numeric IP address. The 
numeric IP address is encapsulated into the data packets and used by the internet protocol to route those 
packets from the source to the destination. 

The InetAddress class 

We will learn how to use methods of the Java InetAddress class to find the IP address corresponding 
toa domain name in this module. 

We will learn how to find the canonical host name for a given domain name. 

We will learn how to obtain information about the localhost . 

We will learn how to do a reverse lookup to find the canonical host name associated with an IP address. 

Methods of the Inet Address class 

The InetAddress class provides several static methods that return a reference to an object of type 
InetAddress . You can use those methods to deal with and to manipulate IP addresses and domain names. 

For example, the static getByName(String host) method returns a reference to an Inet Address 
object representing the host whose domain name is passed as a parameter to the method. The resulting 
object can be used to determine the IP address and the canonical host name of the host. 

There is a problem with this, however. As I will explain later, many hosts have multiple IP addresses. 
To accommodate this, the InetAddress class provides a method named getAllByName(String host) 
that can be used to get an array of references to InetAddress objects representing IP addresses assigned 
to the host. 

The getLocalHost method returns a reference to an InetAddress object representing the local host 
computer. 

There are also a variety of methods that can be called on an InetAddress object to get information 
about the host that is represented by that object. 


31? 


5.2.4.4 Discussion and sample code 


I will present and explain a program named Java4630a that illustrates various aspects of the Inet Address 
class in this module. 

I will explain the program in fragments. A complete listing of the program is provided in Listing 8 (p. 
2679) . 

The program output 

The program produces the screen output shown in Image 1 (p. 2671) when run on my computer. However, 
the information regarding the LocalHost will be different when you run this program on your computer. 


3°http://www.austincc.edu 
31http://www.austincc.edu 
32http://www.austincc.edu 
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Image 1 . Program output. 


Get and display InetAddress(es) of Google URL 
www. google.com/173.194.115.17 
www. google.com/173.194.115.18 
www. google.com/173.194.115.19 
www. google.com/173.194.115.20 
www. google.com/173.194.115.16 


Get and display current InetAddress of LocalHost 
de118700/192.168.2.16 


Extract and display current name of LocalHost 
de118700 


Extract and display current address of LocalHost 
192.168.2.16 


Display canonical host name for Google 
dfw06s39-in-f17.1e100.net 

Display Google name using reverse lookup. 
dfw06s39-in-f17.1e100.net 
dfw06s39-in-f17.1e100.net 


Table 5.1 


I will refer to this output in context as I explain the various elements of the program. 

Beginning of the program 

This is a very simple program consisting solely of the main method in a class named Java4630a 
The program begins in Listing 1 (p. 2671) . 


Listing 1 . Beginning of the program. 


import java.net.*; 


class Java4630af{ 
public static void main(String[] args){ 
try{ 
System.out .println( 
"Get and display InetAddress(es) of Google URL"); 
InetAddress[] addresses = 
InetAddress. getAl1ByName ("www.google.com"); 


Table 5.2 


Domain names and IP addresses 
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There is not necessarily a one-to-one correspondence between IP addresses and domain names. In fact 
there can be a many-to-one correspondence between the two. 

Every computer on the Internet must have a unique IP address, but multiple computers can have (or can 
respond to) the same domain name. For example, if the domain name, www.google.com 33 , were required to 
apply to a single computer, that computer would require an enormous amount of bandwidth and processing 
power to accommodate all of the search requests that are made to that domain name every second of every 
day. 

The getAllIByName method 

The InetAddress class provides a static method named getAllByName that takes the domain 
name of a host as an incoming parameter and returns an array containing references to one or more objects of 
type InetAddress . Each object contains an IP address and some other information related to the domain 
name. The set of InetAddress objects in the array contain all of the IP addresses that are currently 
assigned to that domain name. 

Get all for Google 

The code in Listing 1 (p. 2671) calls the getAllByName method passing the domain name for Google 
as a parameter. It receives a reference to an array containing references to one or more InetAddress 
objects. The set of Inet Address objects encapsulate a list of five IP addresses that are currently assigned 
to Google. 

Display the Inet Address objects 

Listing 2 (p. 2672) contains a for loop that displays the toString version of the information 

encapsulated in each of the InetAddress objects. 


Listing 2 . Display the Google Inet Address objects. 


for(int cnt=0; cnt<addresses.length;cnt++){ 
System. out.println(addresses[cnt]) ; 
}//end for loop 


Table 5.3 


Image 2 (p. 2672) shows the output produced by Listing 1 (p. 2671) and Listing 2 (p. 2672) . 


Image 2 . The list of Google IP addresses. 


Get and display InetAddress(es) of Google URL 
www. google.com/173.194.115.83 
www. google.com/173.194.115.84 
www. google.com/173.194.115.80 
www. google.com/173.194.115.81 
www. google.com/173.194.115.82 


Table 5.4 


Everything to the left of the slash in the last five lines of Image 2 (p. 2672) shows the domain name. 
Everything to the right of the slash shows the IP addresses. Note that there are duplicate domain names 
but there are no duplicate IP addresses. 


33http://www.google.com 
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Why only five IP addresses? 

I was surprised that there are only five IP addresses in the list. Surely Google needs more than five 
front-end computers to handle the thousands of incoming requests that it receives every second of every day. 

Upon further investigation I noticed that if I run the same program over and over, I am likely to get 
different sets of five IP addresses on different runs. This suggests that in some fashion, the get AllByName 
method limits the number of InetAddress objects to only five of the potentially hundreds of IP addresses 
that are assigned to a particular host. However, this is not mentioned in the Oracle documentation. The 
documentation states: 


"Given the name of a host, returns an array of its IP addresses, based on the configured name 
service on the system." 


There is clearly more going on here than I understand. 

The localhost 

The computer that you are using to read this module online also has an IP address and a name. The IP 
address, the name, and perhaps some other things as well are grouped together under something commonly 
referred to as localhost . In other words, the IP address of your localhost is the IP address of the computer 
that you are using to read this module. 

Get Inet Address object for localhost 

The code in Listing 3 (p. 2673) calls the static getLocalHost method of the InetAddress class to 
get a reference to an InetAddress object representing the computer that I was using when I wrote this 
module. 

Then it passes that object’s reference to the println method causing the overridden toString method 
belonging the InetAddress object to be executed. 


Listing 3 . Get Inet Address object for localhost. 


System.out.printin();//blank line 
System.out.println("Get and display current " + 
"TInetAddress of LocalHost"); 
InetAddress address = InetAddress.getLocalHost () ; 
System.out.println(address) ; 


Table 5.5 


The screen output for localhost 
The string returned by the overridden toString method of the InetAddress object is shown by the 
second line in Image 3 (p. 2673) . 


Image 3 . The IP Address for my localhost. 


Get and display current InetAddress of LocalHost 
de118700/192.168.2.16 


Table 5.6 
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Everything to the left of the slash is the name of the computer. Everything to the right of the slash is 
the IP address. 

A local area network 

Note that this is not the IP address by which the world sees my computer on the Internet. Instead, this 
is one of several computers on a local area network. This is the address that was assigned to this computer 
by the network router. 

I can find the IP address that my cable modem presents to the world by entering the following text into 
the Google search box without the quotation marks: "get ip address" 

As you can see, the second line in Image 3 (p. 2673) contains both the name and the IP address separated 
by a slash character. 

Extract name and IP address of my localhost 

Assume that you have a reference to an InetAddress object and for some reason you need to extract 
the name and IP address as separate String objects. (We will need to do this in a future module.) The 
InetAddress class provides two methods that allow you to do that. 

The code in Listing 4 (p. 2674) calls the getHostName andthe getHostAddress methods on the 
reference to the InetAddress object and displays the strings returned by those methods. 


Listing 4 . Extract name and IP address of my localhost. 


System.out.println();//blank line 
System.out.println("Extract and display current " + 
"name of LocalHost") ; 
System.out .println(address.getHostName()) ; 


System.out.println();//blank line 

System.out.println("Extract and display current " + 
“address of LocalHost") ; 

System.out.println(address.getHostAddress()); 


Table 5.7 


The code in Listing 4 (p. 2674) produces the output shown in Image 4 (p. 2674) . 


Image 4 . Name and IP address of my localhost. 


Extract and display current name of LocalHost 
de118700 


Extract and display current address of LocalHost 
192.168.2.16 


Table 5.8 
But, we already knew the answer 


Of course, we already knew what the output would be based on the toString output in Image 3 (p. 
2673) . The difference is that in Image 3 (p. 2673) , we only have that information as part of something 
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that is displayed on the screen. The code in Listing 4 (p. 2674) gives us that same information in the form 
of String objects that we can use for some purpose other than simply looking at the information on the 
screen. (See googleAddress in Listing 6 (p. 2676) for example.) 

Canonical host name 


The documentation describes the method named getCanonicalHostName partially as follows: 


"Gets the fully qualified domain name for this IP address. Best effort method, meaning we may 
not be able to return the FQDN depending on the underlying system configuration." 


One online description for a canonical host name reads as follows: 


"A host machine on a network can be identified by several different names. However, each host 
must have one official hostname. All other hostnames are considered aliases of the canonical 
hostname" 


Get and display canonical host name for Google 


Returning now to Google, the code in Listing 5 (p. 2675) gets and displays the canonical hostname for 
Google. 


Listing 5 . Get and display canonical host name for Google. 


System.out.print1n( 
"Display canonical host name for Google"); 
//Get InetAddress containing one of Google’s 
// IP addresses. 
address = InetAddress.getByName ("www.google.com"); 
System.out .println(address.getCanonicalHostName()) ; 


Table 5.9 


The code in Listing 5 (p. 2675) begins by getting a reference to one of the InetAddress objects that 
represent www.google.com 34 . Then the getCanonicalHostName method is called on that object to get 
and display the canonical host name. The code in Listing 5 (p. 2675) produces the output shown in Image 
5 (p. 2675) . 


Image 5 . Canonical host name for Google. 


Display canonical host name for Google 
dfw06s39-in-f17.1e100.net 


Table 5.10 


As you can see, this canonical host name wouldn’t mean much to a human observer. 
Other canonical host names 
Here is a list of some canonical host names that can be obtained using code similar to that shown in 


Image 5 (p. 2675) . Try pasting them into your browser’s address window and pressing the Enter key to see 
which ones access the sites that you expect and which ones don’t 


34http://www.google.com 
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www.google.com 35 : dfw06s39-in-f17.1¢100.net 

www.amazon.com °° : (No canonical host name was returned.) 
www.yahoo.com 2” : ir2.fp.vip.bfl-yahoo.com 
www.dickbaldwin.com °° : (No canonical host name was returned.) 
www.whitehouse.gov 3° : (No canonical host name was returned.) 
www.healthcare.gov *° : a23-207-26-194.deploy.static.akamaitechnologies.com 
www.austincc.edu 4! : m20677150222.austincc.edu 

www.ebay.com 4? : www.ebay.com 

www.facebook.com * : edge-star-shv-02-dfw1 .facebook.com 
www.twitter.com 44 : (No canonical host name was returned.) 
www.foxnews.com “ : a96-17-203-72.deploy.akamaitechnologies.com 
www.cbsnews.com 4° : a96-17-203-90.deploy.akamaitechnologies.com 


Reverse lookup 

At one point in the history of Java, it was possible to call the getByName method passing the IP 
address as a string to do a reverse lookup on an IP address. The method would return the domain name 
to which the IP address was assigned. However, this changed around Java version 1.4 and some additional 
code is now required to do a reverse lookup. 

Do a reverse lookup on Google 

Listing 6 (p. 2676) does a reverse lookup on Google by passing one of the IP addresses to the getBy- 
Name method and then calling the following methods on the InetAddress object that is returned: 


e getHostName 
e getCanonicalHostName 


Listing 6 . Do a reverse lookup on Google. 


System.out.print1n( 
"Display Google name using reverse lookup."); 
String googleAddress = address. getHostAddress() ; 
System.out .println(InetAddress. getByName( 
googleAddress) .getHostName()) ; 
System. out .println(InetAddress. getByName( 
googleAddress) . getCanonicalHostName()) ; 


Table 5.11 


The code in Listing 6 (p. 2676) produces the output shown in Image 6 (p. 2677) . 


35http://www.google.com 
36http://www.amazon.com 
37http://www.yahoo.com 
38http://www.dickbaldwin.com 
3°http://www.whitehouse.gov 
4°http://www.-healthcare.gov 
“Thttp://www.austincc.edu 
42http://www.ebay.com 
43http://www.facebook.com 
44http://www.twitter.com 
45http://www.foxnews.com 
46http://www.cbsnews.com 
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Image 6 . Google host name using reverse lookup. 


Display Google name using reverse lookup. 
dfw06s39-in-f17.1e100.net 
dfw06s39-in-f17.1e100.net 


Table 5.12 


The canonical host name 

To me, the most interesting thing in Image 6 (p. 2677) is that both methods return the canonical host 
name. Neither method returns the domain name. 

Although it isn’t shown here, calling the getHostName method on one of the InetAddress objects 
contained in the addresses array in Listing 1 (p. 2671) returns the domain name or www.google.com 47 
. Calling the getCanonicalHostName on the same InetAddress object returns the canonical name 
shown in Image 5 (p. 2675) . 

Apparently when you create an InetAddress object on the basis of the domain name, the object knows 
both the domain name and the canonical host name. However, when you create an InetAddress object 
using the IP address, the only name that it knows is the canonical host name. 


The InetAddress class also has a method named getByAddress that apparently provides 
the same behavior when the IP address is converted to an array of bytes and passed to the method 
in that format. However, I haven’t tested that method. 


Can you access the site with the canonical host name 

With respect to Google, the canonical host name, the domain name, or one of the IP addresses can be 
used in your browser address field to access the site. 

However, for those websites in the above list (p. 2675) that have a canonical name that ends with 
akamaitechnologies.com , it appears that you cannot use either the canonical name or the IP address to 
access the web site. (I will leave it as an exercise for the student to investigate this further.) 

The end of the program 

The code in Listing 7 (p. 2677) takes care of the administrative details necessary to properly end the 

program. 


Listing 7 . End of the program. 


}catch(UnknownHostException e){ 
e.printStackTrace() ; 
}//end catch 


}//end main 
}//end class Java4630a 


Table 5.13 


47http://www.google.com 
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5.2.4.5 Run the program 


I encourage you to copy the code from Listing 8 (p. 2679) . Compile the code and execute it while you are 
connected to the Internet. Experiment with the code, making changes, and observing the results of your 
changes. Make certain that you can explain why your changes behave as they do. 


5.2.4.6 What’s next? 
The next module will deal with the URL class and the URLEncoder class. 


5.2.4.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4630: The InetAddress Class 
e File: Java4630.htm 

e Published: 03/02/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


Talso want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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5.2.4.8 Complete program listing 


Listing 8 . Complete program listing. 


/*File Java4630a.java Copyright 1998, R.G.Baldwin 
Revised 01/03/14 


This program exercises several of the methods of the 
InetAddress class. 
aKa K 3K 3k 3K 3K ak ak ak ak ək I 3K aK aK aK aK aK 3K 3K 3K 3K 3K K I I I I I II I I I 3K 3K 3K a a a K ÞK ÞK ÞK ÞK ÞK 34 34 34 // 


import java.net.*; 


public class Java4630a{ 
public static void main(String[] args){ 
try{ 

System.out.print1n( 

"Get and display InetAddress(es) of Google URL"); 
InetAddress[] addresses = 

InetAddress. getAl1ByName ("www.google.com"); 
for(int cnt=0; cnt<addresses.length;cnt++){ 
System. out.println(addresses[cnt]) ; 

}//end for loop 


System.out.println() ;//blank line 
System.out.println("Get and display current " + 
"TInetAddress of LocalHost") ; 
InetAddress address = InetAddress.getLocalHost () ; 
System.out.println(address) ; 


System.out.println();//blank line 
System.out.println("Extract and display current " + 

"name of LocalHost") ; 
System.out .println(address.getHostName()); 


System.out.println();//blank line 

System.out.println("Extract and display current " + 
"address of LocalHost"); 

System.out.println(address.getHostAddress()); 


System.out.println();//blank line 
System.out .print1n( 
"Display canonical host name for Google"); 
//Get InetAddress containing one of Google’s 
// IP addresses. 
address = InetAddress.getByName ("www.google.com"); 
System.out.println(address.getCanonicalHostName()) ; 
System.out .print1n( 
"Display Google name using reverse lookup."); 
String googleAddress = address. getHostAddress() ; 
System oit print in eine rhdar ees kel Name ( 
vailable for free gb Serapias SPERE SENS EY £01441 /1.181> 
System.out .println(InetAddress.getByName( 
googleAddress) .getCanonicalHostName()); 
}catch(UnknownHostException e){ 


a R i, E, t: IN 
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Table 5.14 


-end- 
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5.2.5 Java4630r-Review 
5.2.5.1 Table of Contents 


e Preface (p. 2681) 
e Questions (p. 2681) 


1 (p. 2681) , 2 (p. 2681) , 3 (p. 2681) , 4 (p. 2681) , 5 (p. 2682) , 6 (p. 2682) , 7 (p. 2682) 


e Answers (p. 2683) 
e Miscellaneous (p. 2684) 


5.2.5.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4630: The Inet Address 
Class 4° in the Network Programming sub-collection. 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


5.2.5.3 Questions 
5.2.5.3.1 Question 1 


True or False? 
The Java InetAddress class can be used to find the IP address corresponding toa domain name . 
Go to answer 1 (p. 2684) 


5.2.5.3.2 Question 2 


True or False? 

Many hosts have multiple IP addresses. To accommodate this, the InetAddress class provides a 
method named getByName that can be used to get an array of references to InetAddress objects 
representing IP addresses assigned to the host. 

Go to answer 2 (p. 2684) 


5.2.5.3.3 Question 3 


True or False? 

The getByName method of the Inet Address class returns a reference to an InetAddress object 
representing the host whose domain name is passed as a parameter to the method. 

Go to answer 3 (p. 2684) 


5.2.5.3.4 Question 4 


True or False? 

The getLocalHost method of the InetAddress class returns a reference to an array of Inet Address 
objects representing all of the computers on the local area network. 

Go to answer 4 (p. 2683) 


48This content is available online at <http://cnx.org/content /m49562/1.3/>. 
49http://cnx.org/content /m49534 /latest /?collection=col11441 /latest 
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5.2.5.3.5 Question 5 


True or False? 
There is a one-to-one correspondence between IP addresses and domain names. 
Go to answer 5 (p. 2683) 


5.2.5.3.6 Question 6 


True or False? 

Every computer on the Internet must have a unique IP address, but multiple computers can have (or 
can respond to) the same domain name. 

Go to answer 6 (p. 2683) 


5.2.5.3.7 Question 7 


True or False? 

The computer that you are using to read this module online also has an IP address and a name. The IP 
address, the name, and perhaps some other things as well are grouped together under something commonly 
referred to as localhost . In other words, the IP address of your localhost is the IP address of the computer 
that you are using to read this module. 

Go to answer 7 (p. 2683) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 

keep them from being visible on the screen at the same time. 


None 


Display your nami 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


5.2.5.4 Answers 
5.2.5.4.1 Answer 7 
True. 

Go back to Question 7 (p. 2682) 
5.2.5.4.2 Answer 6 
True. 

Go back to Question 6 (p. 2682) 
5.2.5.4.3 Answer 5 


False. There is not necessarily a one-to-one correspondence between IP addresses and domain names. In 
fact there can be a many-to-one correspondence between the two. 
Go back to Question 5 (p. 2682) 


5.2.5.4.4 Answer 4 


False. The getLocalHost method of the InetAddress class returns a reference to an InetAddress 
object representing the local host computer. 
Go back to Question 4 (p. 2681) 
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5.2.5.4.5 Answer 3 


True. 
Go back to Question 3 (p. 2681) 


5.2.5.4.6 Answer 2 


False. Many hosts have multiple IP addresses. To accommodate this, the InetAddress class provides a 
method named getAllByName that can be used to get an array of references to InetAddress objects 
representing all (or at least some) of the IP addresses assigned to the host. 

Go back to Question 2 (p. 2681) 


5.2.5.4.7 Answer 1 


True. 
Go back to Question 1 (p. 2681) 


5.2.5.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4630r-Review 
e File: Java4630r.htm 

e Published: 03/08/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


5.2.6 Java4640: The URL Class and the URLEncoder Class” 
5.2.6.1 Table of Contents 
e Preface (p. 2685) 


Viewing tip (p. 2685) 


50This content is available online at <http://cnx.org/content /m49535/1.2/>. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2679 


x Images (p. 2685) 
x Listings (p. 2685) 


e General background information (p. 2686) 
e Discussion and sample code (p. 2686) 


The program Java4640a (p. 2687) 
The program Java4640d (p. 2692) 


5.2.6.2 Preface 


Run the programs (p. 2695) 

What’s next? (p. 2695) 
Miscellaneous (p. 2695) 

Complete program listings (p. 2696) 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. More specifically, it is one in a sub-collection of modules 
designed for teaching network programming in that course. The purpose of this module is to introduce the 
student to the URL class and the URLEncoder class. 


5.2.6.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


5.2.6.2.1.1 Images 


Image 1 (p. 
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2686) . General syntax of a URL. 
2687) . Screen output from the program named Java4640a. 
2689) . Program output for string-parameter constructor. 
. 2690) . Building an absolute URL. 
2691) . An encoded string. 
2691) . Image 6: Encoding rules. 
) 


. Program output. 


5.2.6.2.1.2 Listings 


Listing 2 
Listing 3 


Listing 6 


Listing 1 (p. 
(p. 
(p. 
Listing 4 (p. 
Listing 5 (p. 

(p. 
Listing 7 (p. 
Listing 8 (p. 
Listing 9 (p. 


2688) . The method named display. 

2688) . Beginning of the program named Java4640a. 
2689) . Building an absolute URL. 

2691) . The URLEncoder.encode method. 

2693) . Beginning of the program named Java4640d. 
2694) . Open a connection to the URL. 

2694) . Read and display the data. 

2696) . The program named Java4640a. 

2697) . The program named Java4640d. 
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5.2.6.3 General background information 


What is a URL? 

URL is an acronym for Uniform Resource Locator. It is also the name of a class in Java, which is the 
primary topic for this module. 

A URL is a pointer to a particular resource at a particular location on the Internet. As you learned in 
an earlier module, a URL specifies the following 


protocol used to access the server (such as http), 

name of the server, 

port on the server (optional) 

path and name of a specific file on the server (sometimes optional) 
anchor or reference within the file (optional) 


Sometimes the name of the file can be omitted, in which case an HTTP server may append the file name 

index.html to the specified path and try to load that file. For example, we will write a simple HTTP 
server in a future module that will attempt to deliver a file named index.html if the name of the file is 
omitted from the URL. 

In addition to specifying the name of the file of interest, it is also sometimes possible to specify an anchor 
or reference that has been established inside the file. An example of how to take advantage of this capability 
was provided in an earlier module. 

General syntax of a URL 
The general syntax of a URL is shown in Image 1 (p. 2686) . 


Image 1 . General syntax of a URL. 


protocol: //hostname[: port] /path/filename#ref 


Table 5.15 


The port number is optional, and is not normally required if you are accessing a server that provides the 
required service on a standard port. 

Two ways to do network programming 

Java provides at least two different ways to do network programming. The two ways are associated with 
socket classes and URL classes. The socket classes will be the topic of future modules. This module is 
concerned primarily with the URL class. 

A higher level approach 

URL programming occurs at a higher level than socket programming, and in theory represents some 
very powerful ideas. The powerful ideas represented by the advanced features of the URL class require an 
understanding of the development of protocol handlers and content handlers. I discussed this in some detail 
in an earlier module titled Java4620: General Information , and won’t repeat that discussion here. 

A mundane alternative 

In addition to supporting the advanced concepts discussed in the earlier module, the URL class also 
provides a relatively mundane alternative way to connect one computer to another and transfer data on a 
stream basis. This module is primarily based on this capability. 


5.2.6.4 Discussion and sample code 


I will explain the programs named Java4640a and Java4640d in fragments. Complete listings of both 
programs are provided in Listing 8 (p. 2696) and Listing 9 (p. 2697) . 
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5.2.6.4.1 The program Java4640a 


This program exercises four of the constructors and six of the methods of the URL class. 
The program also illustrates the use of the URLEncoder class to convert a string containing spaces 
and other such characters into a UTF-8 encoded string format. 
Screen output from the program named Java4640a 
The output from the program is shown in Image 2 (p. 2687) . I will refer to portions of this output while 
discussing the program. 


Image 2 . Screen output from the program named Java4640a. 


Use simple string constructor for host URL 
http www.austincc.edu -1 null 
http: //www.austincc.edu 


Use simple string constructor for host plus file 
http www.austincc.edu -1 /baldwin null 
http://www.austincc.edu/baldwin 


Use strings for protocol, host, and file 
http www.austincc.edu -1 /baldwin null 
http://www.austincc.edu/baldwin 


Use strings for protocol host, and file 
and int for port 

http www.austincc.edu 80 /baldwin null 
http: //www.austincc.edu:80/baldwin 


Construct absolute URL from host URL and relative URL 
http www.austincc.edu -1 /baldwin/Index.html null 
http://www.austincc.edu/baldwin/Index. html 


Now use URLEncoder to create UTF-8 encoded String 
http://space .tilde~.plust+.com 
http4%3A/2F/2Fspacet+.tilde/7E.plus/2B.com 


Table 5.16 


The method named display 

The code in Listing 1 (p. 2688) is a method named display that I wrote to illustrate some of the 
methods of the URL class, and also to serve the practical needs of displaying information contained in a 
URL object. 
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Listing 1 . The method named display. 


void display(URL url){//method to display parts of URL 
System.out.print(url.getProtocol() +" "); 
System.out.print(url.getHost() + " "); 
System.out.print(url.getPort() + " "); 
System.out.print(url.getFile() + " "); 
System. out.println(url.getRef()); 


//Now display entire URL as a string. 
System. out.println(url.toString()); 
System. out.println() ; 

}//end display 


Table 5.17 


This method receives a reference to a URL object as a parameter and displays its component parts 
separated by space characters. Then it uses the overridden toString method of the URL class to display 
the contents of the URL object as a single String object. 

The parts of the URL 

As you can see from Listing 1 (p. 2688) , there is a method available for extracting each of the parts of 

a URL that were identified in the above list (p. 2686) . 
Beginning of the program named Java4640a 

Now that we know what the display method does, we can examine the code in the main method of 
the class. 

Listing 2 (p. 2688) shows the beginning of the program named Java4640a and the beginning of the 
main method. 


Listing 2 . Beginning of the program named Java4640a. 


import java.net.*; 
import java.io.*; 


class Java4640af{ 
public static void main(String[] args){ 
Java4640a obj = new Java4640a(); 
try{ 
System.out .printin( 
"Use simple string constructor for host URL"); 
obj .display(new URL("http://www.austincc.edu")) ; 


Table 5.18 
Listing 2 (p. 2688) illustrates the instantiation of a URL object using the version of the constructor 


that expects to receive the URL in string format. (I will ignore the exception handling code from these 
discussions for brevity.) 
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Listing 2 (p. 2688) begins by instantiating an object of the controlling class that can be used to access 
the display method. Then it instantiates a new URL object using the string-parameter version of the 
constructor and passes that object to the display method. 

As described above, the display method accesses each component part of the URL object and displays 
them separated by spaces. Then it displays the URL object using the overridden toString method. 

Program output for string-parameter constructor 
The code in Listing 2 (p. 2688) produced the output shown in Image 3 (p. 2689) . 


Image 3 . Program output for string-parameter constructor. 


Use simple string constructor for host URL 
http www.austincc.edu -1 null 
http://www.austincc.edu 


Table 5.19 


The -1 in Image 3 (p. 2689) indicates that there was no port specification, and the null indicates that 
there was no file name specification in the URL passed to the constructor for the URL object. 

The code fragment in Listing 2 (p. 2688) is followed by code that constructs the URL object using other 
overloaded versions of the constructor. Each overloaded version requires the URL information in different 
formats. You can view that code in Listing 8 (p. 2696) . 

Building an absolute URL 

I will to skip that code and move down to a more interesting case as shown by the fragment in Listing 3 

(p. 2689) . 


Listing 3 . Building an absolute URL. 


System.out.println("Construct absolute URL from " + 
"host URL and relative URL"); 
URL baseURL = new URL( 
“http: //www.austincc.edu/baldwin/hello.htm1") ; 
obj .display(new URL(baseURL, "/baldwin/Index.htm1")); 


Table 5.20 


Listing 3 (p. 2689) uses a URL constructor that requires two parameters: a URL object anda String 
object. Here is part of the somewhat cryptic description of this constructor from the Oracle documentation. 


"Creates a URL by parsing the given spec within a specified context. The new URL is created 
from the given context URL and the spec argument as described in RFC2396 "Uniform Resource 
Identifiers : Generic * Syntax" : " 


What does this mean? 

Let me try to explain this constructor in my own words (with some help from Elliotte Rusty Harold) . 
You can use this constructor to build an absolute URL from a relative URL . 

Assume, for example, that you have written your own method to display HTML files the way that they 
are displayed by a browser rather than simply as a text file. Such files often contain links to relative URL’s 
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. In such a case, the link would be provided simply as a path and file name under the assumption that the 
path and file name can be found relative to the base URL containing the HTML file. 
According to Java Network Programming by Elliotte Rusty Harold, 


"In this case, you use the URL to the document that contains the link to provide the missing 
information." 


The construction process 

The code in Listing 3 (p. 2689) constructs a base URL object pointing to 

"http: //www.austincc.edu /baldwin/hello.html" 

Then it uses the version of the constructor currently under discussion to combine that base URL object 
with a relative URL given by 

" /baldwin /Index.html" 

This produces the URL object displayed in Image 4 (p. 2690) . 


Image 4 . Building an absolute URL. 


Construct absolute URL from host URL and relative URL 
http www.austincc.edu -1 /baldwin/Index.html null 
http: //www.austincc.edu/baldwin/Index. html 


Table 5.21 


Hopefully this example illustrates how the constructor can combine a base URL object with a relative 
URL to produce a new URL object that is an absolute pointer to the relative URL. 

The URLEncoder class 

There is one more issue that we need to examine before leaving this program: the URLEncoder class. 
This class is provided to help deal with problems arising from spaces, special characters, non-alphanumeric 
characters, etc. , that some operating systems may allow in file names but which may not be allowed in a 
URL. 

If you need to create a URL object using a URL string that has these problems, you should first use the 
encode method of the URLEncoder class to convert it into an acceptable URL string. 

The URLEncoder.encode method 

This class provides a static method named encode that encodes a string representation of a URL into 
an acceptable format. 


(Technically I believe it is correct to say that the format produced in Listing 4 is "application /x- 
www-form-urlencoded" and the binary encoding is UTF-8.) 


The encode method returns a String object that is a cleaned-up version of the original string. 
Listing 4 (p. 2691) calls the encode method to encode a string that was purposely constructed to 
contain several unsafe characters. It displays both the raw string and the encoded string for comparison. 


Listing 4 . The URLEncoder.encode method. 


continued on next page 
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System.out.println("Now use URLEncoder to create " + 
"UTF-8 encoded String"); 
System.out.println("http://space .tilde~.plus+.com"); 
System.out.println(URLEncoder .encode( 
"http://space .tilde~.plus+.com","UTF-8")); 


Table 5.22 


The encoded output 
The output from the code in Listing 4 (p. 2691) is shown in Image 5 (p. 2691) . 


Image 5 . An encoded string. 


Now use URLEncoder to create UTF-8 encoded String 
http://space .tilde~.plus+.com 
httph34%2F%⁄2Fspace+.tilde%7E.plus%2B.com 


Table 5.23 


The encoded version doesn’t mean a lot to a human, but it is a format that is acceptable across a wide 
variety of computers. In case you are interested, the encoding rules are shown in Image 6 (p. 2691) . 

The ASCII characters ’a’ through ’z’, °A’ through ’Z’, and ’0’ through ’9’ remain the same. 

The space character ’’ is converted into a plus sign ’+’. 

All other characters are converted into the 3-character string "%xy", where xy is the two-digit hexadecimal 
representation of the lower 8-bits of the character. 


The ASCII characters ’a’ through ’z’, °A’ through ’Z’, and ’0’ through ’9’ remain the same. 

The space character ’ ’ is converted into a plus sign ’+’. 

All other characters are converted into the 3-character string "%xy", where xy is the two-digit hexadecimal 
representation of the lower 8-bits of the character. 


The ASCII characters ’a’ through ’z’, °A’ through ’2Z’, and ’0’ through ’9’ remain the same. 

The space character ’’ is converted into a plus sign ’+’. 

All other characters are converted into the 3-character string "%xy", where xy is the two-digit hexadecimal 
representation of the lower 8-bits of the character. 


Image 6 . Encoding rules. 


To convert a String, each character is examined in turn: The ASCII characters ’a’ through ’z’, ’A’ through ’Z’, and ’0’ thr 


Table 5.24 


Elliotte Rusty Harold provides a URLDecoder class in his Java Network Programming book that 
takes a URL string in the format shown above and converts it back to its String representation. 
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5.2.6.4.2 The program Java4640d 


Now it is time to put some of what you have learned to work with a program named Java4640d . Once 
again, I will explain this program in fragments. A complete listing is provided in Listing 9 (p. 2697) . 

This program illustrates using a URL object to connect to a URL and to read a file from that URL as 
an input stream. As we will see later, we can and will do the same thing using sockets in future modules. 

Your computer must be online for this program to run properly. Otherwise, it will throw an exception 
of type UnknownHostException 

Program output 

The output from the program is a display of the contents of the file named pagel.html in a raw text 
format. Thus, all of the HTML tags are visible. 


(Of course, you can modify the program to download and display a different file on the same or 
a different website. ) 


As of January 2014, the output for the beginning of the file was as shown in Image 7 (p. 2693). (The file 
is much longer than that shown.) 


(I may modify the contents of this file from time to time, so if you compile and run this program 
later, you may get different results. ) 


Image 7 . Program output. 


<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> 

<html> 

<head> 

<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> 
<meta name="GENERATOR" content="Mozilla/4.7 [en] (WinNT; I) [Netscape]"> 
<title>Java and JavaScript Programming, by Richard G Baldwin</title> 
</head> 

<body bgcolor="#FFFFFF" link="#0000FF" vlink="#FFO000" lang="EN-US"> 


<hi> 

Baldwin’s Test Page 1</h1> 

Click <a href="http://www2.austin.cc.tx.us/baldwin/page2.html">here</a> 
to view page 2 

<p>Note: The material on this page is not intended to be of any particular 


value. This file is posted for the purpose of testing HTTP network 

programs only. 

<p>The following red bar is a centered gif file. 

<center> 

<p><img SRC="red_thick_line_1.gif" BORDER=0 id="_x0000_11025" height=9 width=300 
></center> 


<center> 
<h2> 
The following is a centered two-column table</h2></center> 


Table 5.25 
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The beginning of the program 
The program begins in Listing 5 (p. 2693) . 


Listing 5 . Beginning of the program named Java4640d. 


import java.net.*; 
import java.io.*; 


class Java4640d{ 
public static void main(String[] args){ 
String dataLine; 
try{ 
//Get a URL object 
URL url = new URL( 
“http: //www.austincc.edu/baldwin/pagel.htm1") ; 


Table 5.26 


As before, I will ignore the exception-handling code while discussing this program. 
Create a URL object 

As you saw in the previous program, the URL class has several different constructors, each of which can 
create a new URL object on the basis of URL information provided as parameters to the constructor. The 
constructors differ in terms of how the URL information is provided. 

Listing 5 (p. 2693) creates a URL object that points to the file named pagel.html in the directory 
named baldwin on the server at Austin Community College where I teach. 

No port was specified 

The URL object will not contain a port specification because I didn’t provide a port number. Later when 
we use one of the methods of the URL class along with this URL object to make a connection to the server, 
the connection will, by default, be made to port 80 which is the standard port for servers that support the 
HTTP protocol. 

In other words, when the port is not provided (the URL object contains a port number of -1) , the 
connection method of the URL class will use the protocol portion of the URL to decide which port to connect 
to. 

Open a connection to the URL 

Once you have a URL object, there are a number of things that you can do with it. One of the things 
you can do with it is to open input and output streams that will be connected to the server software that 
is monitoring the port of interest. 

The code in Listing 6 (p. 2694) opens a connection to the URL described by this URL object and returns 
an input stream object for reading data from the connection. This is the point where the port number 
defaults on the basis of the protocol specification in the URL object. 


Listing 6 . Open a connection to the URL. 


BufferedReader htmlPage = 
new BufferedReader(new InputStreamReader ( 
url.openStream())); 
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Table 5.27 


Be aware that only a small portion of the statement in Listing 6 (p. 2694) has to do with URL processing. 
The remainder of the statement has to do with the more complex topic of I/O stream processing. 
Read and display the data 
The remaining code in this program, as shown in Listing 7 (p. 2694) , is completely straightforward. 
Data is read from the stream one line at a time and displayed as it is read. The readLine method returns 
null when there is no more data to be read from the stream and the program terminates. 


Listing 7 . Read and display the data. 


while((dataLine = htmlPage.readLine()) != null){ 
System. out.println(dataLine) ; 
}//end while loop 


Table 5.28 


Not complicated at all 

As you can see, it is very easy to write a program that will connect to an HTTP server and download the 
contents of a specified file. There are lots of things that you do by using this as a starting point. A common 
assignments given to students is to add a little more knowledge and code to this and to write a crawler that 
will crawl the web searching for some specified file contents. 


5.2.6.5 Run the programs 


I encourage you to copy the code from Listing 8 (p. 2696) and Listing 9 (p. 2697) .Compile the code and 
execute it. Experiment with the code, making changes, and observing the results of your changes. Make 
certain that you can explain why your changes behave as they do. 


5.2.6.6 What’s next? 


The next module in the series will deal with the URLConnection class. 


5.2.6.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4640: The URL Class and the URLEncoder Class 
e File: Java4640.htm 

e Published: 03/02/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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5.2.6.8 Complete program listings 


Listing 8 . The program named Java4640a. 


/*File Java4640a. java Copyright 1998, R.G.Baldwin Revised 01/05/14 


This program exercises four of the constructors and 
six of the methods of the URL class. 


The program also illustrates the use of the URLEncoder 
class to convert a string containing spaces and other 

such characters into UTF-8 format. 

3K aK 3k 3k 3K 3K 3K ak ak ak ak ək aK aK aK aK 3K 3K 3K 3K 3K ak ək ak ak ak 3K 3K 3K II I I I I I II I I I I 3K 3K K a a ÞK ÞK ÞK ÞK ÞK ÞK 34 34 34 / 


import java.net.*; 
import java.io.*; 


class Java4640a{ 
public static void main(String[] args){ 
Java4640a obj = new Java4640a(); 
try{ 
System.out.println( 
"Use simple string constructor for host URL"); 
obj .display(new URL("http://www.austincc.edu")); 


System.out.println("Use simple string constructor " + 
"for host plus file"); 

obj .display(new URL( 
"http: //www.austincc.edu/baldwin")) ; 


System.out .print1n( 
"Use strings for protocol, host, and file"); 

obj .display(new URL( 
"http", "www.austincc.edu","/baldwin")) ; 


System.out.println("Use strings for protocol " + 
"host, and file\n and int for port"); 
obj .display(new URL( 
"http", "www.austincc.edu",80,"/baldwin") ); 


System.out.println("Construct absolute URL from " + 
"host URL and relative URL"); 
URL baseURL = new URL( 
“http: //www.austincc.edu/baldwin/hello.html1") ; 
obj .display(new URL(baseURL, "/baldwin/Index.html")) ; 


System.out.println("Now use URLEncoder to create " + 
"UTF-8 encoded String"); 
System.out.println("http://space .tilde~.plus+.com"); 
System. out .println(URLEncoder .encode( 
„Aigbe lop Seg at Copgexionsy eto ig apr gipon coll 1441 /1.181> 
}catch(MalformedURLException | 

UnsupportedEncodingException e){ 

e.printStackTrace() ; 
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Table 5.29 


Listing 9 . The program named Java4640d. 


/*File Java4640d.java Copyright 1998, R.G.Baldwin Revised 01/06/14 


Illustrates connecting to a URL and reading a file from 
that URL as an input stream. 


Computer must be online for this program to run properly. 
Otherwise, it will throw an exception of type 
UnknownHostException. 

aKa K 3k 3K 3K 3k ak ak ak II 3K ak aK aK ak ak 3K 3K 3K I I I I II I I I I 3K 3K 3K K a K K ÞK ÞK ÞK ÞK ÞK 34 34 34 / 


import java.net.*; 
import java.io.*; 


class Java4640d{ 
public static void main(String[] args){ 
String dataLine; 
try{ 
//Get a URL object 
URL url = new URL( 
“http: //www.austincc.edu/baldwin/pagel.htm1") ; 


//Open a connection to this URL and return an 
// input stream for reading from the connection. 
BufferedReader htmlPage = 
new BufferedReader(new InputStreamReader ( 
url.openStream())); 


//Read and display file one line at a time. 
while((dataLine = htmlPage.readLine()) != null){ 
System. out.println(dataLine) ; 
}//end while loop 
}//end try 
catch(Exception e){ 
e.printStackTrace() ; 
}//end catch 


}//end main 
}//end class Java4640d 


Table 5.30 


-end- 
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5.2.7 Java4640r-Review 
5.2.7.1 Table of Contents 


e Preface (p. 2698) 
e Questions (p. 2698) 


1 (p. 2698) , 2 (p. 2698) , 3 (p. 2698) , 4 (p. 2699) , 5 (p. 2699) 


e Answers (p. 2700) 
e Miscellaneous (p. 2701) 


5.2.7.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4640: The URL Class 
and the URLEncoder Class 5? in the Network Programming sub-collection. 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


5.2.7.3 Questions 
5.2.7.3.1 Question 1 


True or False? 

Java provides at least two different ways to do network programming. The two ways are associated with 
socket classes and URL classes. 

Go to answer 1 (p. 2700) 


5.2.7.3.2 Question 2 


True or False? 
Socket programming occurs at a higher level than URL programming 
Go to answer 2 (p. 2700) 


5.2.7.3.3 Question 3 


True or False? 
An object of the URL class provides a method for extracting each of the following parts of a URL: 


protocol used to access the server (such as http), 

name of the server, 

port on the server (optional) 

path and name of a specific file on the server (sometimes optional) 
anchor or reference within the file (optional) 


Go to answer 3 (p. 2700) 


51This content is available online at <http://cnx.org/content /m49558/1.3/>. 
°2http://cnx.org/content /m49535 /latest /?collection=col11441/latest 
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5.2.7.3.4 Question 4 


True or False? 

The URLEncoder class is provided to help deal with problems arising from spaces, special characters, 
non-alphanumeric characters, etc. , that some operating systems may allow in file names but which may 
not be allowed in a URL. 

Go to answer 4 (p. 2700) 


5.2.7.3.5 Question 5 


True or False? 

Once you have a URL object connected to a server, you can open input and output streams that will 
be connected to the server software that is monitoring the port of interest. 

Go to answer 5 (p. 2700) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None KEX] 


Display your nami 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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5.2.7.4 Answers 
5.2.7.4.1 Answer 5 
True. 
Go back to Question 5 (p. 2699) 
5.2.7.4.2 Answer 4 
True. 
Go back to Question 4 (p. 2699) 
5.2.7.4.3 Answer 3 
True. 
Go back to Question 3 (p. 2698) 
5.2.7.4.4 Answer 2 
False. URL programming occurs at a higher level than socket programming. 
Go back to Question 2 (p. 2698) 
5.2.7.4.5 Answer 1 


True. 
Go back to Question 1 (p. 2698) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


5.2.7.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4640r-Review 
e File: Java4640r.htm 

e Published: 03/08/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. More specifically, it is one in a sub-collection of modules 
designed for teaching network programming in that course. The purpose of this module is to introduce the 
student to the URLConnection class. 


°3This content is available online at <http://cnx.org/content /m49537/1.2/>. 
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5.2.8.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


5.2.8.2.1.1 Images 


e Image 1 (p. 2703) . Partial program output. 


5.2.8.2.1.2 Listings 


e Listing 1 (p. 2704) . Beginning of the program. 

e Listing 2 (p. 2704) . Get a URLConnection object. 

e Listing 3 (p. 2704) . Get information about the URL. 
e Listing 4 (p. 2706) . The program named Java4650a. 


5.2.8.3 General background information 


I don’t plan to say very much about the URLConnection class. It is an abstract class that can be 
extended , and it has a protected constructor that takes a URL object as a parameter. 

It has variables or fields that contain useful information about a connection. 

It has many methods that can be used to examine and manipulate an object of the class in a variety of 
different ways. 

If you plan to use the URL class for the higher-lever capabilities that it offers, and you plan to write 
content handlers and protocol handlers , you will probably need to become very familiar with this class. 
In that case, you will probably want to get a copy of a good Java networking book, such as Java Network 
Programming , by Elliotte Rusty Howard, and study the use of this class in depth. 

My objective here is simply to make you aware of the existence of the class and its many methods, and to 
provide some examples of how you can get and use an object of the class to obtain higher-level information 
about a connection. 


5.2.8.4 Discussion and sample code 


This program illustrates connecting to a URL and creating a URLConnection object. 
The program uses the URLConnection object to obtain and display some of the "higher level" 
information about the UR L: 


e the URL 
e the date last modified 
e the content type 


The computer must be online for this program to run properly. Otherwise, it will throw an exception of type 
UnknownHostException 

Partial program output 

Image 1 (p. 2703) shows part of the output from the program. The first three lines of output correspond 
to the items in the above list (p. 2702) , and are the items that we will be primarily interested in for this 
module. 
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Image 1 . Partial program output. 


http: //www.austincc.edu/baldwin/page1 . html 

Tue Apr 17 23:16:17 CDT 2001 

text/html; charset=iso-8859-1 

<!doctype html public "-//w3c//dtd html 4.0 transitional//en"> 

<html> 

<head> 

<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> 
<meta name="GENERATOR" content="Mozilla/4.7 [en] (WinNT; I) [Netscape]"> 
<title>Java and JavaScript Programming, by Richard G Baldwin</title> 
</head> 

<body bgcolor="#FFFFFF" link="#0000FF" vlink="#FFO000" lang="EN-US"> 


<hi> 

Baldwin’s Test Page 1</h1i> 

Click <a href="http://www2.austin.cc.tx.us/baldwin/page2.html">here</a> 
to view page 2 

<p>Note: The material on this page is not intended to be of any particular 


value. This file is posted for the purpose of testing HTTP network 

programs only. 

<p>The following red bar is a centered gif file. 

<center> 

<p><img SRC="red_thick_line_1.gif" BORDER=0 id="_x0000_11025" height=9 width=300 
></center> 


Table 5.31 


The program named Java4650a 

I will explain this program in fragments. A complete listing of the program is provided in Listing 4 (p. 
2706) . 

The URLConnection class is abstract , and therefore cannot be instantiated directly. However, it 
can be extended , and it has a protected constructor that requires a URL object as a parameter. 

A common way to get a URLConnection object is to call a method on a URL object that returns 
an object of a subclass of the URLConnection class. That is the case in the sample program for this 
module. 

I will ignore the exception handling code in the discussion of this program. 

All of the code in the sample program is contained in the main method of the controlling class. 

Beginning of the program 

The beginning of the program and the beginning of the main method is shown in Listing 1 (p. 2704) . 


Listing 1 . Beginning of the program. 


continued on next page 
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import java.net.*; 
import java.io.*; 
import java.util.*; 


class Java4650a{ 
public static void main(String[] args){ 
String dataLine; 
try{ 
//Get a URL object 
URL url = new URL( 
“http: //www.austincc.edu/baldwin/pagel.htm1") ; 


Table 5.32 


Get a URL object 

The code at the bottom of Listing 1 (p. 2704) instantiates a URL object. This is essentially the same 
code that you saw in an earlier module, but you need to see it again here in order to understand the code 
that follows it. 

URLConnection object 

The code in Listing 2 (p. 2704) gets a URLConnection object by calling the openConnection 
method on the URL object instantiated earlier. 


Listing 2 . Get a URLConnection object. 


URLConnection urlConnection = url.openConnection() ; 


Table 5.33 


Get information about the URL 
The code in Listing 3 (p. 2704) calls three methods on the URLConnection object to obtain three of 
the higher-level informational aspects of the URL: 


e the URL 
e the date that the file was last modified 
e the content type of the file 


Listing 3 . Get information about the URL. 


System.out .println(urlConnection.getURL()); 
Date lastModified = new Date( 

urlConnection. getLastModified()) ; 
System.out .println(lastModified) ; 
System.out.println(urlConnection. getContentType()) ; 
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Table 5.34 


The result of these three inquiries is shown as the first three lines of text in Image 1 (p. 2703) . 

The remaining code 

Following this, the program uses the URL object to get an input stream and to display the contents of 
the file. However, this essentially duplicates a portion of the program in an earlier module, so I won’t discuss 
it further here. 


5.2.8.5 Run the program 


I encourage you to copy the code from Listing 4 (p. 2706) . Compile the code and execute it. Experiment 
with the code, making changes, and observing the results of your changes. Make certain that you can explain 
why your changes behave as they do. 


5.2.8.6 What’s next? 


In the next module, I will show you how to download a simple HTML file and to render it in a way that is 
similar to how it would be rendered in a browser. 


5.2.8.7 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4650: The URLConnection Class 
e File: Java4650.htm 

e Published: 03/02/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


5.2.8.8 Complete program listing 
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Listing 4 . The program named Java4650a. 


/*File Java4650a.java Copyright 1998, R.G.Baldwin 
Revised 01/05/14 


Illustrates connecting to a URL and creating a 
URLConnection object. 


Uses the URL object to obtain and display 
the URL, the date last modified, and the content type. 


Also uses the URLConnection object to obtain an 

input stream object. Then uses this object to read and 
display the file. 

BE AAG EEE EEEE EEEE E EEEE EE AI I I I E EEEE 21 21 21 1 4 21 2k 2k a 4 2k E ak af kak // 


import java.net.*; 
import java.io.*; 
import java.util.*; 


class Java4650a{ 
public static void main(String[] args){ 
String dataLine; 
try{ 
//Get a URL object 
URL url = new URL( 
“http: //www.austincc.edu/baldwin/pagel.htm1") ; 


//Open a connection to the URL and get a 
// URLConnection object. 
URLConnection urlConnection = url.openConnection() ; 


//Use the connection to get and display the URL 
System.out.println(urlConnection.getURL()); 


//Use the connection to get and display the date last 
// modified. 
Date lastModified = new Date( 

urlConnection. getLastModified()); 
System.out.println(lastModified) ; 


//Use the connection to get and display the content 
// type. 
System.out.println(urlConnection. getContentType()) ; 


//Use the connection to get an InputStream object. 
// Use the InputStream object to instantiate a 
// DataInputStream object. 
BufferedReader htmlPage = 
new BufferedReader(new InputStreamReader ( 
url.openStream())); 
Available for free at Connexions <http://cnx.org/content/col11441/1.181> 
//Use the DataInputStream object to read and display 
// the file one line at a time. 
while((dataLine = htmlPage.readLine()) != null){ 
System. out.println(dataLine);: 
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Table 5.35 


-end- 
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5.2.9 Java4650r-Review™ 
5.2.9.1 Table of Contents 


e Preface (p. 2708) 
e Questions (p. 2708) 


1 (p. 2708) , 2 (p. 2708) , 3 (p. 2708) , 4 (p. 2708) , 5 (p. 2709) 


e Answers (p. 2710) 
e Miscellaneous (p. 2711) 


5.2.9.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4650: The URLCon- 
nection Class 55 in the Network Programming sub-collection. 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


5.2.9.3 Questions 
5.2.9.3.1 Question 1 


True or False? 

The URLConnection class is an abstract class that can be extended . It has a protected 
constructor that takes a URL object as a parameter. 

Go to answer 1 (p. 2711) 


5.2.9.3.2 Question 2 


True or False? 
The URLConnection class can be instantiated directly. 
Go to answer 2 (p. 2710) 


5.2.9.3.3 Question 3 


True or False? 

A common way to get a URLConnection object is to call a method ona URL object that returns 
an object of a subclass of the URLConnection class. 

Go to answer 3 (p. 2710) 


5.2.9.3.4 Question 4 


True or False? 

The method named openConnection can be called ona URL object to get a reference to an object 
of a class that is a subclass of the URLConnection class. 

Go to answer 4 (p. 2710) 


54This content is available online at <http://cnx.org/content/m49573/1.3/>. 
55http://cnx.org/content /m49537 /latest /?collection=col1 1441 /latest 
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5.2.9.3.5 Question 5 


True or False? 
Three methods can be called on a URLConnection object to obtain the following three informational 
aspects of the URL: 


e the URL 
e the date that the file was last modified 
e the content type of the file 


Go to answer 5 (p. 2710) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None 


Display yournam 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 


Put your name here 


5.2.9.4 Answers 
5.2.9.4.1 Answer 5 
True. 

Go back to Question 5 (p. 2709) 
5.2.9.4.2 Answer 4 
True. 

Go back to Question 4 (p. 2708) 
5.2.9.4.3 Answer 3 
True. 

Go back to Question 3 (p. 2708) 
5.2.9.4.4 Answer 2 


False. The URLConnection class is abstract , and therefore cannot be instantiated directly. However, 
it can be extended , and it has a protected constructor that requires a URL object as a parameter. 
Go back to Question 2 (p. 2708) 
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5.2.9.4.5 Answer 1 


True. 
Go back to Question 1 (p. 2708) 


5.2.9.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4650r-Review 
e File: Java4650r.htm 

e Published: 03/08/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


5.2.10 Java4655: A Rendering Web Browser” 
5.2.10.1 Table of Contents 


Preface (p. 2712) 
Viewing tip (p. 2712) 


x Images (p. 2712) 
x Listings (p. 2712) 


Discussion and sample code (p. 2712) 


A skeleton program - Java4655c (p. 2712) 
The program named Java4655b (p. 2722) 
The program named Java4655a (p. 2728) 
What’s missing? (p. 2733) 


Run the program (p. 2734) 

What’s next? (p. 2734) 
Miscellaneous (p. 2734) 

Complete program listing (p. 2735) 


56 This content is available online at <http://cnx.org/content /m49542/1.2/>. 
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5.2.10.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. More specifically, it is one in a sub-collection of modules 
designed for teaching network programming in that course. The purpose of this module is to show students 
how to use Java Swing to render a web page in a JFrame object. 


5.2.10.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


5.2.10.2.1.1 Images 


e Image 1 (p. 2720) . JFrame output from the program named Java4655c. 
e Image 2 (p. 2722) . Command line output from the program named Java4655c. 
e Image 3 (p. 2728) . JFrame output from the program named Java4655b. 
e Image 4 (p. 2733) . JFrame output from the program named Java4655a. 


5.2.10.2.1.2 Listings 


Listing 7 (p. 2716 
Listing 8 (p. 2723 
Listing 9 


. The hyperlinkUpdate method. 
. The constructor for the Java4655bHtmlHandler class. 
The HyperlinkEvent handler for Java4655b. 

Scrolling code in Java4655a. 

The program named Java4655c. 

The program named Java4655b. 

The program named Java4655a. 


Listing 1 (p. 2713) . Beginning of the program named Java4655c. 
Listing 2 (p. 2713) . The method named runner. 
Listing 3 (p. 2714) . Beginning of the class named Java4655cHtmlHandler. 
Listing 4 (p. 2715) . Open the URL object in a JEditorPane object. 
Listing 5 (p. 2715) . Register a hyperlink listener. 
Listing 6 (p. 2716) . Display the JEditorPane. 

( ) 

( ) 

( ) 


p 
Listing 10 (p. 2729 
Listing 11 (p. 2735 
Listing 12 (p. 2737 
Listing 13 (p. 2739 


ye 
ya 
y 
Je 


5.2.10.3 Discussion and sample code 


In an earlier module, you learned how to connect to a website and cause a raw text version of a file to be 
downloaded and displayed. However, the display of raw HTML text isn’t very useful, which is why rendering 
web browsers were invented. 

In this module, you will learn how to connect to a website and cause an HTML file to be downloaded 
and rendered ina JFrame object. We will develop a program that makes it possible to follow hyperlinks 
much as you would expect with a commercial web browser. 


5.2.10.3.1 A skeleton program - Java4655c 


I will begin this explanation with a skeleton program that illustrates four important aspects of rendering a 
webpage ina Swing JFrame object 


e Getting a URL object that is connected to a webpage. 
e Opening the URL object ina JEditorPane object. 
e Displaying the JEditorPane in a rendered format. 
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e Handling hyperlink events on the JEditorPane 


(Note that there are alternatives to the first two items in the above list, which we will see later.) 
To keep the code simple, two important aspects of webpage rendering will be omitted from this program: 


e Scrolling large web pages. 
e Following hyperlinks. 


These capabilities will be added to other programs later in this module. 

Beginning of the program named Java4655c 

I will explain this program in fragments. A complete listing of the program is provided in Listing 11 (p. 
2735) . 

Listing 1 (p. 2713) shows the beginning of the program. 


Listing 1 . Beginning of the program named Java4655c. 


import javax.swing.*; 
import javax.swing.event.*; 
import javax.swing.text.html.*; 
import java.net.*; 
import java.awt.*; 


class Java4655c{ 


public static void main(String[] args){ 
new Java4655c() .runner ( 
“http: //www.austincc.edu/baldwin") ; 
}//end main 


Table 5.36 


There is nothing new in Listing 1 (p. 2713) . This code simply calls a method named runner passing a 
string description of a URL as a parameter. 

The method named runner 

The method named runner is shown in Listing 2 (p. 2713) . 


Listing 2 . The method named runner. 


void runner(String webSiteLink) { 

try{ 
//Create a new URL object from the website string 
URL website = new URL(webSiteLink) ; 
//Instantiate an overall web page handler 
new Java4655cHtmlHandler (website) ; 

}catch(Exception e){ 
e.printStackTrace() ; 

}//end catch 

}//end runner 
}//end class Java4655c 
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Table 5.37 


Listing 2 (p. 2713) begins by getting a URL object that is connected to the specified webpage to satisfy 
the first item in the above list (p. 2712) . 

Then Listing 2 (p. 2713) instantiates a new object of the class named Java4655cHtmlHandler passing 
the URL object’s reference as a parameter to the constructor. From this point forward, the behavior of the 
program will be controlled by the object of the Java4655cHtmlHandler class. 

Listing 2 (p. 2713) also signals the end of the class named Java4655c 

Beginning of the class named Java4655cHtmlHandler 

The beginning of the class named Java4655cHtmlHandler and the beginning of the constructor for 

that class is shown in Listing 3 (p. 2714) 


Listing 3 . Beginning of the class named Java4655cHtmlHandler. 


class Java4655cHtmlHandler extends JFrame 
implements HyperlinkListener{ 
//Constructor 
public Java4655cHtmlHandler(URL website) { 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setTitle("Copyright 2014, R.G.Baldwin") ; 


Table 5.38 


There is nothing new or unusual in Listing 3 (p. 2714) with the possible exception of the fact that the 
class implements the interface named HyperlinkListener . This has two important ramifications: 


e The class must provide concrete implementations of all the methods declared in the interface. 
e An object of the class can serve as a listener for events of type HyperlinkEvent 


As you will see later, the HyperlinkListener interface declares only one method and it is named 
hyperlinkUpdate . The method receives one incoming parameter of type HyperlinkEvent 

The hyperlinkUpdate method 

The documentation for the hyperlinkUpdate method is rather sparse, stating only that the method 
is "Called when a hypertext link is updated" and that the incoming parameter represents "the event 
responsible for the update." 

As you will see later, an event occurs whenever the user touches a hyperlink in the webpage with the 
mouse. The HyperlinkEvent object encapsulates information identifying the event as being one of the 
following types: 


e ENTERED 
e EXITED 
e ACTIVATED 


I will pursue the three types of hyperlink events in more detail later. 

Open the URL object in a JEditorPane object 

Listing 4 (p. 2715) opens the URL object in a JEditorPane object to satisfy the second item in the 
above list (p. 2712) . 


(I will ignore the exception handling code while explaining this program.) 
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Listing 4 . Open the URL object in a JEditorPane object. 


try{ 

if(website != null) { 
//Create a JEditorPane containing the web page. 
JEditorPane html = new JEditorPane(website) ; 
html.setEditable(false) ; 


Table 5.39 


Fortunately, the online documentation 5” for the JEditorPane is fairly detailed. I will refer you to 
that documentation for more information. 

The JEditorPane constructor 

Listing 4 (p. 2715) calls an overloaded JEditorPane constructor that is described in the documentation 
as follows: 


"Creates a JEditorPane based on a specified URL for input." 


( Note that there is another constructor that would allow us to create the JEditorPane object 
passing a URL string to the constructor. Had I used that constructor, it wouldn’t have been necessary to 
create the URL object. For illustration, I will use that constructor in a later program in this module.) 

Documentation snippets 
There are a couple of snippets from that documentation that are particularly important to this module. 
The first snippet is: 


"Some kinds of content may provide hyperlink support by generating hyperlink events. The 
HTML EditorKit will generate hyperlink events if the JEditorPane is not editable (JEditor- 
Pane.setEditable(false); has been called)." 


Since we are definitely interested in hyperlink events, Listing 4 (p. 2715) calls the setEditable method 
on the new JEditorPane object passing false as a parameter. 
A second snippet that will be important later in this module reads: 


"The setPage method can be used to initialize the component from a URL." 


We will use this capability later to cause a hyperlink event handler to follow a link in a webpage when we 
click on the hyperlink. 

Register a hyperlink listener 

Listing 5 (p. 2715) uses standard Java event handling code to register a hyperlink listener object on the 
JEditorPane object. As I mentioned earlier, this object is suitable for use as a listener object. 


Listing 5 . Register a hyperlink listener. 


html .addHyperlinkListener (this); 


Table 5.40 


57http://docs.oracle.com/javase/7/docs/api/javax/swing/JEditorPane.html 
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I will explain the hyperlink listener code shortly. 

Display the JEditorPane 

Listing 6 (p. 2716) uses standard Swing code to display the JEditorPane ina JFrame object. 
There is nothing new or interesting about this code so I won’t discuss it further. 


Listing 6 . Display the JEditorPane. 


this. getContentPane() .add(htm1) ; 
this.setSize(669, 669); 
this.setVisible(true) ; 
}//end if 


}catch(Exception e){ 
e.printStackTrace(); 
}//end catch 
}//end constructor 


Table 5.41 
Listing 6 (p. 2716) also signals the end of the constructor for the class named Java4655cHtmlHandler 


The event handler method 
Listing 7 (p. 2716) shows the event handler method named hyperlinkUpdate in its entirety. 


Listing 7 . The hyperlinkUpdate method. 


public void hyperlinkUpdate(HyperlinkEvent e) { 
if (e.getEventType() == 
HyperlinkEvent .EventType.ENTERED) { 
System.out.println("ENTERED") ; 
}else if (e.getEventType() == 
HyperlinkEvent .EventType. EXITED) { 
System.out.println("EXITED") ; 
}else if (e.getEventType() == 
HyperlinkEvent .EventType. ACTIVATED) { 
System.out.println("ACTIVATED") ; 
}//end if 


}//end hyperlinkUpdate method 


}//end class Java4655cHtmlHandler 


Table 5.42 


This hyperlink event handler simply displays the type of event on the command-line screen as the mouse 


pointer touches hyperlinks on the webpage. The possible types of events and the actions that cause them 
are as follows: 
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e ENTERED - touch a hyperlink with the mouse 
e EXITED - move the mouse pointer away from a touched hyperlink 
e ACTIVATED - click a hyperlink with the mouse 


The code in Listing 7 (p. 2716) is straightforward and shouldn’t require further explanation. 

Listing 7 (p. 2716) also signals the end of the class named Java4655cHtmlHandler . 

The program output 

Image 1 (p. 2720) shows the output that you should see if you compile and run this program. Note 
however that the content of this page changes each semester so you may see something a little different. 


EA copyright 2014, R.G.Baldwin iol x 


Baldwin's Austin Community College Course Link Page 


Miscellaneous Links 


ə Baldwin's e-book titled Object-Oriented Programming (OOP) with Java. 
ə Baldwin's e-book titled Mathematical Applications for Game Development. 
ə Baldwin's e-book titled Anatomy of a Game Engine. 


ə Baldwin's Programming Oldies but Goodies. 

ə Baldwin's Supplemental Online Instructional Materials. 
a Baldwin's Programming with XNA Game Studio. 

ə Blackboard login page. 


All students enrolled in courses taught by Prof. Baldwin are required to complete 
online orientation at the beginning of the course. Follow the link to the Main page for 
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Image 1 . JFrame output from the program named Java4655c. 
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As I mentioned earlier, this program doesn’t allow scrolling for web pages that are too large to fit in the 
JEditorPane . As you can see in Image 1 (p. 2720) , the webpage simply spills outside the viewing area. 
We will deal with that later in this module. 

This program also doesn’t support link following. If you touch or click a link, the code in Listing 7 (p. 
2716) simply reports that fact on the command line screen. We will also deal with that later in this module. 

Image 2 (p. 2722) shows the result of moving the mouse around inside the hyperlinks in Image 1 (p. 
2720) and finally clicking on one of those links to create an ACTIVATED event. 
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Table 5.44 


Now that you know the basics, we can put some meat on the skeleton. 


5.2.10.3.2 The program named Java4655b 


This program is similar to the previous program except that it allows you to follow hyperlinks. However, I 
will continue to defer scrolling until later in the module. 

Once again, I will explain this program in fragments. However, rather than to explain the complete 
program, I will explain only those things that are significantly different from the previous program. 
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A complete listing of the program is provided in Listing 12 (p. 2737) . 

The constructor for the Java4655bHtmlHandler class 

Listing 8 (p. 2723) shows the beginning of the Java4655bHtmlHandler class including the entire 
constructor. 


Listing 8 . The constructor for the Java4655bHtmlHandler class. 


class Java4655bHtmlHandler extends JFrame 
implements HyperlinkListener{ 
JEditorPane html; 


//Constructor 

public Java4655bHtmlHandler (String websiteString) { 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setTitle("Copyright 2014, R.G.Baldwin") ; 


try{ 
if(websiteString != null) { 
html = new JEditorPane(websiteString) ; 
html.setEditable(false); 
html .addHyperlinkListener (this); 


this. getContentPane() .add(html, BorderLayout .CENTER) ; 
this.setSize (669,669) ; 
this.setVisible(true) ; 

}//end if 


}catch(Exception e){ 
e.printStackTrace() ; 
}//end catch 
}//end constructor 
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Differences from the previous program 

One difference between the code in Listing 8 (p. 2723) and the corresponding code in the previous 
program is that this version requires the website to be specified as a String instead of a URL (p. 2715) . 

Another difference is that this version declares the JEditorPane reference as an instance variable to 
make it accessible to the HyperlinkEvent handler discussed below. 

The HyperlinkEvent handler 

Listing 9 (p. 2724) shows the HyperlinkEvent handler in its entirety. 


Listing 9 . The HyperlinkEvent handler for Java4655b. 


continued on next page 
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public void hyperlinkUpdate(HyperlinkEvent e) { 
if (e.getEventType() == 
HyperlinkEvent.EventType. ACTIVATED) { 
//TIgnore ENTERED and EXITED events and process only 
// ACTIVATED events. 
if (e instanceof HTMLFrameHyperlinkEvent) { 
//Tgnore events in HTML frames 
System. out. print1n( 
"HTML Frame events are ignored") ; 
} else { 
try { 
//Display page defined by the HyperlinkEvent. 
html .setPage(e.getURL()); 
} catch (Exception ex) { 
ex.printStackTrace() ; 
}//end catch 
}//end else 
}//end if 
}//end hyperlinkUpdate method 
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This code makes it possible to follow links by clicking the hyperlinks in the HTML page that is displayed. 
Note that only ACTIVATED events are processed and even those events are not processed if they are 
contained in an HTML frame. 

Following links 

The code in Listing 9 (p. 2724) is straightforward. The statement that causes the program to follow links 
is the call to the setPage method passing a URL as a parameter. The documentation for this message 
reads "Sets the current URL being displayed." 

The URL to be displayed is obtained by calling the getURL method on the incoming HyperlinkEvent 
object. The documentation for this method simply reads "Gets the URL that the link refers to." 

As you can see, therefore, writing a simple browser that will access a web page and follow links is not 
difficult. The output from running this program is shown in Image 3 (p. 2728) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2719 


EJ copyright 2014, R.G.Baldwin io = olx 
?xml version="1.0" encoding="iso-8859-1"?> 


Richard G Baldwin Programming Tutorials 


Baldwin@DickBaldwin.com 
http:/iwww.dickbaldwin.com 


If you find the links to any of my tutorials broken, you might try either: 


1. Going to Google or Bing and searching the web for pages having the same 
title, or 


2. Going to More articles by Richard G. Baldwin at Developer.com and 
searching that page for the tutorial by title. 


One of those two options is almost certain to lead you to a copy of the tutorial. 


lf you are looking for the drawing program for the blind that you may have heard about, it is posted at: 
http-//www_austincc_edu/baldwin/SWT-SVG/SVGDraw01 zip and is available for immediate download. - 
09/23/11 


This web site contains more than 600 programming tutorial lessons that | have published on 
ActionScript, Flex, Alice, Java, JavaScript, Python, XML, C#, Digital Signal Processing, and Wireless 
Technology. 


These tutorial lessons are freely available for online viewing. 
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Image 3 . JFrame output from the program named Java4655b. 
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Scrolling 
You should be able to run the program and follow the links from one page to the next. We are still 
missing something, however. If you click on a link to an anchor that is on the same page but not visible in 
the JFrame , nothing happens. This is because this version of the program is incapable of scrolling to and 
displaying that location on the page. Our next task will be to correct that issue. 


5.2.10.3.3 The program named Java4655a 


Scrolling code in Java4655a 
Listing 13 (p. 2739) provides a complete listing of a program that incorporates scrolling. The only 
difference between this program and the previous program is shown in Listing 10 (p. 2729) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2723 


Listing 10 . Scrolling code in Java4655a. 


if(websiteString != null) { 
html = new JEditorPane(websiteString) ; 
html .setEditable(false) ; 
html .addHyperlinkListener (this); 


JScrollPane scroller = new JScrollPane() ; 
JViewport vp = scroller.getViewport() ; 
vp.add(htm1) ; 
this. getContentPane() .add( 
scroller, BorderLayout .CENTER) ; 
this.setSize(669, 669); 
this.setVisible(true); 
}//end if 


Table 5.48 


The code in Listing 10 (p. 2729) that provides scrolling has nothing to do with network programming so 
I will leave it up to the student to find an explanation of this code somewhere else 58 on the web. 

Image 4 (p. 2733) shows the initial output from running this program. Note the vertical scroll bar on 
the right side of the image. 


*Shttp://docs.oracle.com/javase/tutorial/uiswing /components/scrollpane.html 
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Image 4 . JFrame output from the program named Java4655a. 
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5.2.10.3.4 What’s missing? 


There are at least three features that we would need to add to turn this program into a simple but functional 


web browser. 


e A way for the user to enter the website of interest and to change it at will. 
e A "Back" button. 
e A "Forward" button. 


Adding these features is not particularly difficult, but I will leave it as an exercise for the student to add 


these features and convert this program into a functional web browser. 
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5.2.10.4 Run the program 


I encourage you to copy the code from Listing 11 (p. 2735) , Listing 12 (p. 2737) , and Listing 13 (p. 2739) 
. Compile the code and execute it. Experiment with the code, making changes, and observing the results of 
your changes. Make certain that you can explain why your changes behave as they do. 


5.2.10.5 What’s next? 


The next module will introduce sockets for network programming. 


5.2.10.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4655: A Rendering Web Browser 
e File: Java4655.htm 

e Published: 03/02/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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Listing 11 . The program named Java4655c. 


/*File Java4655c.java 
Copyright 2014, R.G.Baldwin 
Rev 01/07/14 


This is a skeleton program that illustrates how to load 
a web page into a JEditorPane and illustrates how to 
identify the three types of hyperlink events: 


ENTERED 

EXITED 

ACTIVATED 

aK ak K ak K ak ak ak ak OOOO I I I aK aK 3K 3K K 3K I I I I I A 3K K IOI 2K ÞK 21 3K K K 2K 2K ÞK KK K K / 


import javax.swing.*; 

import javax.swing.event.*; 
import javax.swing.text.html.*; 
import java.net.*; 

import java.awt.*; 


class Java4655c{ 


public static void main(String[] args){ 
new Java4655c() .runner ( 
“http: //www.austincc.edu/baldwin") ; 
}//end main 


void runner(String webSiteLink) { 
try{ 
//Create a new URL object from the website string 
URL website = new URL(webSiteLink) ; 
//Instantiate an overall web page handler 
new Java4655cHtmlHandler (website) ; 
}catch(Exception e){ 
e.printStackTrace() ; 
}//end catch 
}//end runner 
}//end class Java4655c 


class Java4655cHtmlHandler extends JFrame 
implements HyperlinkListener{ 


//Constructor 
public Java4655cHtmlHandler(URL website) { 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 


setTitle "Copp Faery fa fee ak Conasrigns amytp://cnx.org/content/col11441/1.181> 


try{ 
if(website != null) { 


+ -Fh ri Ners NS 
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Listing 12 . The program named Java4655b. 


/*File Java4655b.java 
Copyright 2014, R.G.Baldwin 
Rev 01/05/14 


This is a simple web browser that can follow links. 
Uses website string to create JEditPane object. 


Ignores ENTERED and EXITED hyperlink events. Uses 
ACTIVATED events to follow links. 


Ignores links in HTML frames. 
FE A EEEE EEE EEEE EEEE E EEEE EE aK I I I E EEEE 21 21 EE 4 21 2 E E EE 2 a ak kak // 


import javax.swing.*; 

import javax.swing.event.*; 
import javax.swing.text.html.*; 
import java.net.*; 

import java.awt.*; 


class Java4655b{ 
public static void main(String[] args){ 
new Java4655b() .runner ("http://www.dickbaldwin.com") ; 
}//end main 


void runner(String websiteString) { 
try{ 
//Pass the website string to the constructor 
new Java4655bHtmlHandler (websiteString) ; 
}catch(Exception e){ 
e.printStackTrace() ; 
}//end catch 
}//end runner 
3//end class Java4655b 


//This version of the website handler requires the website 
// to be specified as a String instead of a URL. 
class Java4655bHtmlHandler extends JFrame 
implements HyperlinkListener{ 
JEditorPane html; 


//Constructor 

public Java4655bHtmlHandler (String websiteString) { 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setTitle("Copyright 2014, R.G.Baldwin") ; 


try{ 
if (websiteShxsimgle! formed hd Connexions <http://cnx.org/content /col11441/1.181> 
html = new JEditorPane(websiteString) ; 
html.setEditable(false); 
html .addHyperlinkListener (this); 


2732 CHAPTER 5. INEW 2338 ADVANCED JAVA (WEB) 


Table 5.51 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2733 


Listing 13 . The program named Java4655a. 


/*File Java4655a.java 
Copyright 2014, R.G.Baldwin 
Rev 01/05/14 


This is a simple web browser that can follow 
links. 


It ignores links in HTML frames. 
FEO AG EEE EEEE EEEE E EE EEEE EEEE 21 21 1 EE 21 21 21 EEEE E EE 2 ak ak kak // 


import javax.swing.*; 

import javax.swing.event.*; 
import javax.swing.text.html.*; 
import java.net.*; 

import java.awt.*; 


class Java4655a{ 
public static void main(String[] args){ 
new Java4655a() .runner ("http://www.dickbaldwin.com") ; 
}//end main 


void runner(String websiteString) { 
try{ 
new Java4655aHtmlHandler (websiteString) ; 
}catch(Exception e){ 
e.printStackTrace(); 
}//end catch 
}//end runner 
}//end class Java4655a 


class Java4655aHtmlHandler extends JFrame 
implements HyperlinkListener{ 
JEditorPane html; 


//Constructor 

public Java4655aHtmlHandler (String websiteString) { 
setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE) ; 
setTitle("Copyright 2014, R.G.Baldwin") ; 


try{ 
if(websiteString != null) { 
html = new JEditorPane(websiteString) ; 
html.setEditable(false); 
html .addHyperlinkListener (this); 


JScrollPane scroller = new JScrollPane(); 
JViewport vp = scroller.getViewport () ; 
vp . add (htmlailable for free at Connexions <http://cnx.org/content /coll1441/1.181> 
this. getContentPane() .add( 

scroller, BorderLayout.CENTER) ; 
this.setSize (669,669) ; 
this.setVisible(true): 
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-end- 


5.2.11 Java4660: Sockets” 
5.2.11.1 Table of Contents 
e Preface (p. 2740) 


Viewing tip (p. 2740) 


x Images (p. 2740) 
x Listings (p. 2740) 


e General background information (p. 2741) 
e Discussion and sample code (p. 2742) 


Simple TCP/IP services (p. 2742) 
Echo program (p. 2743) 
Date/time program (p. 2746) 
Simple browser program (p. 2748) 


e Run the programs (p. 2751) 
e Miscellaneous (p. 2751) 
e Complete program listings (p. 2753) 


5.2.11.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. More specifically, it is one in a sub-collection of modules 
designed for teaching network programming in that course. The purpose of this module is to introduce the 
student to the Socket class. 


5.2.11.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


5.2.11.2.1.1 Images 


e Image 1 (p. 2743) . Successful daytime query. 

e Image 2 (p. 2744) . Output for a successful echo test. 

e Image 3 (p. 2748) . Daytime program output. 

e Image 4 (p. 2751) . Output from the simple browser program. 


5.2.11.2.1.2 Listings 


e Listing 1 (p. 2744) . Beginning of the program named Java4660a. 

e Listing 2 (p. 2745) . Instantiate a Socket object. 

e Listing 3 (p. 2745) . Get I/O stream objects. 

e Listing 4 (p. 2746) . Send a line of text to the server and display the echo. 
e Listing 5 (p. 2747) . Beginning of the program named Java4660b. 


59This content is available online at <http://cnx.org/content /m49539/1.4/>. 
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Listing 6 (p. 2747) . Get an input stream. 

Listing 7 (p. 2748) . Read and display incoming data. 

Listing 8 (p. 2748) . Beginning of the program named Java4660c. 
Listing 9 (p ) . Create input and output streams. 

Listing 10 (p. 2750) . Send a GET command. 

Listing 11 (p. 2750) . Read and display text from the server. 
Listing 12 (p. 2753) . The program named Java4660a. 

Listing 13 (p. 2755) . The program named Java4660b. 

Listing 14 (p. 2757) . The program named Java4660c. 


5.2.11.3 General background information 


Sockets in Java come in at least three varieties that are implemented by the following Java classes 


e Socket 
e DatagramSocket 
e ServerSocket 


The first two socket classes represent TCP and UDP communications respectively. 

Generally, these two socket classes are used to implement both clients and servers, while the Server- 
Socket class is only used to implement servers. 

This module will concentrate on the use of the Socket class. The DatagramSocket class will be 
covered a future module. In the meantime, you can read about the DatagramSocket class and other 
interesting topics in my earlier publications at: 


Network Programming - Server Sockets °° 

Network Programming - Datagram Clients êt 

Network Programming - Datagram Servers ê? 

Network Programming - Stubs, Skeletons, and Remote Objects ô’ 
Wireless Home Security and Java ĉ4 


In addition, you may find a great deal of useful information in my older publications that are accessible at 
Programming Oldies But Goodies ® . 

A low-level mechanism 

Socket programming provides a low-level mechanism by which you can connect two computers for the 
exchange of data. One of those is generally considered to be the client while the other is considered to be 
the server 

The client initiates a connection with a server. Servers wait for a clients to initiate connections. 

A mutually acceptable application protocol 

The governing protocol will determine what happens after the connection is made. In order for two 
computers to communicate effectively, they must each implement some mutually acceptable application 
protocol. 

Data flow 

Socket programming makes it possible for you to cause data to flow in a full-duplex mode between a 
client anda server . This data flow can be viewed in almost exactly the same way that we view data flow 
to and from a disk: as a stream of bytes. 


6°http://cnx.org/content /m45602/latest /Java562.htm 
®lhttp://cnx.org/content /m45602/latest /Java564.htm 
®2http://cnx.org/content /m45602/latest /Java566.htm 
®3http://cnx.org/content /m45602/latest /Java568.htm 
§4http://cnx.org/content /m45605/latest /Java734.htm7-Sockets15 
®5http://cnx.org/content /col11478 /latest / 
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As with most stream data processing, the system is responsible for moving the bytes from the source to 
the destination. It is the responsibility of the programmer to assign meaning to those bytes. 

An application protocol 

Assigning meaning takes on a special significance for socket programming. In particular, as mentioned 
above, it is the responsibility of the programmer to implement a mutually acceptable communication protocol, 
at the application level, to cause the data to flow in an orderly manner. Some of the bytes are used to 
implement the protocol, and some of the bytes are used to transfer data. 

An application protocol is a set of rules by which the programs in the two computers can carry on a 
conversation and transfer data in the process. 

The HTTP protocol 

For example, we will write a very abbreviated form of the HTTP protocol to download a web page from 
a server and to display it as raw text. 

This program will involve adherence to a fairly simple protocol. (At least the part that we implement 
will be simple.) 

The daytime protocol 

We will also write a program that obtains the date and time from the same or another computer. In this 
case, the protocol is about as simple as it can possibly be. The client will simply make the connection and 
listen for a string containing the date and time. In this case, the client isn’t even required to make a request. 

The echo protocol 

We will write another program that sends a line of text to a computer and receives an echo of that text. 
This protocol is only slightly more complicated than the daytime protocol in that it is necessary to sent text 
to the other computer in order to elicit a response. 

The application protocol is the hard part 

It is easy to use sockets to write code that will cause a stream of bytes to flow in both directions between 
a client anda server . This is no more difficult than causing a stream of bytes to flow in both directions 
between memory and a file on a disk. 

Getting the bytes to flow is the easy part. Beyond that, you must do all of the programming to implement 
an application protocol that is understood by both the client and the server . Often that is the more 
difficult part. 


5.2.11.4 Discussion and sample code 
5.2.11.4.1 Simple TCP/IP services 


This discussion applies to the Windows operating system only. If you are using a different operating system 
you will need to do the necessary research to translate this information for use with your operating system. 

See Windows 7 Simple TCP/IP Services - What and How? °° for more detailed information on this 
topic. 

A simple server 

Windows and some other operating systems make it possible to cause a computer to act as a simple 
server to deliver the following services: 


e Echo on port 7 

e Daytime on port 13 

e Quote of the Day on port 17 

e Character generator on port 19 
e Discard on port 9 


This module will be concerned with only the first two. However, to use any of them, you must configure 
your computer to support all of them. 
Configuring your computer 


66http://www.windowsnetworking.com/articles-tutorials/windows-7 /Windows-7-Simple-TCPIP-Services- What-How.html 
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Do the following to configure your computer to support these services. 
In Windows 7, Vista, and possibly older versions of the Windows operating system, do the following: 


e Open the Control Panel 
e Select Programs and Features 
e Select Turn Windows features on or off 
e Scroll down to Simple TCPIP services and check the box 
e Also check the box for Telnet Client 
e Click OK and follow the directions 
On some computers, this may take a long time to complete. (It took more than 15 minutes on an older 
laptop computer that I own.) 
Test using telnet 
When the process is complete, open a command line window and enter the following: 
telnet localhost 13 
You should see something like the contents of Image 1 (p. 2743) if your computer is supporting simple 
TCP/IP services. 


Image 1 . Successful daytime query. 


5:27:30 PM 1/10/2014 


Connection to host lost. 


Table 5.53 


You can use localhost to do a query on the same machine or you can do a query on the name of some 
other properly configured computer on a local area network. 


(You can also use the name of the same computer in place of localhost to do a query on the same 
computer.) 


Opening ports on the firewall 

In the case of accessing another computer on the network, in addition to the procedure described above 
(p. 2743) , you may also need to open the required ports in the Windows firewall or perhaps a firewall that 
is being managed by other software running on that computer. 


(The ports of interest are shown in the above list (p. 2742) .) 


I won’t attempt to explain how to open and close ports in the firewall. The Windows Help and Support 
feature explains how to open and close ports in the Windows firewall. If the firewall is being managed by 
another program, the documentation for that program should explain how to open and close ports. 


5.2.11.4.2 Echo program 


This program implements a client that performs a simple echo test by sending a line of text to the echo port 
(port 7) on a server (or on the same computer) . 
Overview 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2738 CHAPTER 5. INEW 2338 ADVANCED JAVA (WEB) 


The program begins by instantiating a String object containing the name of an echo server that is 
being used to test the program (localhost as the program is shown in Listing 1 (p. 2744) ) . This is followed 
by the declaration and initialization of an int variable containing the standard echo port number (7) . 

Than the program gets a socket connection to port 7 on the server as shown in Listing 2 (p. 2745) .. 

Following this, the program gets input and output streams from the socket and wraps them in the 
Reader and Writer classes as shown in Listing 3 (p. 2745) . 

Once the connection is made and the input and output streams are ready to use, the program sends a 
line of text to the echo port on the specified server as shown in Listing 4 (p. 2746) . This causes the server 
to send the same line of text back to the client. 

The program reads the line of text that is received and displays it in the command-line window. 

Finally, the program closes the socket and terminates. 

The program output 

Assuming that you select a computer that supports echo processing on port 7, the output from this 

program should be as shown in Image 2 (p. 2744) . 


Image 2 . Output for a successful echo test. 


echo: This is an echo test 


Table 5.54 


Beginning of the program named Java4660a 

I will discuss this program in fragments. (I will ignore exception handling code.) A complete listing 
of the program is provided in Listing 12 (p. 2753) . The beginning of the program is shown in Listing 1 (p. 
2744) . 


Listing 1 . Beginning of the program named Java4660a. 


import java.net.*; 
import java.io.*; 
import java.util.*; 


class Java4660af{ 
public static void main(String[] args){ 
String server = "localhost"; 
int port = 7; //echo port 


Table 5.55 


Listing 1 (p. 2744) declares and initializes two local variables to specify the server and the port. We will 
use these variables later. 

Instantiate a Socket object 

Listing 2 (p. 2745) shows the key statement in this program insofar as learning new material is concerned. 
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Listing 2 . Instantiate a Socket object. 


Socket socket = new Socket(server, port) ; 


Table 5.56 


The statement in Listing 2 (p. 2745) establishes a connection with the specified port on the specified 
server by instantiating a new object of type Socket 

Once this object exists, it is possible to use it to communicate with the server on the specified port using 
the protocol prescribed for the service being delivered on that port. 

The constructor for this class throws two different types of exceptions so you will need to wrap this 
statement in a try/catch block. The two types of exceptions are: 


e UnknownHostException 
e IOException 


Get I/O stream objects 
Once you have a Socket object, you can use that object to open input and output streams that allow 
you to transfer data between the client and the server using the code shown in Listing 3 (p. 2745) . 


Listing 3 . Get I/O stream objects. 


BufferedReader inputStream = 
new BufferedReader (new InputStreamReader ( 
socket .getInputStream())); 


PrintWriter outputStream = 
new PrintWriter(new OutputStreamWriter ( 
socket .getOutputStream()) , true) ; 


Table 5.57 


Note that the true parameter in the last line of Listing 3 (p. 2745) causes the output stream to flush 
automatically. Proper flushing is an important aspect of socket programming. 

Send a line of text to the server and display the echo 

The code in Listing 4 (p. 2746) uses the outputStream created above to send a line of text to the 
server, and then uses the inputStream created above to capture and display the echo that is returned 
from the server. 


Listing 4 . Send a line of text to the server and display the echo. 


continued on next page 
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//Send line of text to the server 
outputStream.println("This is an echo test"); 
//Get echoed line back from server and display it 
System.out.println("echo: "+tinputStream.readLine()); 


//Close the socket 
socket.close(); 


Table 5.58 


Then Listing 4 (p. 2746) closes the socket. 

You can view the remainder of the program in Listing 12 (p. 2753) . 

The essence of socket programming 

That’s really about all there is to socket programming from the client viewpoint. 

Beyond this, the programming complexity associated with socket programming results from the require- 
ment to implement an application protocol that will successfully communicate with the server. 


5.2.11.4.3  Date/time program 


This program implements a client that gets the date and time from the daytime port (13) on a server 
that supports that port. 

This program is even simpler than the previous one, because it isn’t necessary to send anything to the 
server to get the desired result. All that is necessary to cause the server to send the information is to make 
the connection. 

This program gets and displays the date and time on the server at " localhost ". However, you can 
modify the program to access another computer in your network if you choose to do so. It is not likely that 
you will find a server on the Internet at large that still supports the daytime port, but you can try. 

The program also displays the current date and time in Austin, TX (or wherever the program happens 
to be run) for comparison. 

Beginning of the program named Java4660b 
As usual, I will explain this program in fragments. A complete listing is provided in Listing 13 (p. 2755) 


T 


As shown in Listing 5 (p. 2747) , program begins by instantiating a String object containing the name 
of the server being used to test the program. 
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Listing 5 . Beginning of the program named Java4660b. 


import java.net.*; 
import java.io.*; 
import java.util.*; 


class Sockets04{ 
public static void main(String[] args){ 
String server = "localhost"; 
int port = 13; //daytime port 


try{ 
//Get a socket, connected to the specified server 
// on the specified port. 
Socket socket = new Socket(server, port) ; 


Table 5.59 


This is followed by the declaration and initialization of an int variable identifying the standard daytime 
port: port 13. 

Than the program gets a socket connection to port 13 on the specified server. 

Get an input stream 

Following this, the program gets an input stream from the socket and wraps it in the reader classes as 
shown in Listing 6 (p. 2747) . 


Listing 6 . Get an input stream. 


//Get an input stream from the socket 
BufferedReader inputStream = 
new BufferedReader(new InputStreamReader ( 
socket .getInputStream())); 


Table 5.60 


This program doesn’t need an output stream because the client doesn’t send anything to the server. As 
mentioned earlier, simply connecting is sufficient to trigger the server to send the date and time. 

Read and display incoming data 

After the connection is made via the socket and the input stream is ready to use, the client reads a line 
of incoming text as shown in Listing 7 (p. 2748) . This line of text contains the date and time sent by the 
server. 
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Listing 7 . Read and display incoming data. 


System.out.println("Current time at " + server); 
System.out.println(inputStream.readLine()); 
System.out.println("Current time in Austin, TX:"); 
System.out.println(new Date()); 


//Close the socket 
socket.close(); 


Table 5.61 


Daytime program output 

The program displays this line of text, and also gets and displays the date and time on the local system 
using the Date class for comparison. 

Image 3 (p. 2748) shows the output for one run of the program. 


Image 3 . Daytime program output. 


Current time at localhost 
8:29:56 AM 1/12/2014 
Current time in Austin, TX: 
Sun Jan 12 08:29:56 CST 2014 


Table 5.62 


Then the program closes the socket and terminates. 


5.2.11.4.4 Simple browser program 


The next program is an extremely simple web browser program. More correctly, the next program is a simple 
HTTP client implemented using sockets. A complete listing of the program is provided in Listing 14 (p. 
2757) . 

The program implements just enough of the HTTP protocol to make it capable of getting a file from an 
HTTP server. Considerably more programming effort would be required to turn it into a useful browser. 

Beginning of the program named Java4660c 

As shown in Listing 8 (p. 2748) , the program begins by defining the name of a server and the number 
of the HTTP port on that server. Although the standard port number for HTTP servers is port 80, this 
program is written to access a Tomcat server as localhost using port 8080. 


Listing 8 . Beginning of the program named Java4660c. 


continued on next page 
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import java.net.*; 
import java.io.*; 


class Java4660cf{ 
public static void main(String[] args){ 


String server = "localhost"; 
int port = 8080; //http port on localhost 
try{ 


//Get a socket, connected to the specified server 
// on the specified port. 
Socket socket = new Socket(server, port); 


Table 5.63 


Then the program opens a socket to the specified server on the specified port. 

Create input and output streams 

As shown in Listing 9 (p. 2749) , the program creates input and output stream objects for transferring 
data between the client and the server 


Listing 9 . Create input and output streams. 


//Get an input stream from the socket 
BufferedReader inputStream = 
new BufferedReader(new InputStreamReader ( 
socket .getInputStream())); 


//Get an output stream to the socket. Note 
// that this stream will autoflush. 
PrintWriter outputStream = 
new PrintWriter(new OutputStreamWriter ( 
socket .getOutputStream()) , true) ; 


Table 5.64 


The output stream will autoflush , which is critical. If the output stream isn’t flushed, the server will 
not respond properly. (Presumably it may not receive all of the data until the stream is flushed.) 

Send a GET command 

The HTTP protocol provides several different commands or requests that the client can send to the 
server. This program implements only the GET command. This is a request by the client to find and 
download a specified file. 

Then, as shown in Listing 10 (p. 2750) , acting as an HTTP client, the program sends a GET 
command to the server specifying a particular path and file name. The GET command is part of the 
HTTP application protocol. 
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Listing 10 . Send a GET command. 


outputStream.println("GET /Java4570b. jsp"); 


Table 5.65 


Fetch and send 

This causes the server to attempt to fetch the specified file and send it to the client. If the server is being 
properly supported on the specific port, it will send something, although that something could be an error 
message. 

Note that the request includes not only the file name, but also the path to that file relative to the 
directory that the HTTP server software considers to be the pseudo-root . This is probably not the actual 
root directory on the server computer, but rather is a logical root. 

The server software is willing to access and deliver files from directories relative to this pseudo-root . 

Note that the request is actually made by printing a line of text on the stream that is connected to the 
server. 

Read and display text from the server 

Finally as shown in Listing 11 (p. 2750) , the program reads lines of text from the input stream and 

displays them on the standard output device. 


Listing 11 . Read and display text from the server. 


//Declare a String to read lines into. 
String line = null; 


//Loop reading and displaying lines until null 

// is received. 

while((line = inputStream.readLine()) != null) 
System. out.println(line) ; 


//Close the socket 
socket.close(); 


Table 5.66 


Output from the simple browser program 
In this particular case, the output was as shown in Image 4 (p. 2751) . 


Image 4 . Output from the simple browser program. 


continued on next page 
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<html> 
<head><title>Java4570b</title></head> 
<body> 


<form method=’ get’ 
action=’http://localhost :8080/Java4570b. jsp’ > 
<p>Enter a name and press the button</p> 
<p>Name: <input type=’text’ name=’firstName’/></p> 
<input type=’submit’ value=’Submit Name’/> 


<br/><br/>Your session ID and list of names is:<br/> 
Empty<br/> 


</form></body></html> 


Table 5.67 


A curious result 

The requested file was a JSP file consisting of JSP tags embedded in HTML code. Curiously, only the 
HTML code was returned by the server. (I suppose it is also possible that the JSP tags were returned but 
were not displayed by the program for some reason.) 

In any event, I will leave it as an exercise for those students who may be interested to research the matter. 
As I mentioned earlier: 


"Getting the bytes to flow is the easy part. Beyond that, you must do all of the programming 
to implement an application protocol that is understood by both the client and the server 
Often that is the more difficult part." 


When there are no more lines to be read, a null is received. This causes the client to exit the input loop and 
to close the socket. 
5.2.11.5 Run the programs 


I encourage you to copy the code from Listing 12 (p. 2753) , Listing 13 (p. 2755) , and Listing 14 (p. 2757) 
. Compile the code and execute it. Experiment with the code, making changes, and observing the results of 
your changes. Make certain that you can explain why your changes behave as they do. 


5.2.11.6 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4660: Sockets 
e File: Java4660.htm 

e Published: 03/02/14 

e Revised: 03/03/14 
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e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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Listing 12 . The program named Java4660a. 


/*File Java4660a.java Copyright 1998, R.G.Baldwin 
Revised 01/10/14 


This program performs a simple echo test with localhost 
by sending a line of text to the echo port, port 7. 


The computer must have been previously configured to 
support the echo port. 


The output from this program is: 


echo: This is an echo test 
TCT ECS CCCCLeCTeCrerCrrrrrcrrrrerrrrerrrrerrrrrrrerite TT... t 2 2 94 


import java.net.*; 
import java.io.*; 
import java.util.*; 


class Java4660af{ 
public static void main(String[] args){ 
String server = "localhost"; 
int port = 7; //echo port 


try{ 
//Get a socket, connected to the specified server 
// on the specified port. 
Socket socket = new Socket(server, port) ; 


//Get an input stream from the socket 
BufferedReader inputStream = 
new BufferedReader(new InputStreamReader ( 
socket .getInputStream())); 


//Get an output stream to the socket. Note 
// that this stream will autoflush. 
PrintWriter outputStream = 
new PrintWriter(new OutputStreamWriter ( 
socket .getOutputStream()) , true) ; 


//Send line of text to the server 
outputStream.println("This is an echo test"); 

//Get echoed line back from server and display it 
System.out.println("echo: "+tinputStream.readLine()); 


//Close the socket 
socket.close(); 
}//end try 
catch(Excepti 
e.printStackTrace() ; 
}//end catch 
}//end main 


> s7 ig ee es PPTA 
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Table 5.68 
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Listing 13 . The program named Java4660b. 


/*File Sockets04.java Copyright 1998, R.G.Baldwin 
Revised 01/10/14 


This program gets and displays the date and time on the 
server at "localhost". 


It also displays the current date and time in Austin, 
TX, or wherever the program happens to be run. 


The computer must have been previously configured to 
support the daytime port. 


One output from this program was: 


Current time at localhost 

2:39:55 PM 1/10/2014 

Current time in Austin, TX: 

Fri Jan 10 14:39:55 CST 2014 

aoa o E o k kkk kkk kk kk kkk kkk kkk k kk kkk k / 


import java.net.*; 
import java.io.*; 
import java.util.*; 


class Sockets04{ 
public static void main(String[] args){ 
String server = "localhost"; 
int port = 13; //daytime port 


try{ 
//Get a socket, connected to the specified server 
// on the specified port. 
Socket socket = new Socket(server, port); 


//Get an input stream from the socket 
BufferedReader inputStream = 
new BufferedReader(new InputStreamReader ( 
socket .getInputStream())); 


System.out.println("Current time at " + server); 
System.out.println(inputStream.readLine()); 
System.out.println("Current time in Austin, TX:"); 
System.out.println(new Date()); 


//Close the socket 
socket.close(); 

}//end try 

catch(Exception e){ 
e.printStackTrace() ; 

}//end catch Haknornie sti xcepmhexions <http://cnx.org/content /coll1441/1.181> 

}//end main 
}//end class Sockets04 
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Table 5.69 
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Listing 14 . The program named Java4660c. 


/*File Java4660c.java Copyright 1998, R.G.Baldwin 
Revised 01/10/14 


This program is a simple http client (web browser) 
implemented using sockets. 


The program implements just enough of the http protocol 
to make it capable of getting an html page from an 
http server. 


The program, acting as an http client, sends a GET 
command to the server specifying a particular path and 
file name. 


The server is a Tomcat server operating as localhost 
on port 8080. 


As of 01/10/14, the output from this program was as 
follows. 


<html> 
<head><title>Java4570b</title></head> 
<body> 


<form method=’ get’ 

action=’http://localhost :8080/Java4570b. jsp’ > 
<p>Enter a name and press the button</p> 
<p>Name: <input type=’text’ name=’firstName’/></p> 
<input type=’submit’ value=’Submit Name’/> 


<br/><br/>Your session ID and list of names is:<br/> 
Empty<br/> 


</form></body></html> 
FOO OO I GO I a a aK a a a 2k 3k 2k 3k 2k 2k 2k ok 2k 2k 2 2k 2k 2k ok 2k 3k 2k ok 2k ok 2k 2k 2k ok 2 ak 2k ake // 


import java.net.*; 
import java.io.*; 


class Java4660c{ 
public static void main(String[] args){ 


String server = "localhost"; 
int port = 8080; //http port on localhost 
try{ 


//Get a socket, connected to the specified server 
// on the speshbiedr Bett Connexions <http://cnx.org/content /col11441/1.181> 
Socket socket = new Socket(server, port); 
//Get an input stream from the socket 
BufferedReader inputStream = 
new BufferedReader(new InputStreamReader ( 
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Table 5.70 


-end- 
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5.2.12 Java4660r-Review™ 
5.2.12.1 Table of Contents 


e Preface (p. 2759) 
e Questions (p. 2759) 


1 (p. 2759) , 2 (p. 2759) , 3 (p. 2759) , 4 (p. 2759) , 5 (p. 2760) 


e Answers (p. 2761) 
e Miscellaneous (p. 2762) 


5.2.12.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4660: Sockets ® in 
the Network Programming sub-collection. 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


5.2.12.3 Questions 
5.2.12.3.1 Question 1 


True or False? 
Sockets in Java come in at least three varieties that are implemented by the following Java classes 


e Connector 
e DatagramConnector 
e ServerConnector 


Go to answer 1 (p. 2762) 


5.2.12.3.2 Question 2 


True or False? 
The Socket and DatagramSocket classes represent TCP and UDP communications respectively. 
Go to answer 2 (p. 2761) 


5.2.12.3.3 Question 3 


True or False? 

Generally, the ServerSocket class is used to implement both clients and servers, while the Socket 
and DatagramSocket classes are only used to implement servers 

Go to answer 3 (p. 2761) 


5.2.12.3.4 Question 4 


True or False? 

Socket programming provides a low-level mechanism by which you can connect two computers for the 
exchange of data. 

Go to answer 4 (p. 2761) 


67This content is available online at <http://cnx.org/content /m49571/1.3/>. 
*Shttp://cnx.org/content /m49539/latest /?collection=coll1441/latest 
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5.2.12.3.5 Question 5 


True or False? 

Socket programming makes it possible for you to cause data to flow in a full-duplex mode between a 
client anda server . This data flow can be viewed in almost exactly the same way that we view data flow 
to and from a disk: as a stream of bytes. 

Go to answer 5 (p. 2761) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 

keep them from being visible on the screen at the same time. 


None KEX] 


Display your named 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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5.2.12.4 Answers 
5.2.12.4.1 Answer 5 
True. 

Go back to Question 5 (p. 2760) 
5.2.12.4.2 Answer 4 
True. 

Go back to Question 4 (p. 2759) 
5.2.12.4.3 Answer 3 


False. Generally, the Socket and DatagramSocket classes are used to implement both clients and 
servers, while the ServerSocket class is only used to implement servers 
Go back to Question 3 (p. 2759) 


5.2.12.4.4 Answer 2 


True. 
Go back to Question 2 (p. 2759) 
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5.2.12.4.5 Answer 1 


False. Sockets in Java come in at least three varieties that are implemented by the following Java classes 


e Socket 
e DatagramSocket 
e ServerSocket 


Go back to Question 1 (p. 2759) 


5.2.12.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4660r-Review 
e File: Java4660r.htm 

e Published: 03/08/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


5.3 Search Engines 


5.3.1 Java4585: Getting Started with Search Engines” 
5.3.1.1 Table of Contents 
e Preface (p. 2763) 


Servlets versus search engines (p. 2763) 


x Servlet deployment issues (p. 2763) 
* Search engines (p. 2763) 


e Miscellaneous (p. 2764) 


®°This content is available online at <http://cnx.org/content /m55646/1.2/>. 
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5.3.1.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. The purpose of this module is to get you started with Search 
Engines. 


5.3.1.2.1 Servlets versus search engines 


Servlets and search engines are both very important tools in a Java web-programming environment. In some 
cases, they may be connected and in other cases they may have no connection whatsoever. At one point in 
time, this course required students to demonstrate competency in servlets by configuring, maintaining, and 
programming a local Tomcat web server. However, that is no longer the case. The servlet material that 
begins here "° and ends here “! is no longer a required part of this course for the reasons given below. That 
requirement has been replaced by a requirement to demonstrate competency in web search engines. 


5.3.1.2.1.1 Servlet deployment issues 


The Computer Studies Department at Austin Community College (ACC) is unwilling to allow students to 
install servers on the lab computers due to security concerns. Students were asked to install a server on their 
own private computers for deployment and testing of servlets. However, this doesn’t satisfy the objective 
of providing on-campus computer resources to support all programming assignments. Furthermore, I found 
that students were spending more time and effort on server configuration issues than on Java programming 
issues. 

Under these circumstances, I have concluded that it is impractical (at ACC) to assess the capability of 
a student to write and deploy servlets. As a result, I have eliminated the servlet competency requirement 
from this course and have replaced it with a "search engine" competency. 

However, it is strongly recommended that, if possible, students install a server on their own private 
computer in order to write, deploy, and test servlets. That will make it possible for students to gain practical 
hands-on experience with servlets and to cement their knowledge of servlets in preparation for landing a job 
as a Java programmer. 


5.3.1.2.1.2 Search engines 


On the other hand, it is practical for an instructor to assess a student’s understanding of and ability to 
develop a web search engine written in Java. This is also a very valuable skill for a student to learn. This 
assessment can be based solely on practical programming assignments along with a written test. Therefore, 
the hands-on assessments and the test for this competency will consist solely of search-engine programming 
assignments and material. 

The search-engine assignments can be written and tested on any computer capable of running the Java 
Standard Edition development kit (including the computers in the on-campus labs) with no requirement 
to install any special software. 

The ability to develop a rudimentary search engine doesn’t require any knowledge of Java programming 
beyond that which the student should already have acquired in this and the prerequisite courses. However, it 
does require the student to do independent research into the syntax and structure of HTML web pages and 
to combine that knowledge with prior knowledge of Java programming. Thus, this search-engine competency 
requirement tests the student’s ability to apply prior Java programming knowledge to a very useful real-world 
scenario — search engines. 

Students will be provided the source code for a rudimentary Java web crawler that can be used as a 
starting point for the development of the search engine required for each assignment. Students who have 
completed the prerequisite courses should have no difficulty understanding the code in that program. It will 


Ohttp://cnx.org/contents/d065b23c-7c70-493d-95fd-7e4f9 1f0d99e 
“lhttp://cnx.org/contents/94aa8d30-9b75-4f98-b08f-6cb526ae24aa 
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be the responsibility of the student to modify and upgrade the web crawler program in such a way as to 
satisfy the specifications for each programming assignment. 

Students will also be provided links to several online search-engine resources along with review questions 
and answers for use in preparing for the written test. 


5.3.1.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4585: Getting Started with Search Engines 
e File: Java4530.htm 

e Published: 05/17/15 

e Revised: 09/04/15 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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5.3.2 Java4590r-Review for search engines” 
5.3.2.1 Table of contents 


e Preface (p. 2765) 
e Questions (p. 2765) 


1 (p. 2765) , 2 (p. 2765) , 3 (p. 2765) , 4 (p. 2765) , 5 (p. 2766) , 6 (p. 2766) , 7 (p. 2766) , 8 
(p. 2766) , 9 (p. 2766) , 10 (p. 2766) , 11 (p. 2766) , 12 (p. 2766) , 13 (p. 2767) , 14 (p. 2767) , 
15 (p. 2767) 


e Answers (p. 2768) 
e Miscellaneous (p. 2770) 


5.3.2.2 Preface 


This module is one in a collection of modules designed for teaching INEW2338 Advanced Java Programming 
at Austin Community College in Austin, TX. 

This module contains review questions and answers on search engines along with hyperlinks to online 
material from which those questions and answers were derived. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


5.3.2.3 Questions 
5.3.2.3.1 Question 1 


True or False? The robots lockout standard , also known as the robots lockout protocol or 
robots.txt protocol , is a standard used by websites to communicate with web crawlers and other web 
robots. 

Go to answer 1 (p. 2770) 


5.3.2.3.2 Question 2 


True or False? The robots exclusion standard specifies the instruction format to be used to inform the 
robot about which areas of the website should not be processed or scanned. 
Go to answer 2 (p. 2770) 


5.3.2.3.3 Question 3 


True or False? All robots cooperate with the robots exclusion standard including email harvesters, 
spambots and malware robots that scan for security vulnerabilities. 
Go to answer 3 (p. 2770) 


5.3.2.3.4 Question 4 


True or False? When a site owner wishes to give instructions to web robots they place a text file called 
robots.txt in the root of the web site hierarchy (e.g. https://www.example.com/robots.txt). This text file 
contains the instructions in a specific format. Robots that choose to follow the instructions try to fetch this 
file and read the instructions before fetching any other file from the web site. If this file doesn’t exist, web 
robots assume that the web owner wishes to provide no specific instructions, and crawl the entire site. 

Go to answer 4 (p. 2770) 


“This content is available online at <http://cnx.org/content /m55520/1.1/>. 
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5.3.2.3.5 Question 5 
True or False? Marking an area of a site "out of bounds" with robots.txt guarantees exclusion of all web 
robots. 
Go to answer 5 (p. 2770) 
5.3.2.3.6 Question 6 


True or False? To cause a webpage to perform better in search engine listings, the most important content 
should be in Flash files. 

Go to answer 6 (p. 2769) 
5.3.2.3.7 Question 7 


True or False? Search engines have two major functions: 


1. crawling and building an index, and 
2. providing search users with a ranked list of the websites they’ve determined are the most relevant. 


Go to answer 7 (p. 2769) 


5.3.2.3.8 Question 8 


True or False? The link structure of the web serves to bind all of the pages together. Links allow the search 
engines’ automated robots, called "crawlers" or "spiders," to reach the many billions of interconnected 
documents on the web. Once the engines find these pages, they decipher the code from them and store 
selected pieces in massive databases, to be recalled later when needed for a search query. 

Go to answer 8 (p. 2769) 


5.3.2.3.9 Question 9 


True or False? Search Engine Optimization (SEO) is the process of affecting the visibility of a website or a 
web page in a search engine’s unpaid results - often referred to as "natural," "organic," or "earned" results. 
Go to answer 9 (p. 2769) 


5.3.2.3.10 Question 10 


True or False? When a person performs an online search, the search engine begins crawling the web and 
returning a list of all connected hyperlinks that are encountered. 

Go to answer 10 (p. 2769) 
5.3.2.3.11 Question 11 


True or False? Search engines typically assume that the more popular a site, page, or document, the more 
valuable the information it contains must be 

Go to answer 11 (p. 2769) 
5.3.2.3.12 Question 12 


True or False? The prototype for the Google search engine was developed at MIT. 
Go to answer 12 (p. 2769) 
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5.3.2.3.13 Question 13 


True or False? One of the main contributions to improved search engine performance, developed by Brin 
and Page, was PageRank 
Go to answer 13 (p. 2768) 


5.3.2.3.14 Question 14 


True or False? PageRank is an algorithm used by Google Search to rank websites in their search 
engine results. PageRank was named after Larry Page, one of the founders of Google. PageRank is a way of 
measuring the importance of website pages. According to Google: PageRank works by counting the number 
and quality of links to a page to determine a rough estimate of how important the website is. The underlying 
assumption is that more important websites are likely to receive more links from other websites 

Go to answer 14 (p. 2768) 


5.3.2.3.15 Question 15 


True or False? PageRank isthe only algorithm used by Google to order search engine results. 

Go to answer 15 (p. 2768) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None 


Display your namet 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 


Put your name here 


5.3.2.4 Answers 
5.3.2.4.1 Answer 15 


False. PageRank is not the only algorithm used by Google to order search engine re- 
sults, but it is the first algorithm that was used by the company, and it is the best-known. (See 
http://en. wikipedia.org /wiki/PageRank "° .) 

Go back to Question 15 (p. 2767) 


5.3.2.4.2 Answer 14 
True. (See http://en.wikipedia.org/wiki/PageRank ™ .) 
Go back to Question 14 (p. 2767) 


5.3.2.4.3 Answer 13 


True. (See http://en.wikipedia.org/wiki/Search_engine_optimization ™ .) 
Go back to Question 13 (p. 2767) 


3http://en.wikipedia.org/wiki/ PageRank 
“4http://en.wikipedia.org/wiki/ PageRank 
“5http://en.wikipedia.org/wiki/Search engine optimization 
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5.3.2.4.4 Answer 12 


False. The prototype for the Google search engine was developed by Sergy Brin and Lawrence Page at 
Stanford. (See The Anatomy of a Large-Scale Hypertextual Web Search Engine "° .) Apparently that 
prototype search engine was known as "Backrub". 

Go back to Question 12 (p. 2766) 


5.3.2.4.5 Answer 11 


True. (See http://moz.com/beginners-guide-to-seo/how-search-engines-operate " .) 
Go back to Question 11 (p. 2766) 


5.3.2.4.6 Answer 10 


False. When a person performs an online search, the search engine scours its corpus of billions of documents, 
(which was created earlier by crawling and indexing web sites) and does two things: first, it returns only 
those results that are relevant or useful to the searcher’s query; second, it ranks those results according to 
the popularity of the websites serving the information. It is both relevance and popularity that the process 
of Search Engine Optimization is meant to influence. (See http://moz.com/beginners-guide-to-seo/how- 
search-engines-operate "8 .) 
Go back to Question 10 (p. 2766) 


5.3.2.4.7 Answer 9 

True. (See http://en.wikipedia.org/wiki/Search_engine_ optimization 7° .) 
Go back to Question 9 (p. 2766) 

5.3.2.4.8 Answer 8 

True. (See http://moz.com/beginners-guide-to-seo/how-search-engines-operate °° .) 
Go back to Question 8 (p. 2766) 

5.3.2.4.9 Answer 7 

True. (See http://moz.com/beginners-guide-to-seo/how-search-engines-operate 8! .) 
Go back to Question 7 (p. 2766) 

5.3.2.4.10 Answer 6 


False. To cause a webpage to perform better in search engine listings, the most important content should 
be in HTML text format. Images, Flash files, Java applets, and other non-text content are often ignored 
or devalued by search engine crawlers. The easiest way to ensure that the words and phrases you display 
to your visitors are visible to search engines is to place them in the HTML text on the page. (See 
http://moz.com/beginners-guide-to-seo /basics-of-search-engine-friendly-design-and-development 8° .) 

Go back to Question 6 (p. 2766) 


“6http://infolab.stanford.edu/~backrub/google.html 

“Thttp://moz.com/beginners-guide-to-seo /how-search-engines-operate 
“8http://moz.com/beginners-guide-to-seo /how-search-engines-operate 
“9http://en.wikipedia.org/wiki/Search engine optimization 
8°http://moz.com/beginners-guide-to-seo /how-search-engines-operate 

81 http://moz.com/beginners-guide-to-seo /how-search-engines-operate 
82http://moz.com/beginners-guide-to-seo /basics-of-search-engine-friendly-design-and-development 
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5.3.2.4.11 Answer 5 


False. Despite the use of the terms "allow" and "disallow", the robots exclusion standard 
is purely advisory. It relies on the cooperation of the web robot, so that marking an area of a 
site "out of bounds" with robots.txt does not guarantee exclusion of all web robots. (See 
http://en.wikipedia.org/wiki/Robots_exclusion_ standard 83 .) 

Go back to Question 5 (p. 2766) 


5.3.2.4.12 Answer 4 


True. (See http://en.wikipedia.org/wiki/Robots_exclusion_ standard ** .) 
Go back to Question 4 (p. 2765) 


5.3.2.4.13 Answer 3 


False. Not all robots cooperate with the standard including email harvesters, spambots and malware robots 
that scan for security vulnerabilities. (See http://en.wikipedia.org/wiki/Robots_exclusion_ standard ®° .) 
Go back to Question 3 (p. 2765) 


5.3.2.4.14 Answer 2 


True. (See http://en.wikipedia.org/wiki/Robots_exclusion_ standard *° .) 
Go back to Question 2 (p. 2765) 


5.3.2.4.15 Answer 1 


False. The robots exclusion standard , also known as the robots exclusion protocol or 
robots.txt protocol , is a standard used by websites to communicate with web crawlers and other web 
robots. (See http://en.wikipedia.org/wiki/Robots_exclusion_ standard ®" ) 

Go back to Question 1 (p. 2765) 


5.3.2.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4590r-Review for search engines 
e File: Java4590r.htm 
e Published: 05/04/15 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


83http://en.wikipedia.org/wiki/Robots_exclusion_ standard 
§4http://en.wikipedia.org/wiki/Robots exclusion standard 
85http://en.wikipedia.org/wiki/Robots_exclusion_ standard 
86http://en.wikipedia.org/wiki/Robots exclusion_ standard 
87http://en.wikipedia.org/wiki/Robots exclusion standard 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


5.4 Servlets 


5.4.1 Java4530: Getting Started with Servlets” 
5.4.1.1 Table of Contents 


e Preface (p. 2771) 
Viewing tip (p. 2772) 
x Images (p. 2772) 
x Listings (p. 2772) 
e General background information (p. 2772) 


Test for a successful connection on localhost (p. 2772) 
Upgrading your Java development environment (p. 2780) 


Discussion and sample code (p. 2780) 
What’s next? (p. 2788) 
Miscellaneous (p. 2788) 

Complete program listings (p. 2790) 


5.4.1.2 Preface 


Note: As of the Summer semester of 2015, this sub-collection on servlets is no longer part of the 
course for INEW 2338 Advanced Java (Web) at Austin Community College in Austin, TX. See 
the module titled Java4585: Getting Started with Search Engines 8° for an explanation of the 
reason why. 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. The purpose of this module is to get you started writing, 
deploying, and testing Java servlets. 

If you haven’t done so already, I strongly recommend that you study the following two modules before 
continuing with this module: 


e Java4307: Servlets and JSP °° 
e Java4308: Deploying JSP and Servlets °! 


While studying Java4308 °? , I recommend that you download, install on your local machine, and test the 
Apache Tomcat web server. Eventually students enrolled in this course will deploy and test their servlet 
programs on a web server operated by the college. However, the first several modules in this sub-collection 
will expect students to deploy and test servlets on a local web server. 


88This content is available online at <http://cnx.org/content /m48509/1.5/>. 
8®http://cnx.org/contents/6c2bdcff-1009-4c30-b04b-70053485043b 
*°http://cnx.org/content /m48284 /latest /?collection=col11441 /latest 
®*lhttp://cnx.org/content /m48488 /latest /?collection=col11441/latest 
°*2http://cnx.org/content /m48488 /latest /?collection=col11441/latest 
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5.4.1.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


5.4.1.2.1.1 Images 


e Image 1 (p. 2779) . Web server test. 

e Image 2 (p. 2782) . Inew2338_050.java. 
e Image 3 (p. 2784) . Inew2338_051.java. 
e Image 4 (p. 2788) . Inew2338_052.jsp. 


5.4.1.2.1.2 Listings 


e Listing 1 (p. 2790) . Inew2338_050.java. 
e Listing 2 (p. 2790) . Inew2338_051.java. 
e Listing 3 (p. 2792) . Inew2338_052.jsp. 


5.4.1.3 General background information 
5.4.1.3.1 Test for a successful connection on localhost 


Assuming that you have properly installed the Tomcat web server on your machine, you should be able to 
start the server and point your browser to http://localhost:8080/ to see something similar to Image 1 
(p. 2779) in your browser. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


) Apache Tomcat/8.0.0-RC5 - Mozilla Firefox 


File Edit View History Bookmarks Tools Help 


C= EEE Coe 


Home Documentation Configuration Examples Wiki 


Apache Tomcat/8.0.0-RC5 Re G 


If you're seeing this, you've successfully 


Congratulations! 


Recommended Reading: 


Developer Quick Start 


Tomcat Setup Realms & AAA Examples 
First Web lication JDBC Data Sources 


Managing Tomcat Documentation 
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If you don’t see that, you should probably rectify the problem before continuing. 

While you are there, stop and examine the page showing in your browser window. It is packed with 
information regarding Tomcat, including documentation and the source code for numerous servlet and JSP 
examples. 


5.4.1.3.2 Upgrading your Java development environment 


In Java4308 °° , I showed you how to upgrade your Java development environment to include two jar files 
named 


e servlet.jar 
e server.jar 


Į also explained that only the first one may actually be required, but since they are both small, there is no 
harm in having both of them on your machine. 

I showed you how to create a batch file for compiling your servlet. The batch file that I provided includes 
these jar files on the classpath. This has the effect of making the following packages, among others, available 
to your compiler. This is a requirement for writing and compiling servlets and JSP. 


e javax.servlet 
e javax.servlet.http 
e javax.servlet.jsp 


You should make certain that you can successfully compile, deploy, and access the sample servlet that I 
provided in Java4308 % before continuing with this module. 


5.4.1.4 Discussion and sample code 


Before leaving this module, lets make absolutely certain that everything is working by creating, compiling, 
deploying, and accessing two servlets and one JSP. 

Using what you learned in Java4308 ° , create compile and deploy the two servlets shown in Listing 1 
(p. 2790) and Listing 2 (p. 2790) . Then create and deploy the JSP shown in Listing 3 (p. 2792) . 

Start your server and point your browser to http://localhost:8080/Inew2338 050 in order to see 
Image 2 (p. 2782) in your browser. 


) Inew2338_050 - Mozilla Firefox a) iol xj 


File Edit View History Bookmarks Tools Help 
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Hello Big Red World 
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} Inew2338_050 - Mozilla Firefox 


Linta 


Table 5.72 


Point your browser to http://localhost:8080/Inew2338 051 in order to see Image 3 (p. 2784) in 
your browser. 


Inew2338_051 - Mozilla Firefox 


(© ) @ locahost:3080/Inew2338_051 


Fi 
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Image 3 . Inew2338_051.java. 


} Inew2338_051 - Mozilla Firefox 


Hello Big Green World 


Table 5.73 


Point your browser to http://localhost:8080/Inew2338 _052.jsp in order to see Image 4 (p. 2788) 
in your browser. 
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Image 4 . Inew2338 052. jsp. 
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Table 5.74 


5.4.1.5 What’s next? 


Tf those tests were successful, your system is ready for you to move on to the next module and begin learning 
the programming details required to create Java servlets. 


5.4.1.6 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4530: Getting Started with Servlets 
e File: Java4530.htm 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


e Published: 12/19/13 
e Revised 09/04/15 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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5.4.1.7 Complete program listings 


Listing 1 . Inew2338_ 050.java. 


/*File Inew2338_050. java, 
Copyright 2004, R.G.Baldwin 


The servlet produces the following text in the 
browser window in large red letters. 


Hello Big Red World 

FE IG I IG I IGA EE EEEE A KK EEEE 21 21 EE 2k 2k ak kak // 
import java.io.*; 

import javax.servlet.*; 

import javax.servlet.http.*; 


public class Inew2338_050 extends HttpServlet{ 
public void doGet (HttpServletRequest req, 
HttpServletResponse res) 
throws ServletException, 
IOException{ 


res.setContentType("text/htm1") ; 
PrintWriter out = res.getWriter(); 


out.printin("<HTML>") ; 
out .print1n( 


" <HEAD> <TITLE>Inew2338_050</TITLE></HEAD>") ; 


out .println ("<BODY>"); 


out.println("<h1 align=\"center\">" 

+"<font color=\"#FF0000\">"); 
out.println("Hello Big Red World"); 
out .println("</font></h1>"); 


out .println("</BODY></HTML>"); 
}//end doGet () 
}//end class Inew2338_050 


Table 5.75 


Listing 2 . Inew2338_ 051.java. 


continued on next page 
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/*File Inew2338_051.java 
Copyright 2004, R.G.Baldwin 


The servlet produces the following text in the 
browser window in large green letters. 


Hello Big Green World 

FE AG OA I IOI I IOI AI I I ICI I EEEE EEEE E 2k 2k 2k kak / 
import java.io.*; 

import javax.servlet.*; 

import javax.servlet.http.*; 


public class Inew2338_051 extends HttpServlet{ 
public void doGet (HttpServletRequest req, 
HttpServletResponse res) 
throws ServletException, 
IOException{ 


res.setContentType("text/htm1") ; 
PrintWriter out = res.getWriter(); 


out.printin("<HTML>") ; 
out .printl1n( 

" <HEAD> <TITLE>Inew2338_051</TITLE></HEAD>") ; 
out .printin("<BODY>") ; 


out .printin("<h1 align=\"center\">" 

+"<font color=\"#00FFO0\">") ; 
out.println("Hello Big Green World"); 
out .printin("</font></h1>"); 


out .printin("</BODY></HTML>") ; 
}//end doGet () 
}//end class Inew2338_051 


Table 5.76 
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Listing 3 . Inew2338_052.jsp. 


<!--File Inew2338_052.jsp --> 


<html> 
<title>My title</title> 
<body> 
<H1>My JSP Page</H1> 
<H2>Hello, JSP world! </H2> 


<% for (int i=0; i<6; i++) { %> 
<br> 
<%= i 4> 

<% }//end for loop %> 


<H3>Isn’t this fun</H3> 


</body> 
</html> 


-end- 


Table 5.77 
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5.4.2 Java4530r-Review’” 
5.4.2.1 Table of Contents 


e Preface (p. 2793) 
e Questions (p. 2793) 


1 (p. 2793) , 2 (p. 2793) 


e Answers (p. 2795) 
e Miscellaneous (p. 2795) 


5.4.2.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4530: Getting Started 
with Servlets °” in the Servlets sub-collection. 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


5.4.2.3 Questions 
5.4.2.3.1 Question 1 


True or False? 

Assuming that you have properly installed the Tomcat web server on your local machine, you should be 
able to start the server and point your browser to http://localhost:80/ to see the Tomcat startup screen 
in your browser. 

Go to answer 1 (p. 2795) 


5.4.2.3.2 Question 2 


True or False? 
Including the following packages on your classpath is a requirement for writing and compiling servlets 
and JSP. 


e javax.servlet 
e javax.servlet.http 
e javax.servlet.jsp 


Go to answer 2 (p. 2795) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


°6This content is available online at <http://cnx.org/content /m49581/1.2/>. 
®Thttp://cnx.org/content /m48509/latest /?collection=col11441/latest 
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None 


Display your namet 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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5.4.2.4 Answers 
5.4.2.4.1 Answer 2 


True. 
Go back to Question 2 (p. 2793) 


5.4.2.4.2 Answer 1 


False. Assuming that you have properly installed the Tomcat web server on your local machine, you should 
be able to start the server and point your browser to http://localhost:8080/ to see the Tomcat startup 
screen in your browser. (Note the port number.) 

Go back to Question 1 (p. 2793) 


5.4.2.5 Miscellaneous 


This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Java4530r-Review 
e File: Java4530r.htm 

e Published: 03/10/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


5.4.3 Java4535: Introduction to Servlet Code” 
5.4.3.1 Table of Contents 
e Preface (p. 2796) 


Viewing tip (p. 2796) 


x Images (p. 2796) 
x Listings (p. 2796) 


°8This content is available online at <http://cnx.org/content /m48518/1.3/>. 
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General background information (p. 2796) 
Discussion and sample code (p. 2797) 


The program named Servlet01.java (p. 2797) 
Interesting code fragments (p. 2798) 
But wait, there’s more (p. 2802) 


What’s next? (p. 2805) 
Miscellaneous (p. 2805) 
e Complete program listing (p. 2807) 


5.4.3.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. 


5.4.3.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


5.4.3.2.1.1 Images 


e Image 1 (p. 2798) . Output from Servlet01.java. 


5.4.3.2.1.2 Listings 


Listing 1 (p. 2799) . Import directives. 
Listing 2 (p. 2799) . Beginning of the class definition. 
Listing 3 (p. 2799) . Beginning of the overridden doGet method. 


Listing 5 (p. 2801) . Construct and return an HTML file. 


) 
( ) 
( ) 
Listing 4 (p. 2800) . Preparing to return a response. 
( ) 
Listing 6 (p. 2807) . ServletO1.java. 


5.4.3.3 General background information 


Servlets are modules that run inside request/response-oriented servers, such as Java-enabled web servers, 
and extend them in some manner. For example, a servlet might be responsible for taking data in an HTML 
order-entry form and applying the business logic used to update a company’s order database. 

Servlets are to servers what applets are to browsers. The Servlet API, which you use to write servlets, 
assumes nothing about how a servlet is loaded, the server environment in which the servlet runs, or the 
protocol used to transmit data to and from the user. This allows servlets to be embedded in many different 
web servers. 

Servlets are an effective substitute for CGI scripts. They provide a way to generate dynamic documents 
that is both easier to write and faster to run. They also address the problem of doing server-side programming 
with platform-specific APIs. 

In some ways, a servlet is similar to an applet. An applet is a chunk of Java code that executes under 
control of a browser. A servlet is a chunk of Java code that executes under control of a server program. 

You must run your servlet under the control of a Java-enabled server program. The first few modules in 
this sub-collection will use the Apache Tomcat °° server for that purpose. 

Please note that the use of servlets is not restricted to HTTP servers. However, the discussion in this 
lesson and most of the follow-on modules will generally apply only to HTTP servers. 


°*http://cnx.org/content /m48488 /latest /?collection=coll1441/latest 
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5.4.3.4 Discussion and sample code 
5.4.3.4.1 The program named Servlet01.java 


In this module, I will discuss servlets using a sample servlet program named ServletO1.java as a guide. 
A complete listing of the program is shown in Listing 6 (p. 2807) . 

This program will illustrate some, but not all of material that I will discuss in this module. The purpose 
of this program is to illustrate a very simple servlet and to serve as a vehicle for discussion of various aspects 
of servlets. 

The servlet produces the screen output in the browser shown in Image 1 (p. 2798) . 


) Serviet01 - Mozilla Firefox 


) Serviet01 - Mozilla Firefox 


B-cel t f 


( €& | @ localhost:3080/Serviet01 


@ Share Browser WebEx~ 


Hello Big Red World 
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' e @ localhost:3080/Serviet01 


Image 1 . Output from Servlet01.java. 


Serviet01 - Mozilla Firefox 


Hello Big Red World 


Table 5.78 


5.4.3.4.2 Interesting code fragments 


Import directives 
I will explain the program code in fragments. The first fragment in Listing 1 (p. 2799) shows the import 
directives necessary to support servlet programming. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2793 


Listing 1 . Import directives. 


import java.io.*; 
import javax.servlet.*; 
import javax.servlet.http.*; 


Table 5.79 


The Servlet interface 

All servlets must implement the Servlet interface. You can implement it directly. However, it is 
more common to implement it indirectly by extending a class that implements the interface (such as 
HttpServlet ). 

The Servlet interface declares methods for managing the servlet and its communications with clients. 
You will need to override some or all of those methods when you write your servlet. 

Listing 2 (p. 2799) shows the beginning of the controlling class for the servlet. Note that the servlet 
class extends HttpServlet . By extending the HttpServlet class, the servlet implements the Servlet 
interface indirectly. 


Listing 2 . Beginning of the class definition. 


public class Servlet01 extends HttpServletf{ 


Table 5.80 


Request and response objects 
Two object references are passed to a servlet when it called by a client: 


e ServletRequest - encapsulates the communication from the client to the server. 
e ServletResponse - encapsulates the communication from the servlet back to the client. 


Access to these objects can be accomplished in more than one way. This servlet overrides the doGet 
method, which receives references to the two objects as incoming parameters. 

The overridden doGet method 

The beginning of the overridden doGet method is shown in Listing 3 (p. 2799) . 


Listing 3 . Beginning of the overridden doGet method. 


public void doGet (HttpServletRequest req, 
HttpServletResponse res) 
throws ServletException, I0Exceptionf{ 


Table 5.81 
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Note that the doGet method throws an exception of type ServletException . In this servlet, some 
of the code inside the doGet method also throws an IOException , which is not handled inside the 
method. Thus, it is declared in the method signature. 

Browser commands and servlet methods 

A Java-enabled server provide a method corresponding to each of the commands that an HTTP client 
can send to its server. When the server receives a command from the client, the corresponding method is 
called on the servlet. 

As the servlet programmer, you override some or all of those methods to provide the desired behavior. 

The doGet method and the HTTP GET command 

The doGet method corresponds to the HTTP GET command. If you don’t override the method, 
the default implementation reports an HTTP BAD REQUEST error when the browser sends a GET 
command. 

Overriding the doGet method to support the GET command also automatically supports the HTTP 

HEAD command. 
(The HEAD  commandisa GET command that returns no body in the response. It just 
returns the requested header fields.) 

The fundamental purpose of the GET command makes it possible for the client to get something 
from the server. When you override the doGet method, you should 


3 


Read data from the request 
Construct the proper headers in the response 
Gain access to either the writer or the output stream (depending on whether the material to be 
returned is text or binary data) 
e Write the response data 


Responding to the request 

The headers should include content type and encoding. The content type must be set before the writer 
is accessed. 

This servlet constructs and returns a simple HTML file containing formatted text. Listing 4 (p. 2800) 
shows the use of setContentType method of the response object to set the content type being returned 
before accessing the writer. Then the getWriter method of the response object is used to get access to 
the output stream. 


Listing 4 . Preparing to return a response. 


res.setContentType("text/html1") ; 
PrintWriter out = res.getWriter() 


Table 5.82 


You will need to do some research on your own to learn about the different content types that can be 
returned by a servlet. 

The PrintWriter object referred to by out is used to construct output text in Listing 5 (p. 2801) . 

Construct and return an HTML file 

That brings us to the fragment in Listing 5 (p. 2801) , which constructs and returns the various elements 
of an HTML page and then terminates the doGet method. 
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Listing 5 . Construct and return an HTML file. 


out.printin("<html>") ; 
out.println("<head><title>Servlet01</title></head>") ; 
out .printin("<body>") ; 


out.printin("<hi align=\"center\">" 
+"<font color=\"#FFO000\">") ; 

out.println("Hello Big Red World"); 

out .printin("</font></h1>"); 


out .printin("</body></html>") ; 
3//end doGet () 
}//end class Servlet01 


Table 5.83 


Constructing the HTML code 

The code in Listing 5 (p. 2801) constructs a series of String objects and passes them as parameters 
to the println method of the PrintWriter object referred to by out . The content of the String 
objects is raw HTML code. 


A tedious process: Constructing raw HTML code as a series of Java String objects can be 
a very tedious and error-prone process, due particularly to the frequent need to use the backslash 
escape character for quotation marks inside the strings. (All attribute values in HTML must be 
surrounded by quotation marks.) 


This is one of the arguments for the use of JSP that you learned about in the prerequisite course 
100 |. One of the benefits of JSP is that it can greatly reduce the amount of raw HTML code that 
you must construct to send back a typical HTML web page. 


If you have written any raw HTML code, you will probably recognize the construction of the HTML code 
in Listing 5 (p. 2801) (and you may also recognize the HTML code as being vintage 1999 when the servlet 
program was written) . 

If you haven’t written any HTML, you will need to do a little research on your own to learn about the 
various parts of an HTML page. At this level, it is fairly simple. 


(An HTML element often consists of text content surrounded by opening and closing tags of a 
particular type. Elements can also be nested inside of other elements creating a hierarchical tree 
of elements.) 


The content between the opening and closing body tags in Listing 5 (p. 2801) represents the real 
information content of the page. The rest is mostly formatting information. 
This body content in Listing 5 (p. 2801) says to 


e Set the text to style hl (which is a maximum size header). 

e Center it on the page. 

e Set the color to hexadecimal FF0000, which is the color value for pure red (in a red, green, blue color 
system) . 
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Most (but not all) HTML elements, such as the body element, require an opening tag and a closing tag. 
Thus, most tag types come in pairs. 

An HTML page is pure text with the various elements specifying how the browser is to interpret and 
display that text. (The text can also refer to other files such as image files and cause the content of those 
files to be included in the rendered output produced by the browser.) 

The Java code in this servlet simply prints the requisite HTML text to the output stream referred to by 
out . Recall from Listing 4 (p. 2800) that the reference to the output stream was obtained by calling the 
get Writer method on the HttpServerResponse object. That object takes care of transporting the 

text back to the client browser. 


5.4.3.4.3 But wait, there’s more 


Usually in most modules, when I complete the discussion of the last sample program, that is the end of 
the module. In this module, however, there are several other important topics that I want to discuss before 
ending the module. 

The ServletRequest object 

One of the incoming objects to the servlet is of type ServletRequest . This is not the name of a 
class. Instead, this is a type defined by an interface of the same name. This interface declares more than 30 
methods by which the servlet can extract incoming information from the object. This framework provides 
the servlet’s only access to incoming data. 

The data provided by the ServletRequest o object includes parameter names and values, attributes, 
and an input stream. 

Interfaces that extend ServletRequest can provide additional protocol-specific data. For example, 
HTTP data is provided by the interface HttpServletRequest , which extends ServletRequest 
(Recall from Listing 3 (p. 2799) t that the doGet method receives a reference to an HttpServlet Request 
object as an incoming parameter.) 

Suffice it to say that it is possible for the servlet to obtain a great deal of information in order to carry 
out its duties. (I will refer you to the online documentation 1°! for more information about the available 
methods.) 

The ServletResponse object 

The other incoming object to the servlet is an object of type ServletResponse . This is also a type 
defined by an interface of the same name. This interface declares more than 15 methods by which the servlet 
can return data to the client. 

The content type 

Recall that Listing 4 (p. 2800) calls the setContentType m method on the response object to set 
the type of the data being returned by this servlet to "text/html". It is also possible to set the character 
encoding in a call to setContentType with something like 

text /html;charset=U TF-8 

The rules for doing that are fairly complicated, so you would do well to consult the Java documentation 
for the setContentType method before trying to deal with that possibility. 

Persistence 

We have discussed the classes and interfaces that make up a basic Servlet. HTTP servlets have additional 
objects that provide session-tracking capabilities. The servlet writer can use these APIs to maintain state 
between the servlet and the client that persists across multiple connections during some time period. 

The servlet life cycle 

Servlets have a prescribed life cycle. Servers load and run servlets. Servers accept requests from clients, 
and may use their servlets to return data to the clients. 

Servers can also remove servlets. So, the stages of a servlet’s life cycle are: 


e The servlet is loaded and initialized. 
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e The servlet is used to satisfy client requests. 
e The servlet is removed or unloaded. 


A server runs the servlet’s init method when it loads the servlet. Most servlets are run in multi-threaded 
servers. However, there are no concurrency issues during servlet initialization. The server calls the init 
method when it loads the servlet, and does not call it again unless it is reloading the servlet. 

The server cannot reload a servlet until after it has removed the servlet by calling the destroy method. 
Initialization is allowed to complete before client requests are handled or the servlet is destroyed. 

A practical problem 

This can be a problem when you are developing a servlet and repeatedly testing it with a server. Once 
the servlet is initially loaded from the class file, for some servers simply providing a new class file does not 
cause the server to remove the old version of the servlet and load the new version. (This appears to be the 
case with the Apache Tomcat 1°? server that we will be using for some of these modules.) 

With the Apache Tomcat 1°? server , you must stop and restart the server to cause it to load the new 
version of a servlet. (It may be possible to use some feature of the administration tool to force the server 
to remove an old version and load a new version of a servlet without stopping and restarting the server but 
I have never investigated that possibility.) 

The second stage 

The second stage in the life of the servlet begins after the servlet has been loaded and initialized. At that 
point, the server may call upon the servlet to respond to client requests. In so doing, the servlet handles 
client requests by processing them in its service method, which is called by the server. Normally, the 
service request from each client is run in a separate thread by the servlet. 

Generic versus HTTP servlets 

If you are writing a generic servlet, you will probably override the service method. However, if you 
are writing servlets to be used with HTTP servers, you probably won’t need to override service . The 
service method of the HttpServlet class handles the setup and dispatches the request to methods such 
as doGet and doPost . When writing HTTP servlets, you will normally extend the HttpServlet 
class and override the doX XX methods instead of overriding the service method. 

Multithreaded operation 

Servlets can process requests from multiple clients concurrently in a multithreaded manner. This means 
that the service methods should be written to be thread safe. One description that I have seen for how to 
write a thread-safe method is to: 


Use the fewest possible number of instance variables, and synchronize access to them if you use 
them. 


Single-threaded operation 

In some cases and for some reason known only to you, you may decide to prevent your servlet from 
processing concurrent client requests. In this case, you should cause your servlet to implement the Sin- 
gleThreadModel interface. This interface guarantees that no two threads will execute the servlet’s service 
methods concurrently. Implementing the interface does not require writing any extra methods. Merely 
declaring that the servlet implements the interface is sufficient to prevent the server from making concurrent 
calls to the service method. 


(This may not make you popular with the server administrator because it could cause your 
single-threaded servlet to become a bottleneck.) 


The third stage 
The third and last stage of a servlet’s life cycle is removal. When a server removes a servlet, it runs 
the servlet’s destroy method. This method is run only once. The server will not run it again until after 
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it reloads and reinitializes the servlet. When the destroy method runs, other threads might be running 
service requests. If it is necessary to access shared resources while doing cleanup, that access should be 
synchronized. 

The javax.servlet.Servlet interface 

Servlets must implement the javax.servlet.Servlet interface. For writing servlets that run under 
control of servers that use the HTTP protocol, the most common way to write servlets is to extend the 
javax.servlet.http.HttpServlet class which is a way to indirectly implement the Servlet interface. 


The HttpServlet class implements the Servlet interface by extending the GenericServlet base 
class, and provides a framework for handling the HTTP protocol. 


Four methods 
For servlets that extend the HttpServlet class, the following four methods may be overridden to cause 
your servlet to interact with the client. 


doGet - for handling GET, conditional GET and HEAD requests 
doPost - for handling POST requests 

doPut - for handling PUT requests 

doDelete - for handling DELETE requests 


You may need to do some outside research on the HTTP protocol to learn about the nature of each type of 
client request listed above. You may also want to go back and review Java4350: Form Processing with JSP 
104 for information regarding the differences between the HTML GET and POST methods. 

By default, if called but not overridden, these methods return a BAD _ REQUEST (400) error. 

The servlet discussed earlier used the doGet method to handle GET requests. 

Differences between doGet and doPost 

I will describe a couple of differences between the two methods that you may find useful. Assume there 
is a servlet named Java4550a_ on a localhost web server. You can execute that servlet by typing the 
following address into the address field of the browser and pressing the Enter key 

http://localhost :8080 /Java4550a 

First consider the contents of the browser’s address window. When an HTML page calls the doGet 
method of a servlet named Java4550a_, you will often see something like the following in the address 
window: 

http: //localhost :8080 /Java4550a?firstName=Dick... 

As you can see, some information has been appended onto the end of the address with the ? character 
being used to separate the two. 

However, if the HTML page calls the doPost method of the same servlet, this is what you should see: 

http://localhost :8080 /Java4550a 


(Note that some browsers don’t display the http:// portion of the address.) 


In other words, with the doPost method, no visible information is appended onto the actual address as is 
the case with the doGet method. 
It is probably also safe to say that the doGet method is the default. By this, I mean that if you enter 
address given above (p. 2804) into the browser’s address field and press the Enter key, the doGet method 
(and not the doPost method) belonging to the servlet named Java4550a_ will be called. 


(The same is true if you put this address into a simple hyperlink when creating a web page.) 


If you want to manually enter an address into the address field and cause the doPost method to be called, 
you must find some other way to do it. 
Arguments 
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Each of the methods requires two arguments. The first, a reference to an HttpServletRequest object, 
encapsulates the data from the client. The second, a reference to an HttpServletResponse object 
encapsulates the response to the client. 

The HttpServletRequest object provides a large number of methods that the servlet can use to 
obtain information about the request. 

Similarly, the HttpServletResponse object provides a large number of methods that the servlet can 
use to return data to the client. 

The init and destroy methods 

You may also find that you need to override the init and destroy methods in your servlet. Recall 
that each of these methods is called only once. The init method is called when the server loads the servlet. 
class. The destroy method is called when the server removes the servlet. class. 

Overriding the init method 

The servlet should use the init method to prepare the resources it manages and to make the servlet ready 
to handle client requests. It can do this without regard for multi-threading issues because it is guaranteed 
that there is only a single thread running during initialization. If the init method is unable to run to a 
successful completion, it should throw an UnavailableException object. 

The init method receives a ServletConfig object as a parameter. For reasons that I won’t bother 
to discuss here, the overridden init method should call super.init and pass this configuration object as 
a parameter. If you are curious as to the reasons, you can look it up in the documentation. 

Overriding the destroy method 

Overriding the destroy method is more problematic, particularly if it is necessary to deal with resources 
that may be shared by service threads that are still running when the server decides to remove the servlet 
and call its destroy method. I’m going to punt on this one, and suggest that if you find yourself in this 
situation, you should find a good book with an example similar to your situation and use that example for 
guidance. 

The getServletInfo method 

Some applications may want to display information about a servlet, such as a short description of the 
purpose of the servlet, its author, and perhaps its version number. The Servlet API provides a method 
named getServletInfo to return this kind of information about the servlet. By default, this method 
returns null. You can override this method to return a String containing information about your servlet. 


5.4.3.5 What’s next? 


The next module in the series will take on forms and databases. 


5.4.3.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4535: Introduction to Servlet Code 
e File: Java4535.htm 

e Published: 12/20/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 
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In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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Listing 6 . Servlet01.java. 


/*File ServletO1.java, Copyright 1999, R.G.Baldwin 


The purpose of this program is to illustrate a very 
simple servlet. 


The servlet produces the following text in the browser 
window in large red letters. 


Hello Big Red World 

FE AG IO I IOI I IOI AICI I I I I I I A EEE EE 21 21 EE 4 2k 2k 2k 4 2k E a ak kak / 
import java.io.*; 

import javax.servlet.*; 

import javax.servlet.http.*; 


public class Servlet01 extends HttpServlet{ 
public void doGet (HttpServletRequest req, 
HttpServletResponse res) 

throws ServletException, I0Exceptionf{ 


//Establish the type of output 
res.setContentType("text/htm1") ; 


//Get an output stream 
PrintWriter out = res.getWriter(); 


//Construct an html page to return to the client 
out .printiln("<html>") ; 


out .printin("<head><title>Servlet01</title></head>") ; 


out .printin("<body>") ; 


out.printin("<hi align=\"center\">" 
+"<font color=\"#FFO000\">") ; 

out.println("Hello Big Red World"); 

out .printin("</font></h1>"); 


out .printin("</body></html>") ; 
3//end doGet () 
}//end class Servlet01 


Table 5.84 


-end- 
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5.4.4 Java4535r-Review 
5.4.4.1 Table of Contents 


e Preface (p. 2808) 

e Questions (p. 2808) 
1 (p. 2808) , 2 (p. 2808) , 3 (p. 2808) , 4 (p. 2808) , 5 (p. 2809) , 6 (p. 2809) , 7 (p. 2809) , 8 
(p. 2809) , 9 (p. 2809) , 10 (p. 2809) , 11 (p. 2810) , 12 (p. 2810) , 13 (p. 2810) , 14 (p. 2810) , 
15 (p. 2810) , 16 (p. 2810) , 17 (p. 2811) 

e Answers (p. 2812) 

e Miscellaneous (p. 2814) 


5.4.4.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4535: Introduction 
to Servlet Code 1 in the Servlets sub-collection. 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


5.4.4.3 Questions 
5.4.4.3.1 Question 1 


True or False? 

Servlets are programming modules that run inside request/response-oriented servers, such as Java- 
enabled web servers, and extend them in some manner. 

Go to answer 1 (p. 2814) 


5.4.4.3.2 Question 2 


True or False? 
You can run servlet programs on any server that supports the HTTP protocol. 
Go to answer 2 (p. 2814) 


5.4.4.3.3 Question 3 


True or False? 
The use of servlets is restricted to HTTP servers. 
Go to answer 3 (p. 2814) 


5.4.4.3.4 Question 4 
True or False? 


The following import directives, as a minimum, are necessary to support servlet programming: 


e import java.io.*; 
e import javax.servlet.*; 
e import javax.servlet.http.*; 


Go to answer 4 (p. 2814) 
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5.4.4.3.5 Question 5 


True or False? 

All servlets must implement the JavaServlet interface. You can implement it directly. However, it 
is more common to implement it indirectly by extending a class that implements the interface (such as 
HttpJavaServlet ). 

Go to answer 5 (p. 2814) 


5.4.4.3.6 Question 6 


True or False? 

The Servlet interface declares methods for managing the servlet and its communications with clients. 
You will need to override some or all of those methods when you write your servlet. 

Go to answer 6 (p. 2813) 


5.4.4.3.7 Question 7 


True or False? 
Object references of the following types are passed to a servlet when it called by a client: 


e JavaServletRequest - encapsulates the communication from the client to the server. 
e JavaServletResponse - encapsulates the communication from the servlet back to the client 


Go to answer 7 (p. 2813) 


5.4.4.3.8 Question 8 


True or False? 
For an HTTP servlet, the doGet method receives references to two objects of the following types as 
incoming parameters: 


e HttpServletRequest 
e HttpServletResponse 


Go to answer 8 (p. 2813) 


5.4.4.3.9 Question 9 


True or False? 

A Java-enabled server provide a method to support each of the commands that an HTTP client can send 
to its server. When the server receives a command from the client, the corresponding method is called on 
the servlet. 

As the servlet programmer, you override some or all of those methods to provide the desired behavior. 

Go to answer 9 (p. 2813) 


5.4.4.3.10 Question 10 


True or False? 

The doGet method corresponds to the HTTP POST command. If you don’t override the method, 
the default implementation reports an HTTP BAD REQUEST error when the browser sends a POST 
command. 

Go to answer 10 (p. 2813) 
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5.4.4.3.11 Question 11 


True or False? 

Overriding the doGet method to support the GET command also automatically supports the HTTP 
HEAD command. 

Go to answer 11 (p. 2813) 


5.4.4.3.12 Question 12 


True or False? 
The fundamental purpose of the GET command makes it possible for the client to get something 
from the server. When you override the doGet method, you should, as a minimum: 


Read data from the request 
Construct the proper headers in the response 
Gain access to either the writer or the output stream (depending on whether the material to be 
returned is text or binary data) 
e Write the response data 


Go to answer 12 (p. 2813) 


5.4.4.3.13 Question 13 


True or False? 

The headers that you create in your overridden doGet method should include content type and 
encoding. The content type must be set before the writer is accessed. The setContentType method of 
the response object can be called to set the content type. The getWriter method of the response object 
can be called to get access to the output stream. 

Go to answer 13 (p. 2813) 


5.4.4.3.14 Question 14 


True or False? 
The class definition for an HTTP servlet extends the JavaHttpServlet class. 
Go to answer 14 (p. 2813) 


5.4.4.3.15 Question 15 


True or False? 

Servlets typically process requests from multiple clients concurrently in a multithreaded manner. How- 
ever, it is possible to write servlets that are restricted to single-threaded operation by implementing the 
SingleThreadModel interface. 

Go to answer 15 (p. 2812) 


5.4.4.3.16 Question 16 


True or False? 

When writing a servlet for multi-threaded operation, you should use the fewest possible number of 
instance variables, and synchronize access to them if you use them. 

Go to answer 16 (p. 2812) 
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5.4.4.3.17 Question 17 


True or False? 
For servlets that extend the HttpServlet class, the following methods may be overridden to cause 
your servlet to interact with the client. 


doGet - for handling GET, conditional GET and HEAD requests 

doPost - for handling POST requests 

doPut - for handling PUT requests 

doDelete - for handling DELETE requests 

doTerminate - for terminating the servlet and returning control to the browser 


Go to answer 17 (p. 2812) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None 


Display your nami 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 


Put your name here 


5.4.4.4 Answers 
5.4.4.4.1 Answer 17 


False. 
For servlets that extend the HttpServlet class, the following four methods may be overridden to cause 
your servlet to interact with the client. 


doGet - for handling GET, conditional GET and HEAD requests 
doPost - for handling POST requests 

doPut - for handling PUT requests 

doDelete - for handling DELETE requests 


Go back to Question 17 (p. 2811) 


5.4.4.4.2 Answer 16 
True. 

Go back to Question 16 (p. 2810) 
5.4.4.4.3 Answer 15 


True. 
Go back to Question 15 (p. 2810) 
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5.4.4.4.4 Answer 14 
False. The class definition for an HTTP servlet extends the HttpServlet class. 
Go back to Question 14 (p. 2810) 
5.4.4.4.5 Answer 13 
True. 
Go back to Question 13 (p. 2810) 
5.4.4.4.6 Answer 12 
True. 
Go back to Question 12 (p. 2810) 
5.4.4.4.7 Answer 11 
True. 
Go back to Question 11 (p. 2810) 
5.4.4.4.8 Answer 10 
False. The doGet method corresponds to the HTTP GET command. If you don’t override the method, 
the default implementation reports an HTTP BAD REQUEST error when the browser sends a GET 
command. 
Go back to Question 10 (p. 2809) 
5.4.4.4.9 Answer 9 
True. 
Go back to Question 9 (p. 2809) 
5.4.4.4.10 Answer 8 
True. 
Go back to Question 8 (p. 2809) 
5.4.4.4.11 Answer 7 


False. 
Object references of the following types are passed to a servlet when it called by a client: 


e ServletRequest - encapsulates the communication from the client to the server. 
e ServletResponse - encapsulates the communication from the servlet back to the client. 


Go back to Question 7 (p. 2809) 


5.4.4.4.12 Answer 6 


True. 
Go back to Question 6 (p. 2809) 
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5.4.4.4.13 Answer 5 


False. All servlets must implement the Servlet interface. You can implement it directly. However, it is 
more common to implement it indirectly by extending a class that implements the interface (such as 
HttpServlet ). 

Go back to Question 5 (p. 2809) 


5.4.4.4.14 Answer 4 


True. 
Go back to Question 4 (p. 2808) 


5.4.4.4.15 Answer 3 


False. The use of servlets is not restricted to HTTP servers. 
Go back to Question 3 (p. 2808) 


5.4.4.4.16 Answer 2 


False. You must run your servlet under the control of a Java-enabled server program. Not all HTTP servers 
support Java servlets. 
Go back to Question 2 (p. 2808) 


5.4.4.4.17 Answer 1 


True. 
Go back to Question 1 (p. 2808) 


5.4.4.5 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4535r-Review 
e File: Java4535r.htm 

e Published: 03/10/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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5.4.5 Java4550: Session Tracking using Hidden Fields'” 
5.4.5.1 Table of Contents 
e Preface (p. 2815) 


Viewing tip (p. 2815) 


x Images (p. 2815) 
x Listings (p. 2815) 


e General background information (p. 2816) 
e Discussion and sample code (p. 2817) 
The servlet program (p. 2817) 


x Interesting code fragments (p. 2827) 
x Tedious and error prone (p. 2832) 


The JSP program (p. 2832) 
x Interesting code fragments (p. 2832) 


e Run the programs (p. 2835) 
e Miscellaneous (p. 2835) 
e Complete program listings (p. 2835) 


5.4.5.2 Preface 

This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. The purpose of this module is to explain session tracking using 
hidden fields, and to compare a servlet with a JSP to accomplish the same objective. 

5.4.5.2.1 Viewing tip 

I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 

5.4.5.2.1.1 Images 


e Image 1 (p. 2820) . The servlet user interface at startup. 
e Image 2 (p. 2824) . Browser display for Tom, Dick, and Harry. 
e Image 3 (p. 2826) . Hidden fields in the servlet output. 


5.4.5.2.1.2 Listings 


Listing 1 (p. 2827 
Listing 2 (p. 2828 


) . Beginning of the servlet class. 

( ) . Get and save the hidden values from the browser page. 
Listing 3 (p. 2829) . Get and save user input data. 

Listing 4 (p. 2829) . Begin constructing the HTML output data. 

Listing 5 (p. 2829) . Begin the HTML code for an HTML form. 

Listing 6 (p. 2830) . An input field and a submit button. 

Listing 7 (p. 2830) . Beginning of the list of names. 

Listing 8 (p. 2831) . Display the historical data and also save it on the browser. 
Listing 9 (p. 2831) . Display most recent value and also store it on the browser. 


107This content is available online at <http://cnx.org/content /m48550/1.3/>. 
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e Listing 10 (p. 2833) . Create basic web page structure. 

e Listing 11 (p. 2833) . A JSP scriptlet. 

e Listing 12 (p. 2834) . The body of the for loop. 

e Listing 13 (p. 2834) . Another scriptlet. 

e Listing 14 (p. 2834) . Another JSP expression tag. 

e Listing 15 (p. 2835) . Terminating scriptlet and HTML code. 

e Listing 16 (p. 2836) . The servlet program named Java4550a.java. 
e Listing 17 (p. 2837) . The JSP program named Java4550a.jsp. 


5.4.5.3 General background information 


A stateless protocol 

The HTTP protocol is a relatively simple request /response protocol that does not retain historical in- 
formation from one client request to the next. In other words, each request is a new start insofar as the 
HTTP server is concerned. (HTTP is sometimes referred to as a "stateless" protocol.) However, historical 
information can be very important. The maintenance of historical information is often referred to as "session 
tracking." 

Session tracking 

Session tracking is very important for many web applications including web commerce and web games. 
Therefore, this and the next several modules will show you some of the ways that you can accomplish session 
tracking using servlets and JSP. 

Web commerce 

Perhaps the most common example of the need for session tracking is with a web commerce application 
involving a shopping cart. The customer (client) downloads various pages from a vendor catalog, selecting 
items, and placing them in a shopping cart. At some point, the customer decides either to purchase the 
items or abandon the shopping trip. 

If the customer decides to purchase the items in the cart, the web application must have a record of all 
the items in the cart. Furthermore, that record must be associated with that particular customer so that 
the sale can be consummated. 

Insofar as the HTTP protocol is concerned, each time the customer views a different page in the catalog, 
all information regarding previously viewed pages is forgotten. The HTTP protocol doesn’t save state 
information regarding an ongoing session by that customer involving multiple pages. It is the responsibility 
of the application to track the session involving that client (customer) . 

In the case of the shopping cart application, it is also the responsibility of the application to keep track 
of the items in the cart associated with that customer. 

Session tracking using hidden fields 

There are several different ways to accomplish session tracking with a servlet. This module will illustrate 
one of those ways, which is commonly known as hidden fields . Other ways will be illustrated in future 
modules 

Some session tracking schemes maintain historical information over many user sessions on a website. 
Others schemes are more limited. The scheme that I will explain in this module is generally limited to one 
session consisting of multiple requests. 

This scheme is probably not useful for large scale web commerce. However, it might be useful for an 
online game where the user makes a move and then clicks a submit button. The computer needs to 
remember the entire history of the game, but needn’t necessarily remember the history if the user leaves the 
website by closing the browser page. 

A servlet and a JSP 

I will explain two different programs that accomplish the same purpose. One of the programs is a servlet. 
The other program is a JSP. You will see that the JSP version is physically easier to write than the servlet 
version. However, you probably need to understand the servlet version in order to understand the JSP 
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version. The two also differ in that the servlet is capable of determining the name of the server on which it 
is running but the JSP does not have that capability. 


5.4.5.4 Discussion and sample code 


I will discuss both programs in fragments. A complete listing of the servlet program named Java4550a.java 
is provided in Listing 16 (p. 2836) . A complete listing of the JSP program named Java4550a.jsp is 
provided in Listing 17 (p. 2837) . 


5.4.5.4.1 The servlet program 


The program output 
Each time the servlet is called by a browser, it creates and displays an HTML form on the browser screen 
similar to that shown in Image 1 (p. 2820) . 


[a] Javas550= x 
e > C ff |B local yy 
Enter a name and press the button 


Name: | 


Submit Name 


Your list of names is: 
Empty 
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[aj tavasssos x AE 
€¢ 2 C ff |B loclts+| = 


Enter a name and press the button 


Name: | 


Your list of names is: 
Empty 
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[A] Java4550= x : a 
E > C fi Dloaltsy) = 


Enter a name and press the button 


Name: | 


Your list of names is: 
Empty 
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Image 1 . The servlet user interface at startup. 


=| Hi 


[ai] Javag5502 x 


e > CA Dba = 


Enter a name and press the button 


Name: | 
Submit Name | 


Your list of names is: 


Empty 


Table 5.85 


The HTML form displays: 


e An input text field through which the client can submit a name 
e A submit button 
e A list of previously submitted names 


A new request 
Each time the user clicks the submit button, the contents of the Name field are sent to the server 


and the server views that as a new request. The server does not remember historical information from one 


request to the next. 
However, this servlet. provides a mechanism by which a historical list of Name values from a sequence 


of requests is saved and displayed in the area identified as Empty in Image 1 (p. 2820) . 
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Tom, Dick, and Harry 

For example, Image 2 (p. 2824) shows the browser display after the names Tom, Dick, and Harry have 
been sent to the server in three separate requests. (Note the list of names near the left-center of Image 2 
(p. 2824) .) The name Joe has been entered into the text field in Image 2 (p. 2824) but the user has not 
yet clicked the submit button to send it to the server. Therefore, that name does not appear on the list. 


[az] Javast5o0e X 


e > C ft (Blocalty?) = 


Enter a name and press the button 
Name: [ioe | 
Submit Name 


Your list of names is: 
Tom 
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[A] javagssos x 


e > Cf Bloat = 


Enter a name and press the button 
Name 


Your list of names is: 
Tom 
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[ai] javagssos x 


e > CA Dba = 


Enter a name and press the button 
Name 
Submit Name 


Your list of names is: 
Tom 
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Image 2 . Browser display for Tom, Dick, and Harry. 
=| X 


[a] Javas550= x 


e> C fi D localk £? = 


Enter a name and press the button 


Name: Į oe l 
Submit Name | 


Your list of names is: 
Tom 


Dick 


Harry 


Table 5.86 


The GET method 

In this servlet, requests are sent from the browser to the server using the GET method. (The POST 
method could also have been used.) Each time the browser makes a GET request of the server, an HTML 
form is created by the servlet and sent back to the browser. 

Hidden fields 

Hidden fields are added to the form each time it is created by the servlet. One hidden field contains 
the name submitted for that GET request. Other hidden fields contain each of the names submitted by 
each previous GET request during the current session. In other words, the hidden fields on each successive 
form match those of the previous form plus a new hidden field for the new name submitted with that GET 
request. 

Raw HTML code 
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Image 3 (p. 2826) shows the HTML code returned to the browser following the sending of Tom, Dick, 
and Harry to the server in three separate requests. The three hidden fields are shown at at the bottom. 


) Source of: http:/ /dell8700: 8080/Java4550a?firstName=Harry&item=Tomaiten | BEF q| 


= 


<head><title>Java4550a</title></head> 
<body> 


| <form method='"get' action="http://del18700:8080/Java4550a"> 


<p>Enter a name and press the button</p> 

<p>Name: <input type="text" name="firstName"/></p> 
<input type="submit" value="Submit Name"/> 
<p>Your list of names is:<br/> 

Tom<br/> 


| <input type="hidden” name="item”" value="Tom"> 


Dick<br/> 
<input type="hidden” name="item”" value="Dick"> 
Harry<br/> 


á <input type="hidden” name="item” value="Harry"> 
15 </form></body></html> 


Source of: htt //dell8700:808% 8080/Java4550a?firstame= Harry&item=Toma&ite... 


<head><title>Java4550a</title></head> 
<body> 


| <form method='"get' action="http://del18700:8080/Javad550a"> 


<p>Enter a name and press the button</p> 


©- <p>Name: <input type="text" name="firstName"/></p> 


<input type="submit" value="Submit Name"/> 
<p>Your list of names is:<br/> 
Tom<br/> 


| <input type="hidden” name="item”" value="Tom"> 


Dick<br/> 
<input type="hidden” name="item”" value="Dick"> 
Harry<br/> 


4 <input type="hidden” name="item” value="Harry"> 
© </form></body></html> 
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0:8080/Java4550a?firstame= Harryaitem=Tomiiite.. 


<head><title>Java4550a</title></head> 
<body> 
| <form method='"get' action="http://del18700:8080/Java4550a"> 
<p>Enter a name and press the button</p> 
<p>Name: <input type="text" name="firstName"/></p> 
<input type="submit" value="Submit Name"/> 


<p>Your list of names is:<br/> 
Tom<br/> 
<input type="hidden” name="item”" value="Tom"> 
Dick<br/> 
<input type="hidden” name="item”" value="Dick"> 
Harry<br/> 
4 <input type="hidden” name="item”" value="Harry"> 
15 </form></body></htm1l> 


p Image 3 - Hidden fields i in the servlet output. 


©) Source of: http: / del8700: :8080/Java4550a?firstName= Harrya aa Tomite E ol xj 


<head><title>Java4550a</title></head> 
©- <body> 
| <form method='"get' action="http: //de1l18700:8080/Java4550a"> 
<p>Enter a name and press the button</p> 
<p>Name: <input type="text" name="firstName"/></p> 
<input type="submit" value="Submit Name"/> 
© <p>Your list of names is:<br/> 
Tom<br/> 
| <input type="hidden” name="item”" value="Tom"> 
Dick<br/> 
<input type="hidden” name="item”" value="Dick"> 
Harry<br/> 
\4 <input type="hidden" name="item" value="Harry"> 
15 </form></body></htm1l> 
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Table 5.87 


The term dell8700 on the fourth line of Image 3 (p. 2826) is the name of the computer on which the 
server that serviced the request was running. 
If the user enters another name into the text field and clicks the submit button 


The new name will be sent to the servlet. 

This historical data will also be sent to the servlet. 
The new name will be appended onto the list. 

The new list will be sent back to the browser. 


Save historical data in an HTML form 

With this approach, the historical data is saved by embedding it in the new HTML form that is returned 
to the browser. There is no requirement to save the historical data in a database or in the server’s file system. 
Note however, that the data will be lost if the user shuts down the browser or shuts down the computer. 
However, because of the browser cache, it is sometimes possible for the user to navigate to other web sites 
and then return to the same web page using the Back button and find that the historical data is still there. 

Simple, reliable, and easy to implement 

This approach has been used by web programmers for many years in those cases where it will get the 
job done. The approach is reliable and easy to implement. It places no special requirements on the server 
software (other than the ability to support Java servlets) and it is compatible with all browsers that support 
HTML forms. 


5.4.5.4.1.1 Interesting code fragments 


The doGet method 
The code in Listing 1 (p. 2827) shows the beginning of the controlling class and the beginning of the 
doGet method for the servlet. 


Listing 1 . Beginning of the servlet class. 


import java.io.*; 
import javax.servlet.*; 
import javax.servlet.http.*; 
import java.net.*; 


public class Java4550a extends HttpServletf{ 
public void doGet (HttpServletRequest req, 
HttpServletResponse res) 

throws ServletException, I0Exceptionf{ 


//Get and display name of localhost 

InetAddress inetAddress = InetAddress.getLocalHost () ; 
String hostName = inetAddress.getHostName() ; 

System. out.println(hostName) ; 


Table 5.88 


The name of the server 
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Without getting into the details as to why, I will tell you that the last three lines of code in Listing 1 
(p. 2827) , (in conjunction with the import directive for java.net.* ) cause the name of the computer 
on which the server is running to be saved in the variable named hostName and to be displayed on the 
Tomcat server console. You should have learned enough about the class named InetAddress earlier in 
this course to understand what is going on here without further explanation. 

This is very important information for students enrolled in this course because this or something like it 
will be required for many of the programming assignments. 

Two incoming parameters 

Recall from previous modules that the doGet method receives two parameters. One parameter named 

req is a reference to an object of the interface type HttpServletRequest that contains all of the 

information sent by the browser when the request was made. The other parameter named res is a 
reference to an object of the interface type HttpServletResponse that collects output information and 
sends it back to the browser. 

Both of those objects contain numerous methods that can be used to access incoming information ( req 
) or to send information back to the browser ( res ) . We will see several of those methods being used 
shortly. 


A bit of technical trivia: HttpServletRequest and HttpServletResponse are 
interfaces, not classes. In general, we don’t know the names of the classes from which the objects 
referred to by the incoming parameters were instantiated. And, we don’t really care because we 
only plan to call methods on those objects that are declared in the interfaces that the objects 
implement. 


However, just as a matter of technical trivia, it appears that those classes have the following names 
on my system: 


org.apache.catalina.connector.RequestFacade 
org.apache. catalina. connector.ResponseFacade 


Multiple fields with the same name 

An HTML form can have multiple fields with the same name. As you saw in Image 3 (p. 2826) , the 
hidden fields are all named item . The code in Listing 2 (p. 2828) calls the getParameter Values 
method on the request object to get the values stored in all of the hidden fields named item . 


Listing 2 . Get and save the hidden values from the browser page. 


String[] items = req.getParameterValues("item") ; 


Table 5.89 


The getParameterValues method receives the field name item asa String parameter and 
returns an array of String objects, containing all of the values with matching names contained in the 
request object, or null if the field name does not exist. 

Those values are saved in the String array named items shown in Listing 2 (p. 2828) . As you will 
see later, this is data that was saved from previous requests. 

Get and save user input data 

Listing 3 (p. 2829) calls the getParameter method on the request object to get and save the value 
submitted by the browser in the field named firstName . (Seethe input element on the sixth line 
in Image 3 (p. 2826) .) This is also the text field shown in Image 2 (p. 2824) . 
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Listing 3 . Get and save user input data. 


String name = req.getParameter ("firstName"); 


Table 5.90 


The getParameter method receives the name of a request parameter and returns the value cor- 
responding to that request parameter as a String , or null if the parameter does not exist. (Recall that 
the data is transmitted to the server as name::value pairs.) 

Begin constructing the HTML output data 

At this point in the process, all of the incoming data has been saved in a variable named name and an 
array named items . The time has come to construct the raw HTML code and send it back to the client. 
Listing 4 (p. 2829) begins that process by 


e Telling the browser how to interpret the data ("text/html"). 
e Getting on output stream on the response object on which to print the output data. 
e Constructing the first few lines of HTML text. 


Listing 4 . Begin constructing the HTML output data. 


//Establish the type of output 
res.setContentType("text/htm1") ; 


//Get an output stream 
PrintWriter out = res.getWriter(); 


//Construct an html form and send it back to the client 
out.printin("<html>") ; 
out.println("<head><title>Java4550a</title></head>") ; 
out .printin("<body>") ; 


Table 5.91 


Create raw HTML code for the form 
Listing 5 (p. 2829) begins the construction of the HTML form that is to be returned to the browser. This 
code creates the first in a series of HTML statements necessary to support the input field and the submit 
button. (You may need to refer to earlier modules that discussed the format of an HTML form in order to 
understand the next few fragments. ) 


Listing 5 . Begin the HTML code for an HTML form. 


continued on next page 
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out.println("<form method=’get’ action=" 
+ "\"http://" + hostName + ":8080/Java4550a\">") ; 


Table 5.92 


The code in Listing 5 (p. 2829) uses the name of the computer on which the server is running ( 
hostName_ ) that was obtained and saved earlier to construct the action element of the HTML form. 
This causes the servlet to be suitable for running in a server on an computer with any name. It also makes 
it possible to access the servlet from other computers on the local area network provided those computers 
know the name of the computer on which the server is running. 

Once again, this is very important information for students enrolled in this course. 

This code produced the term dell8700 in Image 3 (p. 2826) because the server was running on a 
computer named dell8700 when the screen shot was taken. 

This fragment results in HTML code that causes a GET request to be sent to the HTTP server 
containing field data as a parameter whenever the user presses the submit button 

The input field and the submit button 

Listing 7 (p. 2830) places a line of instructional text on the browser screen. 

It also creates the HTML code necessary to place an input field anda submit button on the form that 
will be displayed on the screen as shown in Image 1 (p. 2820) . 


Listing 6 . An input field and a submit button. 


out.println("<p>Enter a name and press the button</p>"); 
out .printin("<p>Name: <input type=\"text\" name=" 
+ "\"firstName\"/></p>") ; 
out .printin("<input type=\"submit\" value=" 
+ "\"Submit Name\"/>") 


Table 5.93 


The list of names 
Listing 7 (p. 2830) provides a line of introductory text for the list of names to be displayed on the screen. 
The first time the form appears on the screen, the value stored in the name variable is null, and the word 
Empty is displayed as shown in Image 1 (p. 2820) . Later on after multiple requests, the list will be 
populated as shown in Image 2 (p. 2824) . 


Listing 7 . Beginning of the list of names. 


out.println("<p>Your list of names is:<br/>"); 
if (name == null){ 
out .println("Empty</p>"); 
}//end if 


Table 5.94 
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Create new hidden fields for historical data 

Listing 2 (p. 2828) retrieved all of the data in the hidden fields on the form and saved that data in a 
String array named items 

If that array contains data, the code in Listing 8 (p. 2831) performs two actions using the data from 
each of the elements in the array: 


e Display the historical data stored in those element of the array. 
e Create new hidden fields in the HTML output form under construction and place the data values from 
the array in those hidden fields. 


Listing 8 . Display the historical data and also save it on the browser. 


if(items != null){ 

for(int i = 0; i < items.length; i++){ 
//Display names previously saved in hidden fields 
out.printin(items[i] + "<br/>"); 
//Save the names in hidden fields on form currently 
// under construction. 
out.printin("<input type=\"hidden\" name=\"item\" " 

+ "value=\"" + items [i] + mS") 5 
}//end for loop 
}//end if 


Table 5.95 


Limited persistence 

Thus, the historical data is passed forward from the hidden fields of one HTML form to the hidden fields 
of the next HTML form. All of the historical data resides on the HTML form in the browser cache in the 
client computer. However, that is not a location that provides long-term persistence, so this scheme for 
session tracking has limited persistence. 

Create new hidden field for new data 

Listing 3 (p. 2829) retrieved the field value submitted by the browser and saved that value in a variable 
named name 

If that variable contains data, the fragment in Listing 9 (p. 2831) performs two actions using the data 
stored in the variable. 


e Display the value at the end of the list of names. 


e Create a new hidden field in the HTML output form under construction and place the value from the 
variable in that hidden field. 
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Listing 9 . Display most recent value and also store it on the browser. 


if(name != null){ 
//Display name submitted with current GET request 
out.printin(name + "<br/>"); 
//Save name submitted with current GET request in a 
// hidden field on the form currently under 
// construction 
out.println("<input type=\"hidden\" name=\"item\" " 
$ "yalue=\"" + name + "nisije 
}//end if 


Table 5.96 


Thus, for each new request by the browser, one additional hidden field is added to the HTML form under 
construction. The new hidden field contains the field value submitted by the browser. 

The remaining servlet code 

The remainder of the code for the servlet is typical of what you have seen before and can be viewed in 
the complete listing of the servlet in Listing 16 (p. 2836) . 


5.4.5.4.1.2 Tedious and error prone 


Writing raw HTML code is not fun even under the best of circumstances. That is why I use a WYSIWYG 
HTML editor for authoring these modules. 

Even for this very simple servlet, the process of constructing the output HTML code using Java println 
statements was very tedious and error prone. Much of the difficulty arises from the fact that Java strings 
must be enclosed in matching double quotes and all HTML attribute values must also be enclosed in matching 
double or single quotes. As you can see from Listing 16 (p. 2836) , the requirement to escape double quotes 
inside Java strings with the backslash character can lead to some very confusing code. (I suppose it might 
be less confusing if I were to use single quotes instead of double quotes on HTML attribute values. I will try 
that in the next module.) 

In any event, the next section presents a JSP version of the same servlet. JSP intermingles HTML code 
with Java code and greatly reduces the amount of HTML code that must be constructed using Java println 
statements in a servlet. If you are unfamiliar with JSP, you can learn about it in the modules that begin at 
Java4305: Preface to JSP 1% . 


5.4.5.4.2 The JSP program 


A complete listing of the JSP version of this program is provided in Listing 17 (p. 2837) . I found this 
JSP version much easier to write than the servlet version discussed above. Admittedly, however, I wrote the 
servlet version first, so that probably helped to make it easier to write the JSP version. 

I wrote all of the HTML code using Microsoft Expression Web 4, which provides both a WYSIWYG 
capability and a raw HTML editing capability. Once I confirmed that the HTML code was correct and valid, 
I went, back and inserted the JSP tags containing the Java code. 

As mentioned earlier, the JSP does not get and use the name of the computer on which it is running. 
Instead it uses the generic name localhost, which limits the ability to access the JSP from another computer 
on the network. 
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Once again, I will discuss this program in fragments. A complete listing of the program is provided in Listing 


17 (p. 2837) . 


Create basic web page structure 


Listing 10 (p. 2833) shows the HTML code that is roughly equivalent to the Java code in Listing 4 (p. 
2829) through Listing 7 (p. 2830) . This code creates the HTML header and the basic structure of the web 


page shown in Image 1 (p. 2820) . 


Listing 10 . Create basic web page structure. 


<html> 
<head><title>Java4550a</title></head> 
<body> 


<form method="get" action="http://localhost:8080/Java4550a. jsp"> 
<p>Enter a name and press the button</p> 

<p>Name: <input type="text" name="firstName"/></p> 

<input type="submit" value="Submit Name"/> 

<p>Your list of names is:<br/> 


Table 5.97 


A JSP scriptlet 


Listing 11 (p. 2833) is a scriptlet containing pure Java code. It begins by getting the data from the 
request object. Then it deals with the situation where nothing has been entered into the text field in Image 
1 (p. 2820) , reporting that the list is empty. It ends with the beginning of a for loop that is executed 
when the array is not empty. Recall that in JSP, Java code blocks can begin in one scriptlet and end in 


another scriptlet later in the page. That is what is happening here. 


Listing 11 . A JSP scriptlet. 


<h 
String[] items = request.getParameterValues ("item"); 
response. setContentType ("text/html") ; 


String name = request .getParameter ("firstName"); 
if (name == null){ 

out.println("Empty") ; 
}//end if 


if(items != null){ 
for(int i = 0; i < items.length; i++){ 
h> 


Table 5.98 
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The body of the for loop 

Listing 12 (p. 2834) contains the body of the for loop that began in Listing 11 (p. 2833) . This is a 
combination of a JSP expression tag and raw HTML code to display the new value and also to create and 
populate a hidden field in the output. 


Listing 12 . The body of the for loop. 


<%= items[i] %> <br/> 
<input type="hidden" name="item" value="</=items[i]%>"/> 


Table 5.99 


Another scriptlet 

Listing 13 (p. 2834) is another scriptlet containing pure Java code. This scriptlet terminates the for 
loop and the if statement that began in Listing 11 (p. 2833) . It also begins anew if statement to display 
the new input value and also to create and populate the last hidden field containing the newly received input 
value. 


Listing 13 . Another scriptlet. 


<% 
}//end for loop 
}//end if 


if(mame != null){ 
4> 


Table 5.100 


Another JSP expression tag 
Listing 14 (p. 2834) contains another JSP expression tag that displays the new input value. Listing 14 
(p. 2834) also creates and populates the last hidden field with the new input value. 


Listing 14 . Another JSP expression tag. 


<%= name %> <br/> 
<input type="hidden" name="item" value="<%=name%>"/> 


Table 5.101 


Terminating scriptlet and HTML code 
Finally, Listing 15 (p. 2835) shows a scriptlet containing a curly bracket to terminate the if statement 
that began in Listing 13 (p. 2834) along with raw HTML code to terminate the HTML page. 
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Listing 15 . Terminating scriptlet and HTML code. 


<% 
}//end if 
h> 
</p></form></body></htm1l> 


Table 5.102 


5.4.5.5 Run the programs 


I encourage you to copy the code from Listing 16 (p. 2836) and Listing 17 (p. 2837) Deploy the programs 
on your own server. Experiment with the code, making changes, and observing the results of your changes. 
Make certain that you can explain why your changes behave as they do. 


5.4.5.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4550: Session Tracking using Hidden Fields 
e File: Java4550.htm 

e Published: 12/22/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


5.4.5.7 Complete program listings 
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Listing 16 . The servlet program named Java4550a.java. 


/*File Java4550a.java, Copyright 1999, R.G.Baldwin 
Rev 01/04/14 

The purpose of this program is to illustrate session 
tracking through the use of hidden fields. 


Each time the submit button is pressed, this servlet 
creates a web page and sends it back to the browser. 
The new web page contains the historical data for the 
session in hidden fields in the web page. 

The following is a typical web page after the names 
Tom, Dick, and Harry have been entered.: 


The program also detects the name of the server that it 
is running on and uses that name to construct the action 
element of a form. In the output shown below, the 
servlet was running on a computer named del18700. 


<html> 

<head><title>Java4550a</title></head> 

<body> 

<form method="get" action="http://del18700 :8080/Java4550a" > 
<p>Enter a name and press the button</p> 

<p>Name: <input type="text" name="firstName"/></p> 
<input type="submit" value="Submit Name"/> 

<p>Your list of names is:<br/> 


Tom<br/> 

<input type="hidden" name="item" value="Tom"> 
Dick<br/> 

<input type="hidden" name="item" value="Dick"> 
Harry<br/> 


<input type="hidden" name="item" value="Harry"> 
</form></body></htm1> 


FE AG EEE EE EE EEEE E EEEE EE GI I I I EEE 4 21 21 EE 4 21 21 2k E EE E E EE EA 
import java.io.*; 

import javax.servlet.*; 

import javax.servlet.http.*; 

import java.net.*; 


public class Java4550a extends HttpServletf{ 
public void doGet (HttpServletRequest req, 
HttpServletResponse res) 

throws ServletException, I0Exceptionf{ 


//Get and display name of localhost 

InetAddress inetAddress = InetAddress.getLocalHost () ; 
String hostName = inetAddress.getHostName() ; 

System. out .println(hostName) ; 


//An array fonvgrbkimg raadt sambegothe hve esx conteadmad/coll1441/1.181> 
// in the hidden fields named item. 
String[] items = req.getParameterValues("item") ; 


//Get the submitted name for the current GET request 


2831 


Table 5.103 


Listing 17 . The JSP program named Java4550a.jsp. 


<html> 
<head><title>Java4550a</title></head> 
<body> 


<form method="get" action="http://localhost:8080/Java4550a. jsp"> 
<p>Enter a name and press the button</p> 

<p>Name: <input type="text" name="firstName"/></p> 

<input type="submit" value="Submit Name"/> 

<p>Your list of names is:<br/> 


<h 
String[] items = request.getParameterValues ("item"); 
response. setContentType ("text/html") ; 


String name = request .getParameter ("firstName"); 
if (name == null){ 

out.println("Empty") ; 
}//end if 


if(items != null){ 
for(int i = 0; i < items.length; i++){ 
A> 
<%= items[i] %> <br/> 
<input type="hidden" name="item" value="<%=items[i]/,>"/> 
<h 
}//end for loop 
}//end if 


if(mame != null){ 

h> 

<%= name %> <br/> 

<input type="hidden" name="item" value="</=name{>"/> 
<h 

}//end if 

A> 

</p></form></body></htm1l> 


Table 5.104 


-end- 
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5.4.6 Java4550r-Review 
5.4.6.1 Table of Contents 


e Preface (p. 2838) 
e Questions (p. 2838) 


1 (p. 2838) , 2 (p. 2838) , 3 (p. 2838) , 4 (p. 2838) , 5 (p. 2839) , 6 (p. 2839) , 7 (p. 2839) 


e Answers (p. 2840) 
e Miscellaneous (p. 2841) 


5.4.6.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4550: Session Tracking 
using Hidden Fields 11° in the Servlets sub-collection. 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


5.4.6.3 Questions 
5.4.6.3.1 Question 1 


True or False? 

The HTTP protocol is a very sophisticated protocol that retains historical information from one client 
request to the next. 

Go to answer 1 (p. 2841) 


5.4.6.3.2 Question 2 


True or False? 

The maintenance of historical information during communications on the web is often referred to as 
"session tracking." 

Go to answer 2 (p. 2841) 


5.4.6.3.3 Question 3 


True or False? 

There are several different ways to accomplish session tracking with a servlet. One of those ways is 
commonly known as hidden fields . 

Go to answer 3 (p. 2841) 


5.4.6.3.4 Question 4 


True or False? 

The hidden fields approach to session tracking has a very long persistence (days, months, years) and 
maintains historical information over many user sessions on a website. 

Go to answer 4 (p. 2840) 


109This content is available online at <http://cnx.org/content /m49590/1.2/>. 
10h¢tp://cnx.org/content /m48550/latest /?collection=col11441 /latest 
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5.4.6.3.5 Question 5 


True or False? 
An HTTP server does not remember historical information from one request to the next. 
Go to answer 5 (p. 2840) 


5.4.6.3.6 Question 6 


True or False? 

Servlet code can call the getParameter method on the incoming request object to get a reference to 
a String array object containing the String values of all incoming hidden fields whose name matches 
the String passed as a parameter to the method. 

Go to answer 6 (p. 2840) 


5.4.6.3.7 Question 7 


True or False? 

Servlet code can call the getParameter method on the incoming request object to get a reference to a 
String object containing the String value of an incoming hidden field whose name matches the String 
passed as a parameter to the method. You should only use this method when you are sure the parameter 
has only one value. Otherwise, the results may not be what you intended. 

Go to answer 7 (p. 2840) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None KEX) 


Display your name 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


5.4.6.4 Answers 
5.4.6.4.1 Answer 7 
True. 
Go back to Question 7 (p. 2839) 
5.4.6.4.2 Answer 6 


False. Servlet code can call the getParameterValues method on the incoming request object to get a 
reference toa String array object containing the String values of all incoming hidden fields whose name 
matches the String passed as a parameter to the method. 

Go back to Question 6 (p. 2839) 


5.4.6.4.3 Answer 5 
True. 
Go back to Question 5 (p. 2839) 


5.4.6.4.4 Answer 4 


False. The hidden fields approach to session tracking is generally limited to one session consisting of multiple 


requests. 
Go back to Question 4 (p. 2838) 
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5.4.6.4.5 Answer 3 


True. 
Go back to Question 3 (p. 2838) 


5.4.6.4.6 Answer 2 


True. 
Go back to Question 2 (p. 2838) 


5.4.6.4.7 Answer 1 


False. The HTTP protocol is a relatively simple request /response protocol that does not retain historical 
information from one client request to the next. 
Go back to Question 1 (p. 2838) 


5.4.6.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4550r-Review 
e File: Java4550r.htm 

e Published: 03/10/14 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


5.4.7 Java4560: Session Tracking using URL Rewriting'" 
5.4.7.1 Table of Contents 
e Preface (p. 2842) 


Viewing tip (p. 2842) 
x Images (p. 2842) 


111 This content is available online at <http://cnx.org/content /m48551/1.4/>. 
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x Listings (p. 2842) 


e General background information (p. 2843) 
e Discussion and sample code (p. 2844) 


The servlet program (p. 2844) 

x Interesting code fragments (p. 2851) 
The JSP program (p. 2855) 

x Interesting code fragments (p. 2855) 


e Run the programs (p. 2859) 
e Miscellaneous (p. 2859) 
e Complete program listings (p. 2860) 


5.4.7.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. The purpose of this module is to explain session tracking using 
URL rewriting, and to compare a servlet with a JSP to accomplish the same objective. 


5.4.7.2.1 Viewing tip 
I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


5.4.7.2.1.1 Images 


e Image 1 (p. 2844) . The URL for hidden fields. 
e Image 2 (p. 2848) . Servlet output screen. 
e Image 3 (p. 2851) . HTML code created by servlet. 


5.4.7.2.1.2 Listings 


Listing 1 (p. 2851 
Listing 2 (p. 2852 


) . Beginning of the doGet method. 
( ) . Get and save URL parameters named item. 
Listing 3 (p. 2853) . Construct the new parameter string. 
Listing 4 (p. 2853) . Concatenate current date and time to new parameter string. 
Listing 5 (p. 2853) . Begin creation of the HTML page. 
Listing 6 (p. 2854) . Construct the hyperlink. 
Listing 7 (p. 2854) . Introductory text. 
Listing 8 (p. 2855) . Display date and time history. 
Listing 9 (p ) . Display the current date and time. 
Listing 10 (p. 2855 
Listing 11 (p. 2856) . 
Listing 12 (p. 2857) . Construct a new parameter string. 
Listing 13 (p. 2857) . Concatenate current date and time to the parameter string. 
( 
( 
( 
( 


) . Import necessary packages. 
) 
) 
) 
Listing 14 (p. 2858) . Create the hyperlink. 
) 
) 
) 


Get data from the old parameter string. 


Listing 15 (p. 2859) . Display the list of dates. 
Listing 16 (p. 2867) . The servlet named Java4560a.java 
Listing 17 (p. 2871) . The JSP program named Java4560b.jsp. 
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5.4.7.3 General background information 


A stateless protocol 

You learned in earlier modules that the HTTP protocol is a relatively simple request /response protocol 
that does not retain historical information from one client request to the next. You also learned that historical 
information can be very important, and the maintenance of historical information is often referred to as 
"session tracking." 

Session tracking 

Because session tracking is very important for many web applications, an earlier module 1!? along with 
this and the next several modules will show you some of the ways that you can accomplish session tracking 
using servlets and JSP. 

Session tracking using URL rewriting 

There are several different ways to accomplish session tracking with a servlet. The earlier module 113 
explained session tracking using hidden fields. This module will illustrate how to accomplish session tracking 
using URL rewriting. 

Limited persistence 

You learned in the earlier module ''4 that the session tracking scheme using hidden fields is generally 
limited to one session consisting of multiple requests. You also learned that the scheme is probably not useful 
for large scale web commerce. However, it might be useful for an online game where the user makes a move 
and then clicks a submit button. The computer needs to remember the entire history of the game, but 
needn’t necessarily remember the history if the user leaves the website by closing the browser page. 

The same holds true for session tracking using URL rewriting. Session tracking using URL rewriting 
provides only limited persistence. While this may seem like a major downside, there is at least one upside 
for both schemes. 

Comparison with cookies 

A future module will explain session tracking using cookies. Cookies probably provide the most commonly 
used scheme for session tracking because cookies can provide persistence over long periods of time. However, 
there is also a downside to cookies. The user can disable cookies in the browser, which completely defeats 
the use of cookies for session tracking. 

Therefore, if your online game uses cookies for session tracking and the user disables cookies, then you 
game won’t work in that browser. As far as I know, it is not possible for the user to prevent session tracking 
using either hidden fields or URL rewriting. 

A servlet and a JSP 

I will explain two different programs that accomplish the same objective in this module. One of the 
programs is a servlet. The other program is a JSP. You probably need to understand the servlet version in 
order to really understand the JSP version. 

The URL window with hidden fields 

If you observed the URL window in your browser while running the hidden-field servlet in the earlier 
module 115 , you probably noticed that after several cycles, the window containing the URL looked something 
like Image 1 (p. 2844) . 


http://localhost:8080/Java4550a?firstName=Harryéitem=Toméitem=Dick 


http://localhost:8080/Java4550a?firstName=Harryéitem=Toméitem=Dick 


112h¢tp://cnx.org/content /m48550/latest /?collection=col11441 /latest 
113h¢tp://cnx.org/content /m48550/latest /?collection=col11441 /latest 
"4h ttp://cnx.org/content /m48550/latest /?collection=col11441/latest 
115http://cnx.org/content /m48550/latest /?collection=col11441 /latest 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2838 CHAPTER 5. INEW 2338 ADVANCED JAVA (WEB) 


http://localhost:8080/Java4550a?firstName=Harryéitem=Toméitem=Dick 


Image 1 . The URL for hidden fields. 


http://localhost:8080/Java4550a?firstName=Harryéitem=Toméitem=Dick 


Table 5.105 


What you see in Image 1 (p. 2844) is the standard way that HTML forms pass parameters to their 

HTTP servers using the GET method. 
A parameter string 

When the user clicks the submit button, a string containing the names and values (name::value pairs 
again) for all of the fields is created and concatenated onto the URL. The string of parameter values is 
joined to the URL with a "?" character. The individual parameters are separated from one another with 
the ampersand character. 

Recall that for the servlet in the earlier module 116 , the field named firstName was the visible field 
in which the user entered a name. The fields named item were hidden fields that were created and 
populated with historical data when the servlet generated the HTML form for return to the client. You can 
see parameters with both of these names in Image 1 (p. 2844) . 

The parameters are accessible by the servlet 

It doesn’t really matter how these parameter names and values come to be concatenated onto the URL. 
As far as the servlet is concerned, their values are accessible using the methods getParameter() and 
getParameterValues() . 

This suggests that in some cases, it might be beneficial for the servlet to save the historical data by 
concatenating it onto a URL referenced in the HTML page before returning the page to the client. That is 
one of the ways that URL rewriting can be used to implement session tracking. 


5.4.7.4 Discussion and sample code 


As I mentioned earlier, I will present a servlet and a JSP program where both are designed to achieve the 
same objective. This will make it possible for you to compare the two programming styles. 

Both programs are designed to illustrate the concept of URL rewriting and are not intended to have any 
practical value in their own right. 

I will explain both programs in fragments. A complete listing of the servlet named Java4560.java 
is provided in Listing 16 (p. 2867) . A complete listing of the JSP program named Java4560b.jsp is 
provided in Listing 17 (p. 2871) . 


5.4.7.4.1 The servlet program 


The servlet named Java4560a.java illustrates session tracking using URL rewriting. In this servlet, 
parameters containing the historical data are added to the servlet’s URL each time the servlet generates a 
new HTML page. The updated URL is included as a hyperlink in the new web page. 

The servlet output 

Each time the servlet is called, it creates and displays an HTML page on the client screen similar to that 
shown in Image 2 (p. 2848) . 


16http://cnx.org/content /m48550/latest /?collection=col11441 /latest 
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[aj Javas x | I 
€ > C fi Dlocat yy 


Click Here 


Your list of times is: 

Sun Dec 22 21:57:55 CST 2013 
Sun Dec 22 21:58:01 CST 2015 
Sun Dec 22 21:58:02 CST 2013 
Sun Dec 22 21:58:38 CST 2013 
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[ai] Javas x I 
e > C fi Dlocltsy = 


Click Here 


Your list of times is: 

Sun Dec 22 21:57:55 CST 2013 
Sun Dec 22 21:58:01 CST 2015 
Sun Dec 22 21:58:02 CST 2013 
Sun Dec 22 21:58:38 CST 2013 
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[aj Javas x | I 
€ > C fi Dlocat yy 


Click Here 


Your list of times is: 

Sun Dec 22 21:57:55 CST 2013 
Sun Dec 22 21:58:01 CST 2015 
Sun Dec 22 21:58:02 CST 2013 
Sun Dec 22 21:58:38 CST 2013 
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Image 2 . Servlet output screen. 


[a] Java4560= x T, 


€ > C A Dlia? 


Click Here 


Your list of times is: 

Sun Dec 22 21:57:55 CST 2013 
Sun Dec 22 21:58:01 CST 2015 
Sun Dec 22 21:58:02 CST 2013 
Sun Dec 22 21:58:38 CST 2013 


Table 5.106 
The page displays: 


e A hyperlink to the servlet URL labeled Click Here 
e A list of the dates and times on which the user previously called the servlet by clicking on the hyperlink. 


A get request 

Each time the user clicks the hyperlink, the client sends a GET request to the server. The GET request 
calls the servlet, which determines the current date and time in milliseconds relative to January 1, 1970. An 
HTML page is created and sent back to the client. 

Update the parameter string 

The current date and time in milliseconds is added as a parameter named item to the servlet URL 
referenced by the hyperlink in the newly-created HTML page. In addition to the current date and time, the 
values of the previous dates and times on which the user called the servlet are retrieved from the incoming 
URL parameter string and appended to the new URL parameter string. 
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In other words, the parameter string values for each successive URL that is generated match those of the 
previous URL. In addition, a new parameter value is added that represents the current date and time. 

Embed historical data in the web page 

In a manner similar to session tracking using hidden fields, the historical data is saved by embedding it 
in the new HTML page that is returned to the client. There is no requirement to save the historical data in 
a database or in the server’s file system. 

Image 3 (p. 2851) shows the HTML source code that corresponds to the web page shown in Image 2 (p. 
2848) . 


view-source:localhost:808 X 


C fi D view-source:localhost:8080/Java4560a?it | = 


| <html> 
<head><title>Java4560a</title></head> 
<body> 

<a href='"http://localhost:809080/Java4560a? 
| item=1387771075185éitem=1387771081455éitem=13877710825226 
| item=1387771118708'>Click Here</a> 
<br/><br/>Your list of times is:<br/> 

Sun Dec 22 21:57:55 CST 2013<br/> 

Sun Dec 22 21:58:01 CST 2013<br/> 

Sun Dec 22 21:58:02 CST 2013<br/> 

Sun Dec 22 21:58:38 CST 2013<br/> 
</body></html1> 
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[Æ] view-source:localhost:808 x 


> CŒ fi |D view-source:localhost:8080/Java4560a?it ¥| = 


<html> 
<head><title>Java4560a</title></head> 
<body> 

<a href='"http://localhost:8080/Java4560a? 
item=1387771075185éitem=1387771081455éitem=13877710825226 
item=1387771118708'>Click Here</a> 
<br/><br/>Your list of times is:<br/> 

Sun Dec 22 21:57:55 CST 2013<br/> 

Sun Dec 22 21:58:01 CST 2013<br/> 

Sun Dec 22 21:58:02 CST 2013<br/> 

Sun Dec 22 21:58:38 CST 2013<br/> 
</body></html> 


[Æ] view-source:localhost:802 x 


>pC# D view-source:localhost:8080/Java4560a?it 2 


<html> 
<head><title>Java4560a</title></head> 
<body> 

<a href='"http://localhost:809080/Java4560a? 
Aitem=1387771075185éitem=1387771081455éitem=13877710825226 
item=1387771118708'>Click Here</a> 
<br/><br/>Your list of times is:<br/> 

Sun Dec 22 21:57:55 CST 2013<br/> 

Sun Dec 22 21:58:01 CST 2013<br/> 

Sun Dec 22 21:58:02 CST 2013<br/> 

Sun Dec 22 21:58:38 CST 2013<br/> 
</body></html> 
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Image 3 . HTML code created by servlet. 


[a] view-source:localhost:808 Xx 


- > C fi |D view-source:localhost:8080/Java4560a7it $7 


1| <html> 
<head><title>Java4560a</title></head> 
<body> 
<a href='http://localhost:8080/Java4560a? 
item=1387771075185éitem=1387771081455éitem=1387771082522¢6 
item=1387771118708'>Click Here</a> 
<br/><br/>Your list of times is:<br/> 
Sun Dec ws BR Be CST 2013<br/> 
Sun Dec 21:598: CST 2013<br/> 
Sun Dec 21:98: CST 2013<br/> 
Sun Dec 21:98: CST 2013<br/> 
</body></html> 


hm Mh bh ho 
hh bh ho 


Table 5.107 


The URL parameter string 

The most interesting thing in Image 3 (p. 2851) is the content of Line 4. (Note that Line 4 is wrapped 
and appears as three physical lines in Image 3 (p. 2851) .) Each large numeric value that you see in 
Line 4 is the number of milliseconds since January 1, 1970 for a particular date and time. These values in 
milliseconds are translated into actual dates and times and shown in Lines 6 through 9. 

No special software requirements 

This approach places no special requirements on the server software other than the ability to support 
Java servlets. The approach should be compatible with all browsers that support hyperlinks. 


5.4.7.4.1.1 Interesting code fragments 


Beginning of the doGet method 

As mentioned earlier, I will explain this program in fragments. Listing 1 (p. 2851) shows the beginning 
of the controlling class and the beginning of the doGet method. You have seen code like this before, so I 
won’t discuss it further. 


Listing 1 . Beginning of the doGet method. 


continued on next page 
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import java.io.*; 
import java.util.*; 
import javax.servlet.*; 
import javax.servlet.http.*; 


public class Java4560a extends HttpServlet{ 
public void doGet (HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, I0Exceptionf{ 


Table 5.108 


Get and save URL parameters named item 
An HTTP URL can have multiple parameters with the same name. In this case, all of the parameters 
are named item . Listing 2 (p. 2852) gets the values stored in all of the parameters named item and 
saves them ina String array named items 
(Each time the servlet is called, the size of the list of parameters increases by one.) 
The fragment also instantiates and initializes a String object used later to construct a new parameter 
string for the URL. 


Listing 2 . Get and save URL parameters named item. 


String parameters = "?"; 
String[] items = request.getParameterValues ("item"); 


Table 5.109 


Construct the new parameter string 
Listing 3 (p. 2853) uses the parameter values from the old parameter string to construct a new parameter 
string. The new parameter string will later be concatenated to the URL for the servlet. 


if(items != null) { 
for(int i = 0; i < items.length; i++) { 
parameters = parameters + "item=" + items[i] + "&"; 
}//end for loop 
}//end if 


if(items != null) { 
for(int i = 0; i < items.length; i++){ 
parameters = parameters + "item=" + items[i] + "&"; 
}//end for loop 
}//end if 
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if(items != null) { 
for(int i = 0; i < items.length; i++) { 
parameters = parameters + "item=" + items[i] + "&"; 
}//end for loop 
}//end if 


Listing 3 . Construct the new parameter string. 


if(items != null) { 
for(int i = 0; i < items.length; i++) { 
parameters = parameters + "item=" + items[i] + "&"; 
}//end for loop 
}//end if 


Table 5.110 


Concatenate current date and time to new parameter string 

Listing 4 (p. 2853) gets the current date and time in milliseconds and saves it ina long variable named 
theDate . Then it concatenates the current date and time in milliseconds onto the new parameter string 
that was constructed in Listing 3 (p. 2853) . 


Listing 4 . Concatenate current date and time to new parameter string. 


long theDate = new Date().getTime() ; 
parameters = parameters + "item=" + theDate; 


Table 5.111 


Begin creation of the HTML page 
Listing 5 (p. 2853) begins the creation of the output HTML page. You have seen code like this before, 
so I won’t discuss it further at this point. 


Listing 5 . Begin creation of the HTML page. 


continued on next page 
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//Establish the type of output 
response.setContentType("text/html") ; 


//Get an output stream 
PrintWriter out = response.getWriter(); 


//Construct an HTML page and send it back to the client 
out .printiln("<htm1>"); 


out.println("<head><title>Java4560a</title></head>") ; 
out .printin("<body>") ; 


Table 5.112 


Construct the new hyperlink 
Listing 6 (p. 2854) constructs the hyperlink containing the URL for the servlet. Note that the hyperlink 
references a URL that includes the parameter string constructed above. 


If you compile and run this servlet, you may need to substitute the name of your server in place of my 
server. 


Listing 6 . Construct the hyperlink. 


out.println("<a href=’http://localhost :8080/Java4560a" 
+ parameters + "?>Click Here</a>") 


Table 5.113 


Introductory text 


Listing 7 (p. 2854) provides a line of introductory text for the list of dates and times to be displayed on 
the screen. 


Listing 7 . Introductory text. 


out.println("<br/><br/>Your list of times is:<br/>"); 


Table 5.114 


Display date and time history 


Listing 2 (p. 2852) retrieved all of the data in the incoming URL parameters and saved that data in a 
String array named items 

If that array contains data, Listing 8 (p. 2855) displays the date and time for each element in the array. 

The parameter values in milliseconds are first converted from String to long . Each of the long 


values is then used to instantiate a new Date object, which is displayed in the format shown in Image 2 
(p. 2848) . 
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Listing 8 . Display date and time history. 


if(items != null){ 
for(int i = 0; i < items.length; i++){ 
long millis = Long.parseLong(items[i]); 
out.printin("" + new Date(millis) + "<br/>"); 
}//end for loop 
}//end if 


Table 5.115 


(Hopefully you already understand the relationship between the overridden toString method 
of the Date class and the format resulting from passing a Date object’s reference to the 
printIn method. If not, see Ap0005: Preface to OOP Self-Assessment !!" and the modules 


following that one.) 


Display the current date and time 
Listing 4 (p. 2853) obtained the current date and time in milliseconds and saved it in a variable named 


theDate . Listing 9 (p. 2855) uses that value to instantiate and display anew Date object reflecting 


the current date and time. 


Listing 9 . Display the current date and time. 


out.printin("" + new Date(theDate) + "<br/>"); 
out .printin("</body></html>");//finish HTML page 


Table 5.116 


Listing 9 (p. 2855) also creates the HTML code necessary to finish the HTML page. 


5.4.7.4.2 The JSP program 
I will also discuss the JSP program named Java4560b.jsp in fragments. A complete listing of the program 
is provided in Listing 17 (p. 2871) . 


5.4.7.4.2.1 Interesting code fragments 


Import necessary packages 
Listing 10 (p. 2855) shows the necessary import directives plus the beginning of the HTML page. 


Listing 10 . Import necessary packages. 


continued on next page 
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<%@ page import=’ java.util.*,java.io.*’ %> 


<html> 
<head><title>Java4560b</title></head> 
<body> 


Table 5.117 


There’s nothing new in Listing 10 (p. 2855) with the possible exception of the format of the import 
directives. The format is different from the format used in regular Java code. (See Listing 1 (p. 2851) .) 

Some packages are imported automatically 

Recall from Java4307: Servlets and JSP !!8 that it is not necessary to import javax.servlet and 
javax.servlet.http . Those two packages are automatically imported by the JSP container on the server. 
No page directive import settings are required for using the classes defined in these packages. 

Get data from the old parameter string 

Listing 11 (p. 2856) shows the beginning of a scriptlet containing pure Java code. 


Listing 11 . Get data from the old parameter string. 


<h 
String parameters = "?"; 
String[] items = request.getParameterValues ("item"); 


Table 5.118 


The code in Listing 11 (p. 2856) declares and initializes a String that will be used later to construct 
a new parameter string. 
Listing 11 (p. 2856) also gets and saves the values of all of the parameters from the old parameter string 
named "item" . 
Construct a new parameter string 
Listing 12 (p. 2857) constructs a new parameter string containing the names and values of all the 
parameters named "item" in the old parameter string. (A parameter for the current date and time will 
be concatenated later.) 
if(items != null){ 
for(int i= 0; i < items.length; i++){ 
parameters = parameters + "item=" + items[i] + "&"; 
}//end for loop 
}//end if 


118http://cnx.org/content /m48284/latest /?collection=col1 1441 /latest 
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if (items != null){ 
for(int i = 0; i < items.length; i++){ 
parameters = parameters + "item=" + items[i] + "é"; 
}//end for loop 
}//end if 


if (items != null){ 
for(int i= 0; i < items.length; i++){ 
parameters = parameters + "item=" + items[i] + "&"; 
}//end for loop 
}//end if 


Listing 12 . Construct a new parameter string. 


if(items != null){ 
for(int i = 0; i < items.length; i++){ 
parameters = parameters + "item=" + items[i] + "é&"; 
}//end for loop 
}//end if 


Table 5.119 


Concatenate current date and time to the parameter string 
Listing 13 (p. 2857) gets the current date and time in milliseconds and concatenates it to the new 
parameter string with the name "item" 


Listing 13 . Concatenate current date and time to the parameter string. 


long theDate = new Date().getTime() ; 
parameters = parameters + "item=" + theDate; 


response.setContentType("text/html") ; 
hh> 


Table 5.120 


Listing 13 (p. 2857) also sets the output content type to "text/html" . 

Finally, Listing 13 (p. 2857) signals the end of the scriptlet that began in Listing 11 (p. 2856) . 

Create the hyperlink 

Listing 14 (p. 2858) uses a JSP expression tag along with raw HTML code to create the hyperlink 
shown near the top of the page in Image 2 (p. 2848) . 
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<a href='http://localhost:8080/Java4560b.jsp<%=parameters%>'> 
Click Here</a> 


&<br/><br/>Your list of times is:<br/> 


<a href="http://localhost:8080/Java4560b. jsp<%=parameters%>'> 
Click Here</a> 


&<br/><br/>Your list of times is:<br/> 


<a href="http://localhost:8080/Java4560b. jsp<t=parameterst>'> 
Click Here</a> 


&<br/><br/>Your list of times is:<br/> 


Listing 14 . Create the hyperlink. 


<a href='"http://localhost:8080/Java4560b. jsp<%=parameters%>'> 
Click Here</a> 


&<br/><br/>Your list of times is:<br/> 


Table 5.121 


Listing 14 (p. 2858) also uses raw HTML code to create the line of text that appears immediately above 
the list of dates in Image 2 (p. 2848) . 

Display the list of dates 

Listing 15 (p. 2859) shows another scriptlet containing pure Java code. The first six lines of code display 
the historical date and time information. The next line of code displays the current date and time. 
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Listing 15 . Display the list of dates. 


<h 
if(items != null){ 
for(int i = 0; i < items.length; i++){ 
long millis = Long.parseLong(items[i]); 
out.printin("" + new Date(millis) + "<br/>"); 
}//end for loop 
}//end if 


out.println("" + new Date(theDate) + "<br/>"); 
out .printin("</body></html>") ; 
hh> 


Table 5.122 


The last line of code creates the HTML elements necessary to finish the page. 

A choice 

I could have broken this scriptlet into two or more scriptlets using raw HTML code in between to display 
the material. However, I decided that it was simpler in this case to use Java println statements to display 
the material than it would have been to break it up and use interspersed HTML code. 


5.4.7.5 Run the programs 


I encourage you to copy the code from Listing 16 (p. 2867) and Listing 17 (p. 2871) . Install the programs 
on your server and run them. Experiment with the code, making changes, and observing the results of your 
changes. Make certain that you can explain why your changes behave as they do. 


5.4.7.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4560: Session Tracking using URL Rewriting 
e File: Java4560.htm 

e Published: 12/23/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
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a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


5.4.7.7 Complete program listings 


I recognize that the code in Listing 16 (p. 2867) may be difficult to read. Note, however that if you have 
difficulty reading it, you can reconstruct the entire program from the code fragments provided earlier. You 
might also try zooming with your browser to see if that makes it easier to read. 
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/*Bile Java4560a.java, Copyright 1999, R.6.Baldvin 
Rev 12/22/13 


The purpose of this program is to illustrate session 
tracking through the use of rewritten URLs 
AAAAAAAAAAADHAAAARAAHHAAAAAAAAAAAAAA AAA AAAAAA AAA AAA HAA | 
import java.io.*; 

import java.util.*; 

import javax.servlet.*; 

import javax.servlet.http.*; 


public class JavadS60a extends HttpServlet( 
public void doGet(HttpServletRequest request, 
RetpServletResponse response) 
throws ServletException, [0Exception( 


//Ref variable used to construct the parameter string 
String parameters = "2"; 


//4n array for getting and saving the values contained 
/} in the parameters named iten. 
String[] items = request.getParaneterValues("iten"); 


if(items != null) { 
for(int i = 0; i< items length: it+)[ 
//Access the old parameter string to construct the 
J| new parameter string to append to the URL below. 
parameters = parameters + “item=" + items(i] + "i"; 
}//end for loop 
Hend if 


//Get the current date and tine in milliseconds. Add 
// the current date and tine to the parameter string 
/} constructed above. 

long theDate = new Date() .getTime(); 

Parameters = parameters + "iten" + theDate; 


//Establish the type of output 
response. setContentT ype ("text/htal”); 


//Set an output strean 
Printiriter out = response.getiiriter(); 


//Construct an HTML page and send it back to the client 
out.println ("<html>"); 

out. println ("<head><title>JavaiS6la</titlex</head>") : 
out.println ("<body>"); 


//Construct the hyperlink referencing the servlet here. 
/} Note that the hyperlink references a URL that 
// includes the parameter string constructed above. 


//Substitute the name of your server here 
out.println ("<a href='http://localhost:8080/Java4560a" 
+ parameters + "'>Click Here</a>"); 


//Display the historical data stored in the parameter 
/} string. 
out.println("<br/><br/>Your list of times is:<br/>"); 


if(itens != null) [ 
for(int i = 0; i < items.length: it+) ( 
//Convert from milliseconds as a String to a Date 
// object. Then format for display. 
long millis = Long.parseLong(itens[i]); 
out.println("" + new Date(millis) + "<br/>"); 
}//end for loop 
Mend if 


//Convert from milliseconds to a Date object and then 
/} format for display. 

out.println("" + new Date (theDate) + "<br/>"); 
out.println("</body></htal>") ;//finish EML page 


Mend doGet() 
Herd class Java4Sé0a 
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/*Bile Java4560a.java, Copyright 1999, R.6.Baldvin 
Rev 12/22/13 


The purpose of this program is to illustrate session 
tracking through the use of rewritten URLs 
AAAAAAAAAAADHAAAARAAHHAAAAAAAAAAAAAA AAA AAAAAA AAA AAA HAA | 
import java.io.*; 

import java.util.*; 

import javax.servlet.*; 

import javax.servlet.http.*; 


public class JavadS60a extends HttpServlet( 
public void doGet(HttpServletRequest request, 
RetpServletResponse response) 
throws ServletException, [0Exception( 


//Ref variable used to construct the parameter string 
String parameters = "2"; 


//4n array for getting and saving the values contained 
/} in the parameters named iten. 
String[] items = request.getParaneterValues("iten"); 


if(items != null) { 
for(int i = 0; i< items length: it+)[ 
//Access the old parameter string to construct the 
J| new parameter string to append to the URL below. 
parameters = parameters + “item=" + items(i] + "i"; 
}//end for loop 
Hend if 


//Get the current date and tine in milliseconds. Add 
// the current date and tine to the parameter string 
/} constructed above. 

long theDate = new Date() .getTime(); 

Parameters = parameters + "iten" + theDate; 


//Establish the type of output 
response. setContentT ype ("text/htal”); 


//Set an output strean 
Printiriter out = response.getiiriter(); 


//Construct an HTML page and send it back to the client 
out.println ("<html>"); 

out. println ("<head><title>JavaiS6la</titlex</head>") : 
out.println ("<body>"); 


//Construct the hyperlink referencing the servlet here. 
/} Note that the hyperlink references a URL that 
// includes the parameter string constructed above. 


//Substitute the name of your server here 
out.println ("<a href='http://localhost:8080/Java4560a" 
+ parameters + "'>Click Here</a>"); 


//Display the historical data stored in the parameter 
/} string. 
out.println("<br/><br/>Your list of times is:<br/>"); 


if(itens != null) [ 
for(int i = 0; i < items.length: it+) ( 
//Convert from milliseconds as a String to a Date 
// object. Then format for display. 
long millis = Long.parseLong(itens[i]); 
out.println("" + new Date(millis) + "<br/>"); 
}//end for loop 
Mend if 


//Convert from milliseconds to a Date object and then 
/} format for display. 

out.println("" + new Date (theDate) + "<br/>"); 
out.println("</body></htal>") ;//finish EML page 


Mend doGet() 
Herd class Java4Sé0a 
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/*Bile Java4560a.java, Copyright 1999, R.6.Baldvin 
Rev 12/22/13 


The purpose of this program is to illustrate session 
tracking through the use of rewritten URLs 
AAAAAAAAAAADHAAAARAAHHAAAAAAAAAAAAAA AAA AAAAAA AAA AAA HAA | 
import java.io.*; 

import java.util.*; 

import javax.servlet.*; 

import javax.servlet.http.*; 


public class JavadS60a extends HttpServlet( 
public void doGet(HttpServletRequest request, 
RetpServletResponse response) 
throws ServletException, [0Exception( 


//Ref variable used to construct the parameter string 
String parameters = "2"; 


//4n array for getting and saving the values contained 
/} in the parameters named iten. 
String[] items = request.getParaneterValues("iten"); 


if(items != null) { 
for(int i = 0; i< items length: it+)[ 
//Access the old parameter string to construct the 
J| new parameter string to append to the URL below. 
parameters = parameters + “item=" + items(i] + "i"; 
}//end for loop 
Hend if 


//Get the current date and tine in milliseconds. Add 
// the current date and tine to the parameter string 
/} constructed above. 

long theDate = new Date() .getTime(); 

Parameters = parameters + "iten" + theDate; 


//Establish the type of output 
response. setContentT ype ("text/htal”); 


//Set an output strean 
Printiriter out = response.getiiriter(); 


//Construct an HTML page and send it back to the client 
out.println ("<html>"); 

out. println ("<head><title>JavaiS6la</titlex</head>") : 
out.println ("<body>"); 


//Construct the hyperlink referencing the servlet here. 
/} Note that the hyperlink references a URL that 
// includes the parameter string constructed above. 


//Substitute the name of your server here 
out.println ("<a href='http://localhost:8080/Java4560a" 
+ parameters + "'>Click Here</a>"); 


//Display the historical data stored in the parameter 
/} string. 
out.println("<br/><br/>Your list of times is:<br/>"); 


if(itens != null) [ 
for(int i = 0; i < items.length: it+) ( 
//Convert from milliseconds as a String to a Date 
// object. Then format for display. 
long millis = Long.parseLong(itens[i]); 
out.println("" + new Date(millis) + "<br/>"); 
}//end for loop 
Mend if 


//Convert from milliseconds to a Date object and then 
/} format for display. 

out.println("" + new Date (theDate) + "<br/>"); 
out.println("</body></htal>") ;//finish EML page 


Mend doGet() 
Herd class Java4Sé0a 
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Listing 16 . The servlet named Java4560a.java 


/*Pile Java4560a.java, Copyright 1999, 2.6.Baldvin 


The purpose of this program is to illustrate session 
tracking through the use of rewritten URLs 
AAAAAARAAAAAMAADAAARAAAAAAAADAAAAAAREAAAAA HAMAR AAA AEA AAAS | 
import java.io.*; 

import java.util.*; 

import javax.servlet.*; 

import javax.servlet.http.*; 


public class JavadS60a extends HttpServlet( 
public void doGet (HetpServletRequest request, 
HetpServletResponse response) 
throws ServletException, [0Exception( 


//Ref variable used to construct the parameter string 
String parameters = "2"; 


//4n array for getting and saving the values contained 
/} in the parameters named iten. 
String[] items = request.getParameterValues("iten"); 


if(items != null) ( 
for(int i = 0; i < items.length: i++) [ 
//Access the old parameter string to construct the 
// new parameter string to append to the URL belov. 
parameters = parameters + “item=" + items(i] + "i"; 
}//end for loop 
H/end if 


//Get the current date and tine in milliseconds. Add 
// the current date and tine to the parameter string 
/} constructed above. 

long theDate = new Date() .getTine(); 

Parameters = parameters + "iten" + theDate; 


//Establish the type of output 
response. setContentT ype ("text/htal”); 


//Get an output strean 
Printiiriter out = response.getiriter(); 


//Construct an HTML page and send it back to the client 
out.println ("<htal>"); 

out. println |"chead><title>JavasS6la</title></head>") : 
out.println ("<body>"); 


//Construct the hyperlink referencing the servlet here. 
/} Note that the hyperlink references a URL that 
/} includes the parameter string constructed above. 


//Substitute the name of your server here 
out.println ("<a href='http://localhost:8080/Java4560a" 
+ parameters + "'>Click Here</a>"); 


//Display the historical data stored in the parameter 
/} string. 
out.println("<br/><br/>Your list of times is:<br/>"); 


if(itens != null) ( 
for(int i = 0; i < items.length: itt) [ 
//Convert from milliseconds as a String to a Date 
// object. Then format for display. 
long millis = Long.parseLong(itens[i]); 
out.println("" + new Date(millis) + "<br/>"); 
}//end for loop 
Vlend if 


//Convert rom milliseconds to a Date object and then 
/} format for display. 

out.println("" + new Date(theDate) + "<br/>"); 
out.println("</body></htal>") ;//finish EML page 


}//end doGet() 
Hiend class Javai5é0a 
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Table 5.123 


<3@ page import='java.util.*,java.io.*' $> 


<html> 
<head><title>Java4560b</title></head> 
<body> 


<F 
String parameters = "2"; 
String[] items = request.getParameterValues ("item"); 


if(items != null){ 
for(int i = 0; i < items.length; i++) { 
parameters = parameters + "item=" + items[i] + "&"; 
}//end for loop 
}//end if 


long theDate = new Date().getTime(); 
parameters = parameters + "item=" + theDate; 


response.setContentType ("text/html"); 
> 


<a href="http://localhost:8080/Java4560b. jsp<$=parameters%>'> 
Click Here</a> 


<br/><br/>Your list of times is:<br/> 


<3 
if (items != null) { 
for(int i = 0; i < items.length; i++){ 
long millis = Long.parseLong(items[i]); 
out.printin("" + new Date(millis) + "<br/>"); 
}//end for loop 
}//end if 


out.printin("" + new Date(theDate) + "<br/>"); 


out.println("</body></html>") ; 
$> 
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<3@ page import='java.util.*,java.io.*' $> 


<html> 
<head><title>Java4560b</title></head> 
<body> 


<$ 
String parameters = "2"; 
String[] items = request.getParameterValues ("item"); 


if(items != null){ 
for(int i = 0; i < items.length; i++){ 
parameters = parameters + "item=" + items[i] + "&"; 
}//end for loop 
}//end if 


long theDate = new Date().getTime(); 
parameters = parameters + "item=" + theDate; 


response. setContentType ("text/html"); 
$> 


<a href='http://localhost:8080/Java4560b.jsp<%$=parameters$į>'> 
Click Here</a> 


<br/><br/>Your list of times is:<br/> 


<$ 
if (items != null){ 
for(int i = 0; i < items.length; i++){ 
long millis = Long.parseLong(items[i]); 
out.printin("" + new Date(millis) + "<br/>"); 
}//end for loop 
}//end if 


out.printin("" + new Date(theDate) + "<br/>"); 
out .println("</body></htm1>") ; 
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<3@ page import='java.util.*,java.io.*' $> 


<html> 
<head><title>Java4560b</title></head> 
<body> 


<$ 
String parameters = "2"; 
String[] items = request.getParameterValues ("item"); 


if(items != null){ 
for(int i = 0; i < items.length; i++){ 
parameters = parameters + "item=" + items[i] + "&"; 
}//end for loop 
}//end if 


long theDate = new Date().getTime(); 
parameters = parameters + "item=" + theDate; 


response. setContentType ("text/html"); 
$> 


<a href='http://localhost:8080/Java4560b.jsp<%$=parameters$į>'> 
Click Here</a> 


<br/><br/>Your list of times is:<br/> 


<3 
if (items != null) { 
for(int i = 0; i < items.length; i++){ 
long millis = Long.parseLong(items[i]); 
out.printin("" + new Date(millis) + "<br/>"); 
}//end for loop 
}//end if 
out.printin("" + new Date(theDate) + "<br/>"); 
out.println("</body></html>") ; 
$> 
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Listing 17 . The JSP program named Java4560b.jsp. 


<3@ page import='java.util.*,java.io.*' $> 


<html> 
<head><title>Java4560b</title></head> 
<body> 


<$ 
String parameters = "?"; 
String[] items = request.getParameterValues ("item"); 


if (items != null) { 
for(int i = 0; i < items.length; i++) { 
parameters = parameters + "item=" + items[i] + "&"; 
}//end for loop 
}//end if 


long theDate = new Date().getTime(); 
parameters = parameters + "item=" + theDate; 


response.setContentType ("text/html"); 
$> 


<a href='http://localhost:8080/Java4560b. jsp<=parameters$>'> 
Click Here</a> 


<br/><br/>Your list of times is:<br/> 


<3 
if(items != null) { 
for(int i = 0; i < items.length; i++){ 
long millis = Long.parseLong(items[i]); 
out.printin("" + new Date(millis) + "<br/>"); 
}//end for loop 
}//end if 


out.printin("" + new Date(theDate) + "<br/>"); 
out.println("</body></htm1>") ; 


Table 5.124 


-end- 
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5.4.8 Java4570: Session Tracking using Cookies” 
5.4.8.1 Table of Contents 
e Preface (p. 2872) 


Viewing tip (p. 2872) 
x Images (p. 2872) 
x Listings (p. 2873) 
e General background information (p. 2873) 


Program output (p. 2873) 
What are cookies? (p. 2880) 
The Java Cookie class (p. 2881) 


e Discussion and sample code (p. 2882) 


The servlet program (p. 2882) 
x Interesting code fragments (p. 2883) 
The JSP program (p. 2887) 


e Run the programs (p. 2887) 
e Miscellaneous (p. 2887) 
e Complete program listing (p. 2889) 


5.4.8.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. The purpose of this module is to explain session tracking using 
cookies, and to compare a servlet with a JSP to accomplish the same objective. 

If you haven’t already done so, I strongly recommend that you study Java4370: Cookies with JS 
before continuing with this module. Dr. Martinez explains many aspects of cookies in that module. Most 
of those aspects apply to both JSP and servlets and many of them won’t be repeated in this module. 


P 120 


5.4.8.2.1 Viewing tip 

I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 

5.4.8.2.1.1 Images 


e Image 1 (p. 2876). Output from the servlet program. 
e Image 2 (p. 2880) . Output from the JSP program. 
e Image 3 (p. 2882) . Description of the Cookie constructor. 


119This content is available online at <http://cnx.org/content /m48571/1.2/>. 
120http://cnx.org/content /m48091 /latest /?collection=col11441 /latest 
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5.4.8.2.1.2 Listings 


e Listing 1 (p. 2883) . Beginning of the doGet method. 

e Listing 2 (p. 2883) . Construct a unique session ID. 

e Listing 3 (p. 2884) . Get all of the cookies into an array of type Cookie. 
e Listing 4 (p. 2884) . Get and save submitted value. 

e Listing 5 (p. 2885) . Create a new session ID cookie. 

e Listing 6 (p. 2885) . Create, name, and populate a new Cookie object. 
e Listing 7 (p. 2886) . Familiar code. 

e Listing 8 (p. 2886) . Get and display cookie names and values. 

e Listing 9 (p. 2887) . Display currently submitted field value. 

e 

e 


p 
Listing 10 (p. 2889) . The servlet program named Java4570a.java. 
Listing 11 (p. 2891) . The JSP program named Java4570b.jsp. 


5.4.8.3 General background information 
5.4.8.3.1 Program output 


I will explain a servlet program and present a comparable JSP program in this module. The purpose is to 
show you how to write servlets that use cookies for session tracking and to make it possible to compare a 
servlet and a JSP that both achieve the same objective. 

The servlet output 

Image 1 (p. 2876) shows the output produced by requesting the servlet from the localhost server using 
the Chrome browser and then submitting the names Tom, Dick, and Harry using the input text field and 
the submit button. I will refer back to this image later while explaining the servlet code. 


[a] Java4570a 


€ > C fi |D localhost:8080/Java4570a?firstNar Y% 


Enter a name and press the button 


Name: | 


Submit Name 


Your session ID and list of names is: 
session D:-6£29892%3A1432599a8cc%3A-7ffe 
1387909918280:Tom 


1387909927784:-Dick 
Harry 
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Java4570a 


€ > C fi D localhost:8080/Java4570a?firstNar vy = 


Enter a name and press the button 


Your session ID and list of names is: 
sessionID:-6f29892%3A1432599a8cc%3A-7ffe 
1387909918280:Tom 

1387909927784:Dick 

Harry 
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Java4570a 


€ > C fi |D localhost:8080/Java4570a?firstNar %7 | = 


Enter a name and press the button 


Your session ID and list of names is: 
sessionID:-6f29892%3A1432599a8cc%3A-7ffe 
1387909918280:Tom 

1387909927784:Dick 

Harry 
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Image 1 . Output from the servlet program. 


[a] Java4570a 
€ > C AG localhost:8080/Java4570a?firstNar %7 


Enter a name and press the button 


Name: | 


Submit Name 


Your session ID and list of names is: 

session D--6£29892%3A1432599a8cc%3A-T7ffe 
1387909918280:Tom 

1387909927784-Dick 


Harry 


Table 5.125 


The JSP output 

Image 2 (p. 2880) shows the output produced by requesting the JSP from the localhost server using the 
Firefox browser and then submitting the names Tom, Dick, and Harry using the input text field and the 
submit button. I will refer back to this image later while explaining the JSP code. 
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570b-M 
Loe Se 


Enter a name and press the button 


Name: | | 


Your session ID and list of names is: 
JSESSIONID:7822176275F9F9C8E2F5FEBEF75A1655 
sessionID:-1b003acb%3A14325b20d6e%3A-7 fff 
1387909983838:Tom 

1387909996183-:Dick 

Harry 
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570b - Mozilla Firefox = |] Xx 
SS ee are 17S ee NE y Ss ae l r i 
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Enter a name and press the button 


Name: | | 


Your session ID and list of names is: 
JSESSIONID:7822176275F9F9C8E2F5FEBEF75A1655 
sessionID:-1b003acb%3A14325b20d6e%3A-7 fff 
1387909983838:Tom 

1387909996183-:Dick 

Harry 
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570b-M 
Loe Se 


Enter a name and press the button 


Name: | | 


Your session ID and list of names is: 
JSESSIONID:7822176275F9F9C8E2F5FEBEF75A1655 
sessionID:-1b003acb%3A14325b20d6e%3A-7 fff 
1387909983838:Tom 

1387909996183-:Dick 

Harry 
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Image 2 . Output from the JSP program. 


) Java4570b - Mozilla Firefox 


€ @ localhost:3080/Java4570b. jsp?fi le 


Enter a name and press the button 


Name: | 
Submit Name | 


Your session ID and list of names is: 
JSESSIONID:7822176275F9F9C8E2F5FEBEF75A1655 
sessionID:-1b003acb%3A14325b20d6e%3A-7 fff 
1387909983838:Tom 

1387909996183-:Dick 


Harry 


Table 5.126 


(The main difference between Image 1 (p. 2876) and Image 2 (p. 2880) is the line that begins with 
JSESSIONID in Image 2 (p. 2880) . Also Image 1 (p. 2876) is displayed in a Chrome browser and Image 2 
(p. 2880) is displayed in a Firefox browser.) 


5.4.8.3.2 What are cookies? 


Cookies are information that is created by a web application and stored on the client machine by the 
browser. Under certain conditions, this information is sent to the HTTP server whenever a request is sent 
from the client to the server. 

Used for session tracking 

Cookies are widely used by various server-side programming techniques for session tracking. Java provides 
classes and methods designed to allow you to use cookies in your servlets. 

Which server receives a cookie? 

By default, cookies are sent only to the host that caused them to be saved. Methods can be called to set 
attributes for each cookie that determine which servers will receive the cookie. For example, the setDomain 
method can be used to specify a domain pattern indicating which servers should receive a cookie. 
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By default, cookies are sent to the page that set the cookie and to all the pages in that directory or under 

that directory. This also can be modified by calling the setPath method on the cookie. 
What is the life expectancy of a cookie? 

Also by default, a cookie expires when the browser exits. The setMaxAge method can be called to 
override the default and specify the maximum age of the cookie in seconds. The cookie will expire when the 
maximum age has been reached. The parameter to this method is an int so the maximum age of a cookie 
can be a very large number of seconds. (The maximum positive value of Java type int is 2,147,483,647. 
If I did the arithmetic correctly, that is about 68 years.) 

Comments in a cookie 

The setComment method can be used to provide a comment with the cookie. The browser may elect 

to make this information available to the user. 
Name and value of a cookie 

The constructor sets the name and value of a cookie when the Cookie object is instantiated. The 

set Value method can be used to assign a new value to the cookie after it is instantiated. 
Other attributes 

There are a few other attributes that can be set as well. You can read about them in the Java(TM) EE 
7 1?! documentation. 

Cookies can be disabled 

CAUTION: The user can disable cookies in most, and perhaps all browsers. As a result, the user can 
defeat session tracking using cookies. 

Therefore, unless you can be certain that all of your clients will operate with cookies enabled, the use 
of cookies for session tracking may not be satisfactory in all cases. (The fallback position may be the 
less-persistent Hidden Fields and/or URL Rewriting methods of session tracking.) 


5.4.8.3.3 The Java Cookie class 


The Cookie class represents a cookie that can be used for session management with the HTTP protocol. 
Cookies are used to cause user agents such as web browsers to store small amounts of state associated 
with a user’s web browsing activities. 
Applications 
Common applications for cookies include: 


e Storing user preferences 
e Automating low security user signon facilities, and 
e Helping collect data used for "shopping cart" applications. 


Names, values, and attributes 
Each cookie has a name and a single value (a name::value pair) . As mentioned earlier, it may have 
optional attributes, including: 


A comment presented to the user 

Path and domain qualifiers to specify which hosts can see the cookie 
A maximum age, and 

A version. 


Sending cookies to the browser 

In the Java API, cookies are saved one at a time into such HTTP response headers, using the addCookie 
method. 

According to the Java documentation !?? , The browser is expected to support 20 cookies for each web 
server, 300 cookies total, and may limit cookie size to 4 KB each. 


121 http://docs.oracle.com/javaee/7 /api/index.html?javax/servlet /http /Cookie.html 
122http://docs.oracle.com/javaee/7 /api/index.html?javax/servlet /http /Cookie.html 
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Servers assign cookies, using fields added to HTTP response headers. 

Retrieving cookies from the browser 

Cookies are passed from the browser to the server using fields added to HTTP request headers. 

In the Java API, HTTP cookies are retrieved using the getCookies method. This method returns all 
of the cookies found in the request sent by the client. 

Description of the Cookie constructor 

An abbreviated description of the constructor for the Cookie class is shown in Image 3 (p. 2882) . 


Image 3 . Description of the Cookie constructor. 


public Cookie(String name, String value) 

Constructs a cookie with the specified name and value. 

The name of a cookie cannot be changed once the cookie has been created. 

The value can be anything the server chooses to send. The cookie’s value can be changed after creation 
with the setValue method. 

Parameters: 


name - the name of the cookie 
value - the value of the cookie 


Table 5.127 


5.4.8.4 Discussion and sample code 
5.4.8.4.1 The servlet program 


The name of the servlet program is Java4570 I will discuss this program in fragments. A complete listing 
of the program is provided in Listing 10 (p. 2889) . 

Displays an HTML form 

Each time the servlet is called, it displays an HTML form on the client screen as shown in Image 1 (p. 
2876) . The form contains: 


An input field for submitting a name 
A submit button 
A list of previously submitted names 
Some static text 


A unique session ID 

The first time the servlet is called by a given browser, code written into the servlet creates a unique 
session ID and stores it in a cookie on the browser. This session ID is not used for any purpose in this 
sample program. It is included in the servlet simply to show how to create and save a unique session ID. 

A cookie containing the submitted value 

Each time the servlet is called, it creates a cookie containing the field value submitted by the user and 
stores it on the browser. 

When the servlet is called, it gets all of the cookie information stored on the browser and displays that 
information on the client screen as shown in Image 1 (p. 2876) . The display includes the unique session ID 
and all of the field values submitted by the user during that session. 

The maximum age of the cookies 
The cookie containing the session ID is deleted when the browser is exited. 
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The maximum age for all of the other cookies is set to 60 seconds. Therefore, if you submit some names, 
wait more than 60 seconds, and then submit some more names, the first batch of names submitted will have 
expired and will have disappeared from the list. 

The lifetime of a session 

A session doesn’t end just because the user visits another page. If the user returns to the Java4570 
servlet without exiting the browser, the cookies written by Java4570 that have not yet expired will 
continue to exist on the browser and the session will continue. 

Also, if the user exits and then restarts the browser and calls the servlet, the cookies that have not yet 
expired will continue to exist and will be displayed when the server responds to the request. Thus, a session 
being tracked by cookies with a long maximum age can persist over long periods of time, even when the 
computer has been shut down and restarted. (Many web sites will remember you on the same computer 
using the same browser over days, months, and even years.) 


5.4.8.4.1.1 Interesting code fragments 


Beginning of the doGet method 
Listing 1 (p. 2883) shows the beginning of the controlling class and the beginning of the doGet method. 
You have seen code like this before, so I won’t discuss it further in this module. 


Listing 1 . Beginning of the doGet method. 


public class Java4570a extends HttpServlet{ 
public void doGet (HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, I0Exceptionf{ 


Table 5.128 


Construct a unique session ID 
Listing 2 (p. 2883) constructs a unique session ID that is later written into a cookie on the browser. 


Listing 2 . Construct a unique session ID. 


String uid = new java.rmi.server.UID() .toString() ; 
String sessionID = java.net.URLEncoder. encode (uid); 


Table 5.129 


A UID object 

The first step is to get a String representation of a UID object. According to the documentation, 
the UID classisan "Abstraction for creating identifiers that are unique with respect to the host on which 
it is generated." 

Some cleanup is required 

The second step is to call the encode method of the URLEncoder class to convert the string 
into a MIME format called the "x-www-form-urlencoded" format. This ensures that the identifier can be 
reliably transmitted between the server and the client and that it will contain only those characters that are 
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acceptable for saving in a cookie (see documentation on the setValue method of the Cookie class 
for more information) . 
To convert the String , each character is examined and modified as follows: 


e The ASCII characters ’a’ through ’z’, °A’ through ’Z’, and ’0’ through ’9’ remain the same. 

e The space character is converted into a plus sign ’+’. 

e All other characters are converted into the 3-character string "%xy", where xy is the two-digit hex- 
adecimal representation of the lower 8-bits of the character. 


A typical session identifier created by this process might appear as follows: 

1ece64%3Ad69878ccfO%3A-7H9O 

Get all of the cookies into an array of type Cookie 

Listing 3 (p. 2884) calls the getCookies method of the incoming HttpServletRequest object to 
get and save the cookies submitted by the browser. The values of the cookies will be displayed later. 


Listing 3 . Get all of the cookies into an array of type Cookie. 


Cookie[] cookies = request.getCookies() ; 


Table 5.130 


Get and save submitted value 
As in the sample programs in earlier modules, Listing 4 (p. 2884) gets and saves the field value submitted 
by the client. 


Listing 4 . Get and save submitted value. 


String name = request .getParameter ("firstName"); 
response.setContentType("text/html") ; 


Table 5.131 


Listing 4 (p. 2884) also establishes the type of output. 
Create a new session ID cookie 

Because cookies are sent to the browser using HTTP headers, they should be added to the response 
before you send any content. 

If no cookies were submitted by the client with the request, this is interpreted by this servlet to be the 
beginning of the session. A new Cookie object is instantiated containing the session ID value created 
above along with the name of the cookie: sessionID 

Then the cookie is sent to the client’s browser by calling the addCookie method on the outgoing 
HttpServletResponse object as shown in Listing 5 (p. 2885) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2879 


Listing 5 . Create a new session ID cookie. 


if (cookies == null){ 
Cookie newCookie = new Cookie("sessionID",sessionID) ; 
response. addCookie (newCookie) ; 

}//end if 


PrintWriter out = response.getWriter(); 


Table 5.132 


Listing 5 (p. 2885) also gets an output stream using code that you have seen in earlier modules. 

Create, name, and populate a new Cookie object 

Listing 6 (p. 2885) instantiates a Cookie object containing the field value submitted by the client and 
sends that cookie back to the browser for storage. 


Listing 6 . Create, name, and populate a new Cookie object. 


if(mame != null){ 
String cookieName = "" + new Date().getTime(); 
Cookie newCookie = new Cookie(cookieName, name); 
newCookie. setMaxAge (60) ; 
response. addCookie (newCookie) ; 

}//end if 


Table 5.133 


Unique names for cookies 

Unless delineated by path information, each cookie needs a unique name in addition to its value. Assuming 
that successive calls to this servlet will be separated in time by at least one millisecond, unique names can 
be created by using the current date and time in milliseconds. That mechanism was used in Listing 6 (p. 
2885) to create unique cookie names. The getTime method of the Date class returns the date and time 
in milliseconds represented by a Date object. The Date object in Listing 6 (p. 2885) encapsulates the 
current date and time. You can see those times represented in milliseconds in the list of cookies in Image 1 
(p. 2876) . 

On the other hand, a servlet that creates two or more Cookie objects could easily create more than one 
cookie during each one-millisecond interval. In that case, you should probably use something like the code 
in Listing 2 (p. 2883) to create unique cookie names. 

Familiar code 

Listing 7 (p. 2886) contains code that is very similar to code discussed in earlier modules, so I won’t 

discuss it further here. The fragment is being included here for continuity. 
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Listing 7 . Familiar code. 


//Construct an html form and send it back to the client 
out.printin("<html>") ; 
out.println("<head><title>Java4570a</title></head>") ; 
out .printin("<body>") ; 


//Substitute the name of your server in 
// the following statement. 
out.println("<form method=’get’ action=" 

+ "http://localhost :8080/Java4570a’ >"); 
out .println("<p>Enter a name and press the button</p>"); 
out.printiln("<p>Name: <input type=’text’ name=" 

+ "?firstName’/></p>"); 
out.println("<input type=’submit’ value=" 
+ "Submit Name’?/>"); 
out .printl1n( 
"<br/><br/>Your session ID and list of names is:<br/>"); 
if (name == null){ 
out .println("Empty<br/>") ; 
}//end if 


Table 5.134 


Get and display cookie names and values 

Listing 8 (p. 2886) calls the getName and getValue methods of the Cookie class to get and 
display the names and values of each of the cookies saved earlier in the array of cookies. 

The first value displayed should be the session ID that was stored in the first cookie saved. The remaining 
items in the list should be the field input values previously submitted by the user each time the servlet was 
called but not including the field input value for this invocation of the servlet. 


Listing 8 . Get and display cookie names and values. 


if(cookies != null){ 
for(int i = 0; i < cookies.length; i++){ 
out .println(cookies[i].getName() + ":" + 
cookies[i].getValue() + "<br/>"); 
}//end for loop 
}//end if 


Table 5.135 


The output from Listing 8 (p. 2886) is shown by the sessionID line and the lines for Tom and Dick in 
Image 1 (p. 2876) . (The output from Listing 8 (p. 2886) does not include the line for Harry.) The large 
numeric values to the left of Tom and Dick are the cookie names based on the number of milliseconds since 
January 1, 1970. 

Display currently submitted field value 
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Listing 9 (p. 2887) displays the field value (Harry) submitted by the user for the current invocation of 
the servlet. This value is displayed at the end of the list as shown in Image 1 (p. 2876) . Note that there is 
no cookie name associated with Harry in Image 1 (p. 2876) . This value was not extracted from a named 
cookie for display. However, it will be displayed with a cookie name if the user calls the servlet again with 
a new field value before the cookie with the value Harry expires. 


Listing 9 . Display currently submitted field value. 


if(mame != null){ 
out.printin(name + "<br/>"); 
}//end if 


Table 5.136 


The remaining code is typical of what you have seen in earlier modules. You can view that code in Listing 
10 (p. 2889) . 


5.4.8.4.2 The JSP program 


If you understand the explanation of the servlet code given above and you have understood the explanations 
of JSP code provided in earlier modules, you should have no difficulty understanding the JSP code provided 
in Listing 11 (p. 2891) . Therefore, I won’t bore you with a detailed explanation of that code. The JSP 
code is provided simply for comparison with the servlet code. 

However, there is one point that is worth noting. If you compare Image 2 (p. 2880) showing the JSP 
output with Image 1 (p. 2876) showing the servlet output, you will see that the JSP output contains an 
extra cookie named JSESSIONID . This is a unique session ID value that is automatically created by 
the JSP container. When writing servlets, you need to take the necessary steps to create a unique session 
ID. However, when writing JSP, that task is handled automatically for you so there is no need to create your 
own unique session ID. 


5.4.8.5 Run the programs 


I encourage you to copy the code from Listing 10 (p. 2889) and Listing 11 (p. 2891) . Install the programs 
on your server. Experiment with the code, making changes, and observing the results of your changes. Make 
certain that you can explain why your changes behave as they do. 


5.4.8.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4570: Session Tracking using Cookies 
e File: Java4570.htm 
e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 
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I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 
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5.4.8.7 Complete program listing 


Listing 10 . The servlet program named Java4570a.java. 


/*File Java4570a.java, Copyright 1999, R.G.Baldwin 
Rev 12/24/13 

The purpose of this program is to illustrate session 
tracking through the use of cookies. 


Each time the servlet is called, it displays an html 
form on the client screen. The form contains: 

An input field for submitting a name 

A submit button 

A list of previously submitted names 


The first time the servlet is called, it creates a 
unique session ID and stores it in a cookie on the browser. 


Each time the servlet is called, it creates a cookie 
containing the name submitted by the user and stores it 

on the browser. 

aKa 3K 3K 3K 3K 3k ak ak ak ak ak aK ak aK aK 3K 3K 3K 3K 3K O I II I I I I I III aK I I 3K 3K 3K 3K K a a 3K ÞK ÞK ÞK ÞK ÞK 2k 2k 2k 2k 3k a / 
import java.io.*; 

import java.util.*; 

import javax.servlet.*; 

import javax.servlet.http.*; 


public class Java4570a extends HttpServlet{ 
public void doGet (HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, I0Exceptionf{ 


//Get a unique ID to be used to construct a session ID 
String uid = new java.rmi.server.UID() .toString() ; 
//Encode any special characters that may be in the uid 
// to construct the session ID 

String sessionID = java.net.URLEncoder. encode (uid); 


//Get and save the cookies submitted with the request 
Cookie[] cookies = request.getCookies() ; 


//Get the submitted name for the current get request 
String name = request .getParameter ("firstName"); 


//Establish the type of output 
response.setContentType("text/html") ; 


//If no cookies were submitted with the request, 
// create and add a cookie containing the session ID 
if (cookies == null){ 
Cookie newCookie = new Cookie("sessionID",sessionID) ; 
response. addtaseleelen dpe abic@pexions <http: //enx. org/content /coll1441/1. 181> 
}//end if 


//Get an output stream 


telly o dc. gh E E dip Pe! A n ea Yap ht gr 
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Table 5.137 
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Listing 11 . The JSP program named Java4570b.jsp. 


<%@ page import=’java.util.*,java.io.*? %> 


<html> 
<head><title>Java4570b</title></head> 
<body> 


<h 
String uid = new java.rmi.server.UID() .toString() ; 
String sessionID = java.net.URLEncoder.encode(uid) ; 


Cookie[] cookies = request.getCookies() ; 
String name = request .getParameter ("firstName"); 


response.setContentType("text/html") ; 


if (cookies == null){ 
Cookie newCookie = new Cookie("sessionID",sessionID) ; 
response. addCookie(newCookie) ; 

}//end if 


if(mame != null){ 
String cookieName = "" + new Date().getTime(); 
Cookie newCookie = new Cookie(cookieName, name); 
newCookie. setMaxAge (60) ; 
response. addCookie (newCookie) ; 
}//end if 
A> 


<form method=’ get’ 

action=’http://localhost :8080/Java4570b. jsp’ > 
<p>Enter a name and press the button</p> 
<p>Name: <input type=’text’ name=’firstName’/></p> 
<input type=’submit’ value=’Submit Name’/> 


<br/><br/>Your session ID and list of names is:<br/> 


<h 
if(mame == null){ 
out. printin("Empty<br/>") ; 
}//end if 
if(cookies != null){ 
for(int i = 0; i < cookies.length; i++){ 
out .println(cookies[i].getName() + ":" + 
cookies[i].getValue() + "<br/>"); 
}//end for loop 
}//end if 
if (name != nuAdaithble for free at Connexions <http://cnx.org/content /coll1441/1.181> 
out.printin(name + "<br/>"); 
}//end if 
h> 


</form></body></html> 
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Table 5.138 


-end- 
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5.4.9 Java4570r-Review ” 
5.4.9.1 Table of Contents 


e Preface (p. 2893) 
e Questions (p. 2893) 


1 (p. 2893) , 2 (p. 2893) , 3 (p. 2893) , 4 (p. 2893) , 5 (p. 2894) , 6 (p. 2894) , 7 (p. 2894) , 8 
(p. 2894) , 9 (p. 2894) , 10 (p. 2894) , 11 (p. 2894) , 12 (p. 2895) , 13 (p. 2895) 


e Answers (p. 2896) 
e Miscellaneous (p. 2898) 


5.4.9.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4570: Session Tracking 
using Cookies !?4 in the Servlets sub-collection. 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


5.4.9.3 Questions 
5.4.9.3.1 Question 1 


True or False? 

Cookies are information that is created by a web application and stored on the HTTP server. Under 
certain conditions, this information is retrieved and used by the HTTP server whenever a request is sent 
from the client to the server. 

Go to answer 1 (p. 2897) 


5.4.9.3.2 Question 2 


True or False? 

Cookies are widely used by various server-side programming techniques for session tracking. Java provides 
classes and methods designed to allow you to use cookies in your servlets. 

Go to answer 2 (p. 2897) 


5.4.9.3.3 Question 3 


True or False? 
Any HTTP server can obtain cookies from a browser regardless of the server that created the cookie. 
Go to answer 3 (p. 2897) 


5.4.9.3.4 Question 4 


True or False? 
By default, a cookie expires 24 hours after it is created. 
Go to answer 4 (p. 2897) 


123This content is available online at <http://cnx.org/content /m49593/1.2/>. 
24h ttp://cnx.org/content /m48571 /latest /?collection=col11441/latest 
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5.4.9.3.5 Question 5 


True or False? 

The setMaxAge method can be called to override the default and specify the maximum age of a cookie 
in minutes. The cookie will expire when the maximum age has been reached. 

Go to answer 5 (p. 2897) 


5.4.9.3.6 Question 6 


True or False? 

The setMaxAge method can be called to override the default and specify the maximum age of a cookie 
in seconds. The parameter to the setMaxAge method is an int so the maximum age of a cookie can be 
years. 

Go to answer 6 (p. 2897) 


5.4.9.3.7 Question 7 


True or False? 

The setComment method can be used to provide a comment with the cookie. The browser may elect 
to make this information available to the user. 

Go to answer 7 (p. 2897) 


5.4.9.3.8 Question 8 


True or False? 

The constructor sets the name and value of a cookie when the Cookie object is instantiated. The 
set Value method can be used to assign a new value to the cookie after it is instantiated. 

Go to answer 8 (p. 2897) 


5.4.9.3.9 Question 9 


True or False? 

The JavaCookie class represents a cookie that can be used for session management with the HTTP 
protocol. 

Go to answer 9 (p. 2897) 


5.4.9.3.10 Question 10 


True or False? 
Each cookie has a name and a single value (a name::value pair) . It may have optional attributes, 
including: 


e A comment 

e Path and domain qualifiers to specify which hosts can see the cookie 
e AA maximum age 

e A version. 


Go to answer 10 (p. 2896) 


5.4.9.3.11 Question 11 


True or False? 

Servers assign cookies, using fields added to HTTP response headers. In the Java API, cookies are 
saved one at a time into HTTP response headers, using the addCookie method. 

Go to answer 11 (p. 2896) 
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5.4.9.3.12 Question 12 


True or False? 
Cookies are passed from the browser to the server using fields added to HTTP request headers. 
In the Java API, HTTP cookies are retrieved, one at a time, using the getCookies method. 
Go to answer 12 (p. 2896) 


5.4.9.3.13 Question 13 


True or False? 

Because cookies are sent to the browser using HTTP headers, they should be added to the response 
before you send any content. 

Go to answer 13 (p. 2896) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None KEX] 


Display your nami 


This image was also inserted for the purpose of inserting space between the questions and the answers. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2890 CHAPTER 5. INEW 2338 ADVANCED JAVA (WEB) 


Prob05a.jpg 
Put your name here 


5.4.9.4 Answers 
5.4.9.4.1 Answer 13 
True. 
Go back to Question 13 (p. 2895) 
5.4.9.4.2 Answer 12 


False. 

Cookies are passed from the browser to the server using fields added to HTTP request headers. 

In the Java API, HTTP cookies are retrieved using the getCookies method. This method returns all 
of the cookies found in the request sent by the client. 

Go back to Question 12 (p. 2895) 


5.4.9.4.3 Answer 11 
True. 

Go back to Question 11 (p. 2894) 
5.4.9.4.4 Answer 10 


True. 
Go back to Question 10 (p. 2894) 
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5.4.9.4.5 Answer 9 


False. The Cookie class represents a cookie that can be used for session management with the HTTP 
protocol. 
Go back to Question 9 (p. 2894) 


5.4.9.4.6 Answer 8 
True. 

Go back to Question 8 (p. 2894) 
5.4.9.4.7 Answer 7 
True. 

Go back to Question 7 (p. 2894) 
5.4.9.4.8 Answer 6 
True. 

Go back to Question 6 (p. 2894) 
5.4.9.4.9 Answer 5 


False. The setMaxAge method can be called to override the default and specify the maximum age of a 
cookie in seconds. The cookie will expire when the maximum age has been reached. 
Go back to Question 5 (p. 2894) 


5.4.9.4.10 Answer 4 


False. By default, a cookie expires when the browser exits 
Go back to Question 4 (p. 2893) 


5.4.9.4.11 Answer 3 


False. 

By default, cookies are sent only to the host that caused them to be saved. Methods can be called to set 
attributes for each cookie that determine which servers will receive the cookie. For example, the setDomain 
method can be used to specify a domain pattern indicating which servers should receive a cookie. 

By default, cookies are sent to the page that set the cookie and to all the pages in that directory or under 
that directory. This also can be modified by calling the setPath method on the cookie. 

Go back to Question 3 (p. 2893) 


5.4.9.4.12 Answer 2 
True. 
Go back to Question 2 (p. 2893) 


5.4.9.4.13 Answer 1 


False. Cookies are information that is created by a web application and stored on the client machine by 
the browser. Under certain conditions, this information is sent to the HTTP server whenever a request is 
sent from the client to the server. 

Go back to Question 1 (p. 2893) 
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5.4.9.5 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4570r-Review 
e File: Java4570r.htm 

e Published: 03/10/14 

e Revised: 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 

I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 

In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


5.4.10 Java4580: Session Tracking using the Session Tracking APT” 
5.4.10.1 Table of Contents 
e Preface (p. 2898) 
Viewing tip (p. 2899) 
x Images (p. 2899) 
x Listings (p. 2899) 
e General background information (p. 2899) 


Introduction (p. 2899) 
Program output (p. 2900) 
The HttpSession Interface (p. 2927) 


Discussion and sample code (p. 2930) 
Run the program (p. 2937) 
Miscellaneous (p. 2938) 

Complete program listing (p. 2939) 


5.4.10.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. The purpose of this module is to explain session tracking using 
a servlet and the session tracking API . 


125This content is available online at <http://cnx.org/content /m48579/1.4/>. 
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5.4.10.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the images and listings while you are reading about them. 


5.4.10.2.1.1 Images 


e Image 1 (p. 2903) . Output from access #1. 
e Image 2 (p. 2907) . Output from access #2. 
e Image 3 (p. 2911) . Output from access #3. 
e Image 4 (p. 2915) . Output from access #4. 
e Image 5 (p. 2919) . Output from access #5. 
e Image 6 (p. 2923) . Output from access #6. 
e Image 7 (p. 2927) . Output from access #7. 


5.4.10.2.1.2 Listings 


e Listing 1 (p. 2928) . Beginning of the doGet method. 

e Listing 2 (p. 2928) . Get the session object. 

e Listing 3 (p. 2931) . Get an output stream. 

e Listing 4 (p. 2932) . A hit counter. 

e Listing 5 (p. 2932) . Insert a Date object into the session. 
e Listing 6 (p. 2933) . An object of type MyClass. 

e Listing 7 (p. 2933) . Display information about the session. 
e Listing 8 (p. 2934) . Display information about the objects. 
e Listing 9 (p. 2936) . The inner class named MyClass. 

e Listing 10 (p. 2939) . The servlet named Java4580a.java. 


5.4.10.3 General background information 
5.4.10.3.1 Introduction 


This is the fourth in a series of modules designed to show you how to implement session tracking using 
servlets. As mentioned earlier, the purpose of this module is to illustrate session tracking using the session 
tracking API . 

Earlier modules have illustrated three different ways to implement session tracking with servlets 


e hidden fields 
e URL rewriting 
e cookies 


A higher-level approach to session tracking 

The servlet programs in those earlier modules were written at a fairly low level. The session tracking 
API allows you to program at a somewhat higher level. Before you get too excited, however, be aware that 
this may or may not be the answer to your needs. In some cases, depending on the server involved, you 
may find that the session tracking API relies exclusively on cookies. If that is the case with your server and 
if your clients don’t allow cookies, then the API may not meet your needs. You may find yourself back at 
square one — hidden fields or URL rewriting . 

The HttpSession interface 

The capability that I have referred to as the session tracking API is primarily based on the HttpSession 
interface that I will discuss later. It also includes some other interfaces and classes as well. 
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5.4.10.3.2 Program output 


Image 1 (p. 2903) through Image 7 (p. 2927) show the output produced by the servlet named Java4580a 
for each of the first seven times it is accessed by the same browser. You might just want to glance over these 
images now. I will refer back to them and explain their meaning throughout the discussion of the servlet. 


[a] Java4580a 
€ > C ff D localhost:8080/Java4580a 


Event 
In valueBound method 
Name = MyClassObj 


Session Characteristics: 

New Session: true 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session.StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:05:05 CST 2013 


Session Data: 

counter: 1 

1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.CoyoteWriter@ 1d0bc9e9 
MyClassObj: This is a MyClass object 
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[a] Java4580a 
€ > C fi D localhost:8080/Java4580a 


Event 
In valueBound method 
Name = MyClassObj 


Session Characteristics: 

New Session: true 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session.StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:05:05 CST 2013 


Session Data: 

counter: 1 

1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
MyClassObj: This is a MyClass object 
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[a] Java4580a 
€ > C fi D localhost:8080/Java4580a 


Event 
In valueBound method 
Name = MyClassObj 


Session Characteristics: 

New Session: true 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session.StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:05:05 CST 2013 


Session Data: 

counter: 1 

1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
MyClassObj: This is a MyClass object 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2897 


Image 1 . Output from access #1. 


[a] Java4580a 
€ > C ff D localhost:8080/Java4580a 


Event 
In valueBound method 
Name = MyClassObj 


Session Characteristics: 

New Session: true 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:05:05 CST 2013 


Session Data: 

counter: 1 

1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
MyClassObj: This is a MyClass object 


Table 5.139 
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[a] Java4580a 
€ > C fi D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:05:05 CST 2013 


Session Data: 

counter: 2 

1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
MyClassObj: This is a MyClass object 
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[a] Java4580a 
€ > C fi D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:05:05 CST 2013 


Session Data: 

counter: 2 

1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
MyClassObj: This is a MyClass object 
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[a] Java4580a 
€ > C fi D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:05:05 CST 2013 


Session Data: 

counter: 2 

1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
MyClassObj: This is a MyClass object 
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Image 2 . Output from access #2. 


[a] Java4580a 
€ > C f D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:05:05 CST 2013 


Session Data: 

counter: 2 

1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
MyClassObj: This is a MyClass object 


Table 5.140 
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[a] Java4580a 
€ > C fi D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:06:24 CST 2013 


Session Data: 

counter: 3 

1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
MyClassObj: This is a MyClass object 

1388462831954: Mon Dec 30 22:07:11 CST 2013 
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[a] Java4580a 
€ > C fi D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:06:24 CST 2013 


Session Data: 

counter: 3 

1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
MyClassObj: This is a MyClass object 

1388462831954: Mon Dec 30 22:07:11 CST 2013 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2904 CHAPTER 5. INEW 2338 ADVANCED JAVA (WEB) 


[a] Java4580a 
€ > C fi D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:06:24 CST 2013 


Session Data: 

counter: 3 

1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
MyClassObj: This is a MyClass object 

1388462831954: Mon Dec 30 22:07:11 CST 2013 
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Image 3 . Output from access #3. 


[a] Java4580a 
€ > C f D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 81S5FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:06:24 CST 2013 


Session Data: 

counter: 3 

1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
MyClassObj: This is a MyClass object 

1388462831954: Mon Dec 30 22:07:11 CST 2013 


Table 5.141 
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[a] Java4580a 
€ > Œ fi |D localhost:8080/Java4580a 


Event 
In valueUnbound method 
Name = MyClassObj 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:07:11 CST 2013 


Session Data: 

counter: 4 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 
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[a] Java4580a 
€ > C fi D localhost:8080/Java4580a 


Event 
In valueUnbound method 
Name = MyClassObj 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:07:11 CST 2013 


Session Data: 

counter: 4 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 
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[a] Java4580a 
€ > Œ fi |D localhost:8080/Java4580a 


Event 
In valueUnbound method 
Name = MyClassObj 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:07:11 CST 2013 


Session Data: 

counter: 4 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 
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Image 4 . Output from access 74. 


[a] Java4580a 
€ > C ff D localhost:8080/Java4580a 


Event 
In valueUnbound method 
Name = MyClassObj 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:07:11 CST 2013 


Session Data: 

counter: 4 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 


Table 5.142 
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[a] Java4580a 
€ > Œ fi |D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:07:56 CST 2013 


Session Data: 

counter: 5 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462921409: Mon Dec 30 22:08:41 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 
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[a] Java4580a 
€ > C fi D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:07:56 CST 2013 


Session Data: 

counter: 5 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462921409: Mon Dec 30 22:08:41 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 
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[a] Java4580a 
€ > Œ fi |D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:07:56 CST 2013 


Session Data: 

counter: 5 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462921409: Mon Dec 30 22:08:41 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 
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Image 5 . Output from access #5. 


[a] Java4580a 
€ > C f D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 81S5FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:07:56 CST 2013 


Session Data: 

counter: 5 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462921409: Mon Dec 30 22:08:41 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 

out: org.-apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 


Table 5.143 
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[a] Java4580a 
€ > Œ fi |D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:08:41 CST 2013 


Session Data: 

counter: 6 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462921409: Mon Dec 30 22:08:41 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 
1388462972243: Mon Dec 30 22:09:32 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2915 


[a] Java4580a 
€ > C fi D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:08:41 CST 2013 


Session Data: 

counter: 6 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462921409: Mon Dec 30 22:08:41 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 
1388462972243: Mon Dec 30 22:09:32 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 
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[a] Java4580a 
€ > Œ fi |D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:08:41 CST 2013 


Session Data: 

counter: 6 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462921409: Mon Dec 30 22:08:41 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 
1388462972243: Mon Dec 30 22:09:32 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2917 


Image 6 . Output from access #6. 


[a] Java4580a 
€ > C f D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 81S5FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:08:41 CST 2013 


Session Data: 

counter: 6 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462921409: Mon Dec 30 22:08:41 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 
1388462972243: Mon Dec 30 22:09:32 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 


Table 5.144 
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[a] Java4580a 
€ > Œ fi |D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 81SFDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:09:32 CST 2013 


Session Data: 

counter: 7 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462921409: Mon Dec 30 22:08:41 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 
1388462972243: Mon Dec 30 22:09:32 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 
1388463023739: Mon Dec 30 22:10:23 CST 2013 
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[a] Java4580a 
€ > C fi D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina.session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:09:32 CST 2013 


Session Data: 

counter: 7 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462921409: Mon Dec 30 22:08:41 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 
1388462972243: Mon Dec 30 22:09:32 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 
1388463023739: Mon Dec 30 22:10:23 CST 2013 
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[a] Java4580a 
€ > Œ fi |D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 81SFDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:09:32 CST 2013 


Session Data: 

counter: 7 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462921409: Mon Dec 30 22:08:41 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 
1388462972243: Mon Dec 30 22:09:32 CST 2013 

out: org.apache.catalina.connector.Coyote Writer@ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 
1388463023739: Mon Dec 30 22:10:23 CST 2013 
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Image 7 . Output from access 77. 


[a] Java4580a 


€ > C fi |D localhost:8080/Java4580a 


Session Characteristics: 

New Session: false 

Session ID: 815FDAF004D201D2EA672A0E9BEE468E 

Session Context: org.apache.catalina session. StandardSessionContext@4cb2018c 
Creation Time: Mon Dec 30 22:05:05 CST 2013 

Last Accessed: Mon Dec 30 22:09:32 CST 2013 


Session Data: 

counter: 7 

1388462876283: Mon Dec 30 22:07:56 CST 2013 
1388462921409: Mon Dec 30 22:08:41 CST 2013 
1388462705670: Mon Dec 30 22:05:05 CST 2013 
1388462972243: Mon Dec 30 22:09:32 CST 2013 

out: org.apache.catalina.connector.Coyote Writer @ 1d0bc9e9 
1388462784494: Mon Dec 30 22:06:24 CST 2013 
1388462831954: Mon Dec 30 22:07:11 CST 2013 
1388463023739: Mon Dec 30 22:10:23 CST 2013 


Table 5.145 


5.4.10.3.3 The HttpSession Interface 


I will explain the code in this servlet in fragments. A complete listing of the servlet is provided in Listing 
10 (p. 2939) . 

Beginning of the doGet method 

Listing 1 (p. 2928) shows typical code for beginning the definition of a servlet class and for beginning 
the definition of the doGet method. You have seen code like this in earlier modules so I won’t discuss it 
further in this module. 
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Listing 1 . Beginning of the doGet method. 


import java.io.*; 
import java.util.*; 
import javax.servlet.*; 
import javax.servlet.http.*; 


public class Java4580a extends HttpServletf{ 
public void doGet (HttpServletRequest request, 


HttpServletResponse response) 
throws ServletException, I0Exceptionf{ 


Table 5.146 


Get the session object 

I will continue the discussion with the code fragment shown in Listing 2 (p. 2928) , where request isa 
reference to the standard object of type HttpServletRequest passed tothe doGet method that begins 
in Listing 1 (p. 2928) . 


Listing 2 . Get the session object. 


HttpSession session = request.getSession(true) ; 


Table 5.147 


An object of type HttpSession 
The call to the getSession method in Listing 2 (p. 2928) returns a reference to an object of the 
interface type HttpSession . As you can see, the reference is saved in the local variable named session 


The HttpSession object provides an association (a session) between an HTTP client and an HTTP 
server. This association, or session, persists over multiple connections and/or requests during a given time 
period. Sessions are used to maintain state and user identity across multiple page requests. 

How is the session maintained? 

Apparently the manner in which the association between the client and the server (the session) is 

maintained varies from one server to the next. One books states, 


"A session can be maintained either by using cookies or by URL rewriting." 


Another book states that the minimum requirement for servers is to maintain the session using cookies, and 
that the server may optionally support URL rewriting as well. There are inferences in other books to the 
effect that some servers may not support URL rewriting. 

The HttpSession object 

The HttpSession object returned by the code in Listing 2 (p. 2928) behaves as a container for the 
storage of: 


e Information about the session 
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e Data (objects) that persist from one call to the servlet to the next call to the servlet by the same 
client. 


Client ID is transparent 

The requirement to maintain the identification of each individual client is transparent to the programmer. 
That information is encapsulated in the HttpSession object and the process that backs it up. 

The lifetime of a session 

An HttpSession object represents an ongoing session with a particular client. The actual lifetime of 
a session isn’t clear in the books that I have read. 

The books seems to imply that the session can remain active over long periods of time. However, on my 
local Tomcat server, the session ends when the browser is terminated. The behavior is similar to that which 
occurs with the default behavior 1° of cookies that expire when the browser exits. 


(Recall however, the setMaxAge method can be called on a cookie to cause it to persist 
beyond the current active period of the browser. Browsers save long-life cookies from one active 
period to the next. There may be some way to accomplish that using the session tracking API 
as well but that is speculation on my part.) 


On my server, the session continues until 


e The client exits the browser 
e The servlet purposely invalidates the session 
e The server invalidates the session due to timeout or other condition 


Maintaining session state 

All that the programmer has to do to maintain session state is to put objects into the HttpSession 
object, and to get objects from the HttpSession object. 

The programmer can also get information about the session from the HttpSession object as well. 

Name::value pairs 

Data objects are stored in the HttpSession object using a dictionary-like interface. Each object stored 
in the HttpSession object is stored under a String name. Data objects are retrieved under the name 
associated with the object. (This is another case of using name::value pairs.) 

The fact that the data objects may actually be stored on the client machine (possibly in cookies) is 
transparent to the programmer. 

Is the data stored in cookies? 

With my local Tomcat server, the fact that the data objects are being stored in cookies on the client 
machine can be verified by setting the browser preferences to disallow the use of cookies. This results in 
the counter value that I will explain later never progressing beyond that shown in Image 1 (p. 2903) . This 
indicates that the servlet is unable to establish a session when cookies are disabled. 

Events 

If you instantiate your data objects from classes of your own design, you can process events that are 
generated whenever the object is put in or removed from the HttpSession object. In order to be able to 
receive events, your classes must implement the HttpSessionBindingListener interface. 


(I also believe, but am not certain, that in order for the objects instantiated from your classes 
to be eligible for being saved in the session object, your classes must implement the Serializable 
interface. This makes it possible to decompose an object into a stream of bytes and to reconstruct 
those bytes into an object later.) 


Event handlers 
When a data object of a class that implements the HttpSessionBindingListener interface is put into 
the HttpSession object, the following method is called on the data object: 


26http://cnx.org/content /m48571/latest/##What_are_ cookies 
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valueBound(HttpSessionBindingEvent e) 
When a data object of a class that implements the HttpSessionBindingListener interface is removed 
from the HttpSession object, the following method is called on the data object: 
value Unbound (HttpSessionBindingEvent e) 
No registration is required 
Unlike the typical case in Java programming, no special registration of the event listener is required. 
Simply implementing the interface on the object is sufficient to cause it to receive events when it is put into 
or removed from the HttpSession object. You can define those two methods to provide whatever behavior 
may be needed when the events occur. 
The isNew method 
An implementation of HttpSession represents the server’s view of the session. The server considers 
a session to be new until the client has joined it. Until the client joins the session, the isNew method 
returns true. 
A value of true can indicate one of the following three cases: 


e The client does not yet know about the session 
e The session has not yet begun 
e The client chooses not to join the session. 


The third case will occur if the server supports only cookies and the client chooses to reject cookies sent by 
the server (the client has disabled cookies on the browser) . 

URL rewriting 

According to the some books, the third case will not commonly occur, if the server supports URL 
rewriting. However, according to one of my books, even if the server supports URL rewriting, that capability 
is not freely available. The programmer must provide special programming constructs to take advantage of 
URL rewriting. 

In any event, it is the responsibility of the programmer to design the application to account for situations 
where a client has not joined a session. 


5.4.10.4 Discussion and sample code 


Now that you have the background information under your belt, let’s take a look at a sample program. 

The name of the servlet that I will explain in this module is Java4580a . As mentioned earlier, I will 
explain this program in fragments. A complete listing is provided in Listing 10 (p. 2939) . 

Beginning of the servlet program 

The program begins in the typical manner shown earlier in Listing 1 (p. 2928) . Then the program gets a 
valid HttpSession object for the current request from the client as shown by the call to the getSession 
method in Listing 2 (p. 2928) . 

What does Oracle have to say? 

Here is some of what Oracle has to say about the getSession method, where create is the name of 
the boolean parameter passed to the method: 


"Returns the current HttpSession associated with this request or, if there is no current 
session and create is true, returns a new session. If create is false and the request 
has no valid HttpSession _, this method returns null. To make sure the session is properly 
maintained, you must call this method before the response is committed." 


Apparently the server identifies the first request of the session by the fact that the browser doesn’t send a 
cookie (or the URL hasn’t been rewritten) , but that is just speculation on my part. 

Get an output stream 

An output stream is needed in order for the servlet to send content to the client browser. An output 
stream object is created and saved in the session object, thus making it available for as long as the session 
is active. 
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You are already familiar with the first statement in Listing 3 (p. 2931) , so nothing more needs to be 
said about that statement. 

Retrieve the stream object from the session object 

Beyond that, the code in Listing 3 (p. 2931) begins by attempting to retrieve an output stream object 
from the session object. 

If the call to the getValue method on the session object returns null, this indicates that an output 
stream has not yet been created and saved in the session object. In that case, an output stream object is 
created and put into the session object where it will be available on subsequent requests to the servlet. 

A reference to the new output stream is also saved in the local variable named out so that it will be 
available during the remainder of the doGet method. This is what happens at the beginning of a new 
session with a specific browser. 


Listing 3 . Get an output stream. 


response.setContentType("text/html") ; 


PrintWriter out = (PrintWriter)session.getValue("out") ; 
if(out == null){ 

//First request from this client 

out = response. getWriter(); 

session. putValue("out", out); 
}//end if 


//Create HTML page header 

out.printin("<html>") ; 
out.println("<head><title>Java4580a</title></head>") ; 
out .printin("<body>") ; 


Table 5.148 


An output stream already exists 

If the call to the getValue method in Listing 3 (p. 2931) returns an output stream, a reference to 
the output stream is saved in the local variable named out . This is what happens in the second and 
subsequent calls to the servlet during an ongoing session with a specific browser. 

Create the HTML header text 

Once the output stream is available, the code in Listing 3 (p. 2931) uses it to create the normal header 
text on the outgoing HTML page. 

A hit counter 

Listing 4 (p. 2932) instantiates a hit counter object and stores it in the session object under the name " 
counter ". If the session doesn’t have a counter , one is created and its value is initialized to 1. If the 
session already has a counter , it is incremented by 1. Then the new or incremented counter is put in 
the session, replacing the one that was already there. 
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Listing 4 . A hit counter. 


Integer cnt = (Integer) session.getValue("counter") ; 


if(cnt == null) cnt = new Integer(1); 
else cnt = new Integer(cnt.intValue() + 1); 
session. putValue("counter", cnt) ; 


Table 5.149 


Note that because an object of the Integer class is immutable, the only way to increment the counter 
is to create anew Integer object to replace the existing one. 

The put Value and get Value methods 

Listing 4 (p. 2932) also illustrates the putValue and getValue methods. These methods are used 
to store and retrieve objects from the session object. The putValue() method requires two parameters: 


e an object to be stored 
e the String name under which the object is to be stored 


The getValue method requires the String name of the object to retrieve. 

Insert a Date object into the session 

As shown in Listing 5 (p. 2932) , each time the servlet is called, a new Date object containing the 
current date and time is instantiated and stored in the session object. 


Listing 5 . Insert a Date object into the session. 


Date theDate = new Date(); 
long millis = theDate.getTime() ; 
String strMillis = "" + millis; 
session. putValue(strMillis,theDate) ; 


Table 5.150 


Each Date object is stored under a name created by converting the current date and time in milliseconds 
toa String . Thus, the amount of data stored in the session object increases with each call to the servlet. 


(Note that if the servlet is called twice by the same client within one millisecond, this naming 
scheme will fail due to duplicate names being created and put into the session object.) 


An object of type MyClass 

When the value of the hit counter is 1, an object of type MyClass is instantiated and stored in the 
session object under the name MyClassObj . This is shown in Listing 6 (p. 2933) . Note in particular 
that a reference to the output stream object is passed to the constructor for the MyClass object. You 
will see why later. 
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Listing 6 . An object of type MyClass. 


if(cnt.intValue() == 1) 
session. putValue("MyClassObj", new MyClass(out)) ; 
if(cnt.intValue() == 4) session.removeValue("MyClassObj") ; 


Table 5.151 


Also as shown in Listing 6 (p. 2933) , this object is removed from the session object when the value of 
the hit counter is 4. 

An HttpSessionBindingEvent event happens when the object is put into the session object and 
happens again when the object is removed from the session object. 

Event handling 

The object of type MyClass is a listener for events of type HttpSessionBindingEvent . Therefore, 
it receives an event notification when it is put into the session object, and receives another event notification 
when it is removed from the session object. Information about the two events is displayed on the client 
screen when the events occur. 

The text at the top of Image 1 (p. 2903) was produced when the MyClass object was put into the 
session. The text at the top of Image 4 (p. 2915) was produced when the object was removed from the 
session. More information about that text will be provided later during the discussion of the class named 
MyClass 

Display information about the session 

The code in Listing 7 (p. 2933) displays several pieces of information about the session each time the 
servlet is called. This information is obtained from the session object by calling various methods on the 
session object. The information is then mixed with standard HTML code and displayed on the client screen 
as shown in Image 1 (p. 2903) through Image 7 (p. 2927) . 


Listing 7 . Display information about the session. 


out .println("<p>Session Characteristics: <br/>"); 
out.println("New Session: " + session.isNew()+ "<br/>"); 
out.println("Session ID: " + session.getId()+ "<br/>"); 
out.println("Session Context: " 
+ session.getSessionContext()+ "<br/>"); 
out.println("Creation Time: " 
+ new Date(session.getCreationTime()) + "<br/>"); 
out.println("Last Accessed: " 
+ new Date(session.getLastAccessedTime()) + "</p>"); 


Table 5.152 


Display information about the objects 

The code in Listing 8 (p. 2934) displays information about each of the objects stored in the session 
object each time the servlet is called. Note that the order of the display of objects doesn’t seem to follow 
any particular pattern. 
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Listing 8 . Display information about the objects. 


out.printin("<p>Session Data: <br/>"); 
String[] names = session.getValueNames() ; 
for(int i = 0; i < names.length; i++){ 
out.println(names[i] + ": " 
+ session.getValue(names[i]) + "<br/>"); 
}//end for loop 


//Finish off the HTML page 
out .printin("</p></body></htm1>") ; 
}//end doGet () 


Table 5.153 


The code in Listing 8 (p. 2934) calls the get ValueNames method to create a String array containing 
the names of each of the objects currently stored in the session object. A for loop then iterates on that 
array, calling the getValue method on each name to get and display each of the objects stored in the 
session object. 


(The code in Listing 8 (p. 2934) also finishes off the web page and signals the end of the doGet 
method.) 


The information that is displayed 
The following information about the objects is displayed in Image 1 (p. 2903) through Image 3 (p. 2911) 


counter information 

information about each of the Date objects 
information about the output stream object 
information about the object of type MyClass . 


Beginning with Image 4 (p. 2915) , the MyClass object is no longer contained in the session object when 
the list is constructed, so only information about the first three items in the above list (p. 2934) is displayed. 
Miscellaneous things worthy of note 
In Image 1 (p. 2903) , you see three types of information being displayed: 


e Event 
e Session Characteristics 
e Session Data 


The Event output resulted from the fact that the object of type MyClass was put into the session 
object. This caused the valueBound method to be called. 

The Session Characteristics show that the creation time and the time last accessed are equal, and 
the session is a new session. 

The Session Characteristics also show the Session ID which has been automatically created for 
this session and the Session Context , which is peculiar to the Tomcat server being used. Neither of 
these will change for the duration of the session. 

The Session Data in Image 1 (p. 2903) shows information on one counter object, one Date object, 
one output stream object, and one object of type MyClass 

Image 1 (p. 2903) through Image 7 (p. 2927) all show the same Session ID and the same Session 
Context 
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(Note that unlike the servlet code in earlier modules, I did not write the code that created the 
session ID.) 


In Image 2 (p. 2907) and Image 3 (p. 2911) , you see only two types of information being displayed: 


e Session Characteristics 
e Session Data 


There is no event output in these two images because the object of type MyClass is neither put into nor 
removed from the session during these calls to the servlet. 

Beginning with Image 2 (p. 2907) , the New Session value shows false. In other words, the session is 
no longer new. 

Beginning with Image 3 (p. 2911) , the Last Accessed time differs from the Creation Time 

The entire sequence of images show a sequence of seven calls to the servlet. Hence, the value of the 
counter increases by one in each succeeding image. Also, the number of objects in the list increases by one 
during each of the first three images. 

Image 4 (p. 2915) shows the screen output for the fourth call to the servlet. This is the call where the 

MyClass object was removed from the session object. Hence an Event occurred showing that the 
valueUnbound method was called. 

The Session Data consists of one counter object, one output stream object, and four Date objects. 
The MyClass object no longer appears in the list because it was removed from the session object before 
the list was constructed. 

Finally, Image 7 (p. 2927) shows the screen output for the seventh call to the servlet. There is no Event 
output and the Session Characteristics are the same as before except for the time last accessed. 

The Session Data consists of one counter object, one output stream object, and seven Date objects. 

The inner class named MyClass 

The code in Listing 9 (p. 2936) defines an inner class named MyClass . It could have been implemented 

as a top-level class but I elected to make it an inner class (actually a member class 1?" ) . 


!27http://cnx.org/content /m44347 /latest /?collection=col11441 /latest 
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Listing 9 . The inner class named MyClass. 


class MyClass implements HttpSessionBindingListener, 
Serializablef{ 
PrintWriter local0ut;//local copy of output stream to client 


public MyClass(PrintWriter out){//constructor 
//Save a local copy of the output stream to the client. 
local0Out = out; 

}//end constructor 


public String toStringQ{ 
return "This is a MyClass object"; 
}//end toString () 


//This method is called when the object is put into 
// the session. 
public void valueBound(HttpSessionBindingEvent e){ 
localOut.printin("<p>Event <br/>") ; 
localOut.printin("In valueBound method<br/>") ; 
//Returns the name of the object as identified when 
// put into the session 
localOut.println("Name = " +e.getName() + "</p>"); 
}//end valueBound () 


//This method is called when the object is removed 

// from the session. 

public void valueUnbound (HttpSessionBindingEvent e){ 
localOut.printin("<p>Event <br/>") ; 
localOut.println("In valueUnbound method<br/>") ; 
localOut.println("Name = " +e.getName() + "</p>"); 

}//end valueUnbound () 

}//end inner class named MyClass 


}//end class Java4580a 


Table 5.154 


Deploying the servlet 
When this program is compiled, it produces the following two class files: 


e Java4580a.class 
e Java4580a$MyClass.class 


The second class file results from the compilation of the member class. 

I mention this as a reminder that it is necessary to copy both of these class files in order to deploy the 
servlet onto a web server. Note however that when deploying on my local Tomcat server, only the information 
about the top level class must be entered into the file named web.xml 

A MyClass object 
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An object of the class named MyClass is instantiated and put into the session object during the first 
call to the servlet when the hit counter equals one. (See Listing 6 (p. 2933) .) The object is removed 
during the fourth call to the servlet when the hit counter equals four. (Again, see Listing 6 (p. 2933) .) 

A listener object 

Because the class implements the HttpSessionBindingListener interface, an object of the class is a 
listener for events of type HttpSessionBindingEvent . An event of this type occurs when the object is 
put into the session object. Another event of this type occurs when the object is removed from the session 
object. 

Event handler methods 

The method named valueBound is called when the object is put into the session object. The method 

named valueUnbound is called when the object is removed from the session object. 
No registration necessary 

Unlike typical Java event programming, it is not necessary to register the listener on a source. Simply 
implementing the HttpSessionBindingListener interface is sufficient to cause the object to be notified 
of the events when an object of the class is put into or removed from the session object. 

An object of type HttpSessionBindingEvent 

When an event occurs, the event handler methods named valueBound and valueUnbound receive 
a reference to an object of type HttpSessionBindingEvent as a parameter. 

In this program, the event handlers call the getName method on the event objects to display infor- 
mation about the events on the client screen when the events occur. This is shown in Image 1 (p. 2903) and 
Image 4 (p. 2915) . Several other methods are available to be called on the event object including: 


get Name 
getSession 
get Value 
get Source 


An overridden toString method 

In addition to the two event handler methods, the MyClass class also overrides the toString method. 
Note that the string returned by the overridden toString method is displayed in Image 1 (p. 2903) through 
Image 3 (p. 2911) to represent the MyClass object that is contained in the session object. 

Event handler behavior 

My objective was to display the name returned by the getName method on the browser screen for 
each event as shown by the third line in Image 1 (p. 2903) and the third line in Image 4 (p. 2915) . In order 
to accomplish this, the code in the event handler methods need access to the output stream object. This 
was accomplished by 


e passing a reference to the output stream object to the MyClass constructor 
e saving that reference in an instance variable of the MyClass object 
e using that reference inside the event handler methods to send content to the browser 


Standard source-listener event handling 

Except for the fact that there is no requirement to register the event listener object on a source, this is 
straightforward source-listener event handling material that you should already be familiar with. 

The code in Listing 9 (p. 2936) also signals the end of the class named Java4590a 


5.4.10.5 Run the program 


I encourage you to copy the code from Listing 10 (p. 2939) . Compile the code and deploy it on your server. 
Experiment with the code, making changes, and observing the results of your changes. Make certain that 
you can explain why your changes behave as they do. 
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5.4.10.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4580: Session Tracking using the Session Tracking API 
e File: Java4580.htm 

e Published: 12/30/13 

e Revised 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 
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Listing 10 . The servlet named Java4580a.java. 


/*File Java4580a.java, Copyright 1999, R.G.Baldwin 
Revised 12/30/13 


This servlet illustrates use of the session tracking API. 

A variety of different aspects of session tracking using 

the API are illustrated. 

FAO OA I IAA EEE EEEE EEEE EEE EE 1 21 21 2k a 4 24 21 EEEE E EE EEE EE E 
import java.io.*; 

import java.util.*; 

import javax.servlet.*; 

import javax.servlet.http.*; 


public class Java4580a extends HttpServletf{ 


public void doGet (HttpServletRequest request, 
HttpServletResponse response) 
throws ServletException, I0Exceptionf{ 


//Get the session associated with this request, 
HttpSession session = request.getSession(true) ; 


response.setContentType("text/html") ; 


//Get the output stream from the session object. 
// If this is the first call to servlet, create an output 
// stream and save it in the session object. 
PrintWriter out = (PrintWriter)session.getValue("out") ; 
if (out == null)f{ 

//First request from this client 

out = response. getWriter(); 

session. putValue("out", out); 
}//end if 


//Create HTML page header 

out.printin("<html>") ; 

out .println("<head><title>Java4580a</title></head>") ; 
out .printin("<body>") ; 


//Create a hit counter for this servlet 

Integer cnt = (Integer)session.getValue("counter") ; 
if(cnt == null) cnt = new Integer(1); 

else cnt = new Integer(cnt.intValue() + 1); 
session. putValue("counter", cnt) ; 


//Add a new Date object each time the servlet i called 

Date theDate = new Date(); 

long millis = theDate.getTime(); 

String strMi 1 Myallablenfor Tee ni Connexions <http://cnx.org/content /col11441/1.181> 
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session.putValue(strMillis,theDate); 


//When the hit counter is 1, instantiate a new object of 
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Table 5.155 


-end- 
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5.4.11 Java4580r-Review 
5.4.11.1 Table of Contents 


e Preface (p. 2941) 
e Questions (p. 2941) 


1 (p. 2941) , 2 (p. 2941) , 3 (p. 2941) , 4 (p. 2942) 


e Answers (p. 2943) 
e Miscellaneous (p. 2944) 


5.4.11.2 Preface 


This module is one in a collection of modules designed for teaching INEW 2338 Advanced Java (Web) 
at Austin Community College in Austin, TX. 

This module contains review questions and answers keyed to the module titled Java4580: Session Tracking 
using the Session Tracking API !”° in the Servlets sub-collection. 

Once you study that module, you should be able to answer the review questions in this module. 

The questions and the answers in this module are connected by hyperlinks to make it easy for you to 
navigate from the question to the answer and back again. 


5.4.11.3 Questions 
5.4.11.3.1 Question 1 


True or False? 
The session tracking API allows you to program at a somewhat higher level than when programming 
for 


e hidden fields 
e URL rewriting 
e cookies 


Go to answer 1 (p. 2943) 


5.4.11.3.2 Question 2 


True or False? 

In some cases, depending on the server involved, the session tracking API may rely exclusively on 
cookies "under the hood." 

Go to answer 2 (p. 2943) 


5.4.11.3.3 Question 3 


True or False? 

The session tracking API is primarily based on the JavaHttpSession interface. It also includes some 
other interfaces and classes as well. 

Go to answer 3 (p. 2943) 


128 This content is available online at <http://cnx.org/content /m49586/1.2/>. 
129http://cnx.org/content /m48579/latest /?collection=col11441/latest 
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5.4.11.3.4 Question 4 


True or False? 

A call to the getSession method of the incoming request object returns a reference to an object of the 
interface type HttpSession 

The HttpSession object provides an association (a session) between an HTTP client and an HTTP 
server. This association, or session, persists over multiple connections and/or requests during a given time 
period. Sessions can be used to maintain state and user identity across multiple page requests. 

Go to answer 4 (p. 2943) 

What is the meaning of the following two images? 

These images were inserted here simply to insert some space between the questions and the answers to 
keep them from being visible on the screen at the same time. 


None 


Display yournam 


This image was also inserted for the purpose of inserting space between the questions and the answers. 
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Prob05a.jpg 
Put your name here 


5.4.11.4 Answers 
5.4.11.4.1 Answer 4 
True. 
Go back to Question 4 (p. 2942) 
5.4.11.4.2 Answer 3 
False. The session tracking API is primarily based on the HttpSession interface. It also includes some 
other interfaces and classes as well. 
Go back to Question 3 (p. 2941) 
5.4.11.4.3 Answer 2 
True. 
Go back to Question 2 (p. 2941) 
5.4.11.4.4 Answer 1 


True. 
Go back to Question 1 (p. 2941) 
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5.4.11.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Java4580r-Review 
e File: Java4580r.htm 

e Published: 03/10/14 

e Revised: 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


5.5 Frameworks 


5.5.1 Java4710: INEW 2338 - Java EE 7 and Frameworks” 
5.5.1.1 Table of Contents 


e Preface (p. 2944) 
e Links to Chapters (p. 2945) 
e Miscellaneous (p. 2945) 


5.5.1.2 Preface 


e This is the main page for links to content on Java EE 7 and Frameworks that are part of the course 
named INEW 2338, Advanced Java at Austin Community College in Austin, TX. 

e The material in the chapters is sequential and is designed for progressive study. Most chapters contain 
material that references concepts and code in prior chapters. 

e Assignments and the section exam are located in Blackboard. 


130This content is available online at <http://cnx.org/content /m49764/1.6/>. 
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5.5.1.3 Links to Chapters 
01 - JDK-WildFly-NetBeans Setup Local?! 


02 - WildFly Setup Remote!*? 

03 - First Servlet!?? 

04 - JSF Tags!*4 

05 - JSF Template Demo!** 

06 - PrimeFaces Component Suite!*6 

07 - XAMPP Setup!°" 

08 - Database Setup!8 

09 - MySQL in WildFly Setup Local!#9 
10 - MySQL in WildFly Setup Remote!?° 
11 - JSF and JDBC! 


12 - JSF-MVC and Spring-MVC!*? 


13 - Glossary!*8 


5.5.1.4 Miscellaneous 


Due to the dynamic nature of the material, the content at the links above is periodically updated and the 
links themselves may change. While you are welcome to print the pages, I recommend bookmarking this 
main page for future reference. Since the links may change, by bookmarking this main page, you will have 
access to the current content and working links. 


I hope you enjoy the course. 


@author R.L. Martinez, Ph.D. 


131 http://www.austincc.edu/rmartin6/coursecontent /inew2338/01-jdk-wildfly-netbeans-setup-local.pdf 
132http://www.austincc.edu/rmartin6/coursecontent /inew2338/02-wildfly-setup-remote.pdf 
133http://www.austincc.edu/rmartin6/coursecontent /inew2338/03-FirstServlet.pdf 
4http://www.austincc.edu/rmartin6/coursecontent /inew2338/04-JSFTags.pdf 
135http://www.austincc.edu/rmartin6/coursecontent /inew2338/05-TemplateDemo.pdf 
136http://www.austincc.edu/rmartin6/coursecontent /inew2338/06-ComponentSuite.pdf 
187http://www.austincc.edu/rmartin6/coursecontent /inew2338/07-X AMPPSetup.pdf 
188http://www.austincc.edu/rmartin6/coursecontent /inew2338/08-DatabaseSetup.pdf 
139http://www.austincc.edu/rmartin6/coursecontent /inew2338 /09-mysql-in-wildfly-setup-local.pdf 
40http://www-austincc.edu/rmartin6/coursecontent /inew2338/10-mysql-in-wildfly-setup-remote.pdf 
'41http://www.austincc.edu/rmartin6/coursecontent /inew2338/11-JSFandJDBC.pdf 

142 http://www.austincc.edu/rmartin6/coursecontent /inew2338/12-JSFMVCandSpringMVC.pdf 
M43http://www.austincc.edu/rmartin6/coursecontent /inew2338/13-Glossary.pdf 
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Chapter 6 


GAME 2302 - Mathematical 
Applications for Game Development 


6.1 Jy0040: GAME2302: Mathematical Applications for Game 
Development’ 


6.1.1 Table of Contents 


e Welcome (p. 2947) 
e Miscellaneous (p. 2947) 


6.1.2 Welcome 


Click the link to view the course material for GAME 2302 Mathematical Applications for Game Development 
2 which I teach at Austin Community College in Austin, TX. 
Official information about the course 
The college website for this course is: http://www-.austincc.edu/baldwin/ 3 . 
As of December 2012, the description for this course reads: 
"GAME 2302 - Mathematical Applications for Game Development 
Presents applications of mathematics and science in game and simulation programming. Includes the 
utilization of matrix and vector operations, kinematics, and Newtonian principles in games and simulations. 
Also covers code optimization." 


6.1.3 Miscellaneous 
This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: GAME2302: Mathematical Applications for Game Development 
e File: Jy0040.htm 
e Published: 01/17/13 


1This content is available online at <http://cnx.org/content /m45680/1.2/>. 
*http://cnx.org/content /col11450 
3http://www.austincc.edu/baldwin/ 
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CHAPTER 6. GAME 2302 - MATHEMATICAL APPLICATIONS FOR GAME 


2942 
DEVELOPMENT 


NOTE: Disclaimers:: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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OOP Self-Assessment 


7.1 Ap0005: Preface to OOP Self-Assessment’ 


7.1.1 Welcome 


Welcome to my group of modules titled OOP Self-Assessment . 

This is a self-assessment test designed to help you determine how much you know about object-oriented 
programming (OOP) using Java. 

In addition to being a self-assessment test, it is also a major learning tool. Each module consists of about 
ten to twenty questions with answers and explanations on two or three specific topics. In many cases, the 
explanations are extensive. You may find those explanations to be very educational in your journey towards 
understanding OOP using Java. 

To give you some idea of the scope of this self-assessment test, when you can successfully answer most of 
the questions in modules Ap0010 ? through Ap0140 ° , your level of knowledge will be roughly equivalent to 
that of a student who has successfully completed an AP Computer Science course in a U.S. high school up 
to but not including data structures. This is based on my interpretation of the College Board’s Computer 
Science A Course Description 4 . 


7.1.2 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Ap0005: Preface to OOP Self-Assessment 
e File: Ap0005.htm 

e Published: 11/28/12 

e Revised: 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


'This content is available online at <http://cnx.org/content /m45252/1.7/>. 
*http://cnx.org/content /m45284 

3http://cnx.org/content /m45302 

“http://apcentral.collegeboard.com/apc/public/repository /ap-computer-science-course-description.pdf 
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I also want you to know that I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


7.2 Ap0010: Self-assessment, Primitive Types’ 


7.2.1 Table of Contents 


e Preface (p. 2950) 
e Questions (p. 2951) 


1 (p. 2951) , 2 (p. 2951) , 3 (p. 2951) , 4 (p. 2952) , 5 (p. 2952) , 6 (p. 2953) , 7 (p. 2954) , 8 
(p. 2954) , 9 (p. 2955) , 10 (p. 2956) 


e Programming challenge questions (p. 2956) 


11 (p. 2956) , 12 (p. 2957) , 13 (p. 2958) , 14 (p. 2959) , 15 (p. 2961) , 16 (p. 2962) , 17 (p. 
2962) , 18 (p. 2963) 


e Listings (p. 2964) 
e Miscellaneous (p. 2965) 
e Answers (p. 2965) 


7.2.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

Questions and answers 

The test consists of a series of questions (p. 2951) with answers (p. 2965) and explanations of the 
answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

Programming challenge questions 

The module also contains a section titled Programming challenge questions (p. 2956) . This section 
provides specifications for one or more programs that you should be able to write once you understand the 
answers to all of the questions. (Note that it is not always possible to confine the programming knowledge 
requirement to this and earlier modules. Therefore, you may occasionally need to refer ahead to future 
modules in order to write the programs.) 

Unlike the other questions, solutions are not provided for the Programming challenge questions 
However, in most cases, the specifications will describe the output that your program should produce. 

Listings 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 2964) to easily find and view the listings while you are reading about them. 


>This content is available online at <http://cnx.org/content /m45284/1.7/>. 
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7.2.3 Questions 
7.2.3.1 Question 1 


What output is produced by the program in Listing 1 (p. 2951) ? 


A. Compiler error 

B. Runtime error 

C. Hello World 

D. Goodbye Cruel World 


Listing 1 . Listing for Question 1. 


public class Ap001{ 
public static void main( 
String args[]){ 
new Worker () .hello(); 
}//end main() 
}//end class definition 


class Worker{ 
public void hello(){ 
System. out .println("Hello World"); 
}//end hello() 
}//end class definition 


Table 7.1 


Answer and Explanation (p. 2970) 


7.2.3.2 Question 2 


What is the largest (algebraic) value of type int? 


. 32767 

. 2147483647 
. -2147483647 
. -32768 


Jawe 


Answer and Explanation (p. 2969) 


7.2.3.3 Question 3 


What is the smallest (algebraic) value of type int? 


. -2147483648 
. -2147483647 
. 32767 

. -32768 


Jawe 


Answer and Explanation (p. 2969) 
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7.2.3.4 Question 4 


What two values are displayed by the program in Listing 2 (p. 2952) ? 


. -2147483648 

. 1.7976931348623157E308 
. -2147483647 

. 4.9E-324 


Jawe 


Listing 2 . Listing for Question 4. 


public class Ap003{ 
public static void main( 
String args[]){ 
new Worker () .printDouble() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void printDouble(){ 
System. out .print1n( 
Double.MAX_VALUE) ; 
System. out .print1n( 
Double.MIN_VALUE) ; 
}//end printDouble() 
}//end class definition 


Table 7.2 


Answer and Explanation (p. 2968) 


7.2.3.5 Question 5 


What output is produced by the program in Listing 3 (p. 2953) ? 


A. true 
B. false 
C.1 
D.0 
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Listing 3 . Listing for Question 5. 


public class Ap0044{ 
public static void main( 
String args[]){ 
new Worker () .printBoolean(); 
}//end main() 
}//end class definition 


class Worker{ 
private boolean myVar; 
public void printBoolean() { 
System. out.println(myVar) ; 
}//end printBoolean() 
}//end class definition 


Table 7.3 


Answer and Explanation (p. 2968) 


7.2.3.6 Question 6 
What output is produced by the program shown in Listing 4 (p. 2953) ? 


A. Compiler Error 
B. Runtime Error 
C. true 
D. false 


Listing 4 . Listing for Question 6. 


public class Ap005{ 
public static void main( 
String args[]){ 
new Worker () .printBoolean(); 
}//end main() 
}//end class definition 


class Worker{ 
public void printBoolean() { 
boolean myVar; 
System. out.println(myVar) ; 
}//end printBoolean() 
}//end class definition 


Table 7.4 


Answer and Explanation (p. 2967) 
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7.2.3.7 Question 7 
What output is produced by the program shown in Listing 5 (p. 2954) ? 


A. Compiler Error 
B. Runtime Error 
C. true 
D. false 


Listing 5 . Listing for Question 7. 


public class Ap006{ 
public static void main( 
String args[]){ 
new Worker () .printBoolean(); 
}//end main() 
}//end class definition 


class Worker{ 
public void printBoolean() { 
boolean myVar = true; 
myVar = false; 
System. out.println(myVar) ; 
}//end printBoolean() 
}//end class definition 


Table 7.5 


Answer and Explanation (p. 2967) 


7.2.3.8 Question 8 


The plus (+) character can be used to perform numeric addition in Java. What output is produced by the 
program shown in Listing 6 (p. 2955) ? 


A. Compiler Error 
B. Runtime Error 
C. true 

D. 2 

E. 1 


Listing 6 . Listing for Question 8. 


continued on next page 
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public class Ap0074{ 
public static void main( 
String args[]){ 
new Worker () .printBoolean(); 
}//end main() 
}//end class definition 


class Worker{ 
public void printBoolean() { 
boolean myVar = true; 
System.out.println(1 + myVar); 
}//end printBoolean() 
}//end class definition 


Table 7.6 


Answer and Explanation (p. 2966) 


7.2.3.9 Question 9 


The plus (+) character can be used to perform numeric addition in Java. What output is produced by the 
program shown in Listing 7 (p. 2955) ? 


A. Compiler Error 
B. Runtime Error 
C. 6 

D. 6.0 


Listing 7 . Listing for Question 9. 


public class Ap008{ 
public static void main( 
String args[]){ 
new Worker () .printMixed() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void printMixed(){ 
double x = 3; 
int y = 3; 
System. out.println(xty) ; 
}//end printMixed() 
}//end class definition 


Table 7.7 


Answer and Explanation (p. 2966) 
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7.2.3.10 Question 10 


The slash (/) character can be used to perform numeric division in Java. What output is produced by the 
program shown in Listing 8 (p. 2956) ? 


A. Compiler Error 

B. Runtime Error 

C. 0.33333334 

D. 0.3333333333333333 


Listing 8 . Listing for Question 10. 


public class Ap009{ 
public static void main( 
String args[]){ 
new Worker () .printMixed() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void printMixed(){ 
System. out.print1n(1.0/3); 
}//end printMixed() 
}//end class definition 


Table 7.8 


Answer and Explanation (p. 2965) 


7.2.4 Programming challenge questions 
7.2.4.1 Question 11 
Write the program described in Listing 9 (p. 2957) . 
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Listing 9 . Listing for Question 11. 


/*File Ap0010a1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 
This program refuses to compile without errors. 


Make the necessary corrections to cause the program to 
compile and run successfully to produce the output shown 
below: 


ITSE 
2321 
FSCO SOOO OAS IIIS II IAI ICI ICI I A I A i ak A EEEE EEEE EN 
public class Ap0010a1{ 
public static void main(String args[]){ 
System. out.println("ITSE") ; 
new Worker() .doItQ; 
}//end main() 
}//end class definition 


Class Worker{ 
public void doIt(){ 
System. out. print1n("2321") ; 
}//end doIt() 
}//end class definition 


Table 7.9 


7.2.4.2 Question 12 
Write the program described in Listing 10 (p. 2958) . 
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Listing 10 . Listing for Question 12. 


/*File Ap0010b1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 

Beginning with the code fragment shown below, write a 
method named doIt that: 

1. Receives and displays an incoming parameter of type int. 


The result should be similar to the following but the 
values should be different each time the program is 
run. 


484495695 

484495695 

FE A EEE EE EE EEEE E EE EEEE EEEE EE EEE 21 21 21 1 4 21 2k 2k E EE E ak ak kak / 
//Student is not expected to understand import directives 
// at this point. 

import java.util.Random; 

import java.util.Date; 


public class Ap0010b1if{ 
public static void main(String args[]){ 
//Create a random number for testing. Student is not 
// expected to understand how this works at this point. 
Random random = new Random(new Date().getTime()); 
int intVar = random.nextInt(); 


//Student should understand the following 
int var = intVar; 
System. out.println(var) ; 
new Worker () .doIt (var); 
}//end main() 
}//end class definition 


a / / 
class Worker{ 

/L----------------------------------------------------- // 

//Student: insert the method named doIt between these 

// lines. 

[| -------- 7-77-5252 022252 nnn nn nnn nnn nnn nnn nn nnne // 
3//end class definition 
Gi / / 

Table 7.10 


7.2.4.3 Question 13 
Write the program described in Listing 11 (p. 2959) . 
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Listing 11 . Listing for Question 13. 


/*File Ap0010c1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 

Beginning with the code fragment shown below, write a 
method named doIt that returns the largest value of type 
int as type float. 


The result should be 2.14748365E9 
FES AO IAG I II I ICI ICI I I I I I 4 1 A I A 21 21 2K 21 2K FA 2K 2k 2k 2k of a of 2k ak a ak ak aka / 
public class Ap0010c1{ 
public static void main(String args[]){ 
float val = new Worker().doIt(Q); 
System. out .println(val) ; 
}//end main() 
}//end class definition 


/ /====================================================== / / 

class Worker{ 
/[----------------------------------------------------- // 
//Insert the method named doIt between these lines 
/[----------------------------------------------------- // 

}//end class definition 

/ /====================================================== / / 

Table 7.11 


7.2.4.4 Question 14 
Write the program described in Listing 12 (p. 2960) . 
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Listing 12 . Listing for Question 14. 


/*File Ap0010d1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 

Beginning with the code fragment shown below, write a 
method named doIt that: 

1. Receives an incoming parameter of type double. 

2. Converts that value to type int. 

3. Returns the int 


The result should be similar to the following but the 
values should be different each time the program is 
run. 


6 .672032181818181E8 

667203218 

FEA AG EEE EEEE EEEE E EE EEEE aI I I A EEE EE 21 21 EE 4 24 2k 2k a 4 2k EE ak af EA 
//Student is not expected to understand import directives 
// at this point. 

import java.util.Random; 

import java.util.Date; 


public class Ap0010d1f{ 
public static void main(String args[]){ 
//Create a random number for testing. Student is not 
// expected to understand how this works at this point. 
Random random = new Random(new Date().getTime()); 
int intVar = random.nextInt(); 


//Student should understand the following 
double var = intVar/1.1; 
System. out.println(var) ; 
System.out.println(new Worker ().doIt(var)); 
}//end main() 
}//end class definition 


a es ee) 
class Worker{ 
/[----------------------------------------------------- // 
//Student: insert the method named doIt between these 
// lines. 
a // 
}//end class definition 
/ /====================================================== / / 
Table 7.12 
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Listing 13 . Listing for Question 15. 


/*File Ap0010e1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 
This program refuses to compile without errors. 


Make the necessary corrections to cause the program to 
compile and run successfully to produce an output similar 
to that shown below. Note that the values should be 
different each time the program is 

run. 


-1.30240579E8 

-1.30240579E8 

FE A EEEE EEE I IOI I IOI AI I I A EEEE E EEEE 21 21 21 1 4 21 2k 2k E EE E a ak kak / 
//Student is not expected to understand import directives 
// at this point. 

import java.util.Random; 

import java.util.Date; 


public class Ap0010e1f{ 
public static void main(String args[]){ 
//Create a random number for testing. Student is not 
// expected to understand how this works at this point. 
Random random = new Random(new Date().getTime()); 
double doubleVar = random.nextInt()/1.0; 


//Student should understand the following 
double var = doubleVar; 
System. out.println(doubleVar) ; 
new Worker () .doIt (doubleVar) ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doIt(double val){ 
int var = val; 
System. out.println(var) ; 
}//end doIt() 
}//end class definition 


Table 7.13 
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7.2.4.6 Question 16 
Write the program described in Listing 14 (p. 2962) . 


Listing 14 . Listing for Question 16. 


/*File Ap0010f1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 

Beginning with the code shown below, modify the 
code in the method named doIt so that the program 
displays 


3 .3333333333333335 instead of 3 
Then modify the method again so that the program displays 


3.3333333 instead of 3 
ECT CCCCCCCCCCCCCCCCCCCeTCCCECLCCTeCEeTECeECECCEETOOLE LS OO, 
public class Ap0010f14{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doIt(){ 
System. out.print1n(10/3) ; 
}//end doIt() 
}//end class definition 


Table 7.14 


7.2.4.7 Question 17 
Write the program described in Listing 15 (p. 2963) . 


Listing 15 . Listing for Question 17. 


continued on next page 
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/*File Ap0010g1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 

Beginning with the code shown below, modify the 
code in the method named doIt so that the program 
displays 


2048 instead of 2730 


Did you notice anything particularly interesting about the 
values involved? 
EEEE EEEE OAS III AI II I II I ICI IAI I I IK kf A IK EEE EEE EEEE EEE EEEN 
public class Ap0010g1if 

public static void main(String args[]){ 

new Worker () .doIt (16384) ; 

}//end main() 

}//end class definition 


class Worker{ 
public void doIt(int val){ 
System. out.println(val/6) ; 
}//end doIt() 
}//end class definition 


Table 7.15 


7.2.4.8 Question 18 
Write the program described in Listing 16 (p. 2964) . 
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Listing 16 . Listing for Question 18. 


/*File Ap0010h1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 
This program refuses to compile without errors. 


Make the necessary corrections to cause the program to 
compile and run successfully to produce the output shown 
below: 


false 
FO OO GO A a RK AK RK a 2k 3 2k 2k 2 3k 2k 2k a 2k 2k 2k ok 2k 3k 2k ok 2k ok 2k ak 2k ok 2 ak 2k ak // 


public class Ap0010h1f{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doIt(){ 
boolean var; 
System. out.println(var) ; 
}//end doIt() 
}//end class definition 


Table 7.16 


7.2.5 Listings 


Listing 1 (p. 2951) . Listing for Question 1. 
Listing 2 (p. 2952) . Listing for Question 4. 
Listing 3 (p. 2953) . Listing for Question 5. 
Listing 4 (p. 2953) . Listing for Question 6. 
Listing 5 (p. 2954) . Listing for Question 7. 
Listing 6 (p. 2955) . Listing for Question 8. 
Listing 7 (p. 2955) . Listing for Question 9. 
Listing 8 (p. 2956) . Listing for Question 10. 
Listing 9 (p. 2957) . Listing for Question 11. 
8 


p 
Listing 10 (p. 2958) . Listing for Question 12. 
Listing 11 (p. 2959) . Listing for Question 13. 
Listing 12 (p. 2960) . Listing for Question 14. 
Listing 13 (p. 2961) . Listing for Question 15. 
Listing 14 (p. 2962) . Listing for Question 16. 
( ) 


Listing 15 (p. 2963) . Listing for Question 17. 
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e Listing 16 (p. 2964) . Listing for Question 18. 
e Listing 17 (p. 2971) . Listing for Answer 1. 


7.2.6 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Ap0010: Self-assessment, Primitive types 
e File: Ap0010.htm 

e Originally published: December 17, 2001 

e Published at cnx.org: 12/01/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.2.7 Answers 
7.2.7.1 Answer 10 
D. 0.3333333333333333 


7.2.7.1.1 Explanation 10 


Divide floating type by integer type 

This program divides the literal floating value of 1.0 by the literal integer value of 3 (no decimal point 
is specified in the integer literal value) . 

Automatic conversion from narrow to wider type 

To begin with, whenever division is performed between a floating type and an integer type, the integer 
type is automatically converted (sometimes called promoted) to a floating type and floating arithmetic is 
performed. 

What is the actual floating type, float or double? 

The real question here is, what is the type of the literal shown by 1.0 (with a decimal point separating 
the 1 and the 0) . Is it a double ora float ? 

Type double is the default 

By default, a literal floating value is treated as a double 

The result is type double 
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Consequently, this program divides a double type by an integer type, producing a result of type 
double . This is somewhat evident in the output, which shows about 17 digits plus a decimal point in 
the result. (Recall that the maximum value for a float shown earlier had only about eight digits plus the 
decimal point and the exponent.) 

How can you create literals of type float? 

What if you don’t want your literal floating value to be treated as a double , but would prefer that it 
be treated as a float instead. 

You can usually force this to be the case by adding a suffix of either F or f to the end of the literal value 

(as in 1.0F) . If you were to modify this program to cause it to divide 1.0F by 3, the output would be 
0.33333334 with only nine digits in the result. 
Back to Question 10 (p. 2956) 


7.2.7.2 Answer 9 
D. 6.0 


7.2.7.2.1 Explanation 9 


Declare and initialize two local variables 

This program declares and initializes two local variables, one of type double and the other of type 
int . Each variable is initialized with the integer value 3. 

Automatic conversion to floating type double 

However, before the value of 3 is stored in the double variable, it is automatically converted to type 
double 

Automatic conversion in mixed-type arithmetic 

Numeric addition is performed on the two variables. Whenever addition is performed between a floating 
type and an integer type, the integer type is automatically converted to a floating type and floating arithmetic 
is performed. 

A floating result 

This produces a floating result. When this floating result is passed to the println method for display, 
a decimal point and a zero are displayed to indicate a floating type, even though in this case, the fractional 
part of the result is zero. 

Back to Question 9 (p. 2955) 


7.2.7.3 Answer 8 


A. Compiler Error 


7.2.7.3.1 Explanation 8 


Initialize boolean variable to true 

This program declares and initializes a boolean variable with the value true . Then it attempts to 
add the literal value 1 to the value stored in the boolean variable named my Var 

Arithmetic with boolean values is not allowed 

As mentioned earlier, unlike C++, boolean types in Java cannot participate in arithmetic expressions. 

Therefore, this program will not compile. The compiler error produced by this program under JDK 1.3 
reads partially as follows: 
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Ap00O7.java:13: operator + cannot be applied to int,boolean 
System.out.println(1 + myVar); 


Table 7.17 


Back to Question 8 (p. 2954) 


7.2.7.4 Answer 7 
D. false 


7.2.7.4.1 Explanation 7 


Format for variable initialization 

This program declares a local boolean variable and initializes it to the value true . All variables, 
local or otherwise, can be initialized in this manner provided that the expression on the right of the equal 
sign evaluates to a value that is assignment compatible with the type of the variable. (I will have more to 
say about assignment compatibility in a future module) . 

Value is changed before display 

However, before calling the printIn method to display the initial value of the variable, the program 
uses the assignment operator (=) to assign the value false to the variable. Thus, when it is displayed, the 
value is false . 

Back to Question 7 (p. 2954) 


7.2.7.5 Answer 6 


A. Compiler Error 


7.2.7.5.1 Explanation 6 


A local boolean variable 

In this program, the primitive variable named myVar is a local variable belonging to the method 
named printBoolean 

Local variables are not automatically initialized 

Unlike instance variables, if you fail to initialize a local variable, the variable is not automatically initial- 
ized. 

Cannot access value from uninitialized local variable 

If you attempt to access and use the value from an uninitialized local variable before you assign a value 
to it, you will get a compiler error. The compiler error produced by this program under JDK 1.3 reads 
partially as follows: 


Ap005.java:13: variable myVar might not have been initialized 
System. out.println(myVar) ; 


Table 7.18 
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Must initialize or assign value to all local variables 

Thus, the programmer is responsible for either initializing all local variables, or assigning a value to them 
before attempting to access their value with code later in the program. The good news is that the system 
won’t allow you to compute with garbage left over in memory occupied by variables, either local variables 
or member variables. 

Back to Question 6 (p. 2953) 


7.2.7.6 Answer 5 
B. false 


7.2.7.6.1 Explanation 5 


The boolean type 
In this program, the primitive variable named myVar is an instance variable of the type boolean 
What is an instance variable? 

An instance variable is a variable that is declared inside a class, outside of all methods and constructors 
of the class, and is not declared static. Every object instantiated from the class has one. That is why it is 
called an instance variable. 

Cannot use uninitialized variables in Java 

One of the great things about Java is that it is not possible to make the mistake of using variables that 

have not been initialized. 
Can initialize when declared 
All Java variables can be initialized when they are declared. 
Member variables are automatically initialized 

If the programmer doesn’t initialize the variables declared inside the class but outside of a method (often 
referred to as member variables as opposed to local variables) , they are automatically initialized to a default 
value. The default value for a boolean variable is false. 

Did you know the boolean default value? 

I wouldn’t be overly concerned if you had selected the answer A. true, because I wouldn’t necessarily 

expect you to memorize the default initialization value. 
Great cause for concern 
However, I would be very concerned if you selected either C. 1 or D. 0. 
Java has a true boolean type 

Unlike C++, Java does not represent true and false by the numeric values of 1 and 0. (At least the 
numeric values that represent true and false are not readily accessible by the programmer.) 

Thus, you cannot include boolean types in arithmetic expressions, as is the case in C++. 

Back to Question 5 (p. 2952) 


7.2.7.7 Answer 4 


e B. 1.7976931348623157E308 
e D. 4.9E-324 


7.2.7.7.1 Explanation 4 


Floating type versus integer type 

If you missed this one, shame on you! 

I didn’t expect you to memorize the maximum and minimum values represented by the floating type 
double, but I did expect you to be able to distinguish between the display of a floating value and the display 
of an integer value. 

Both values are positive 
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Note that both of the values given above are positive values. 

Unlike the integer types discussed earlier, the constants named MAX VALUE and MIN VALUE 
don’t represent the ends of a signed number range for type double . Rather, they represent the largest 
and smallest (non-zero) values that can be expressed by the type. 

An indication of granularity 

MIN_ VALUE is an indication of the degree of granularity of values expressed as type double 
Any double value can be treated as either positive or negative. 

Two floating types are available 

Java provides two floating types: float and double . The double type provides the greater range, 
or to use another popular terminology, it is the wider of the two. 

What is the value range for a float? 

In case you are interested, using the same syntax as above, the value range for type float is from 1.4E-45 

to 3.4028235E38 
Double is often the default type 

There is another thing that is significant about type double . In many cases where a value is automat- 
ically converted to a floating type, it is converted to type double rather than to type float. This will come 
up in future modules. 

Back to Question 4 (p. 2952) 


7.2.7.8 Answer 3 
A. -2147483648 


7.2.7.8.1 Explanation 3 


Could easily have guessed 
As a practical matter, you had one chance in two of guessing the correct answer to this question, already 
having been given the value of the largest algebraic value for type int. 
And the winner is ... 
Did you answer B. -2147483647? - WRONG 
If so, you may be wondering why the most negative value isn’t equal to the negative version of the most 
positive value? 
A twos-complement characteristic 
Without going into the details of why, it is a well-known characteristic of binary twos-complement notation 
that the value range extends one unit further in the negative direction than in the positive direction. 
What about the other two values? 
Do the values of -32768 and 32767 in the set of multiple-choice answers to this question represent anything 
in particular? 
Yes, they represent the extreme ends of the value range for a 16-bit binary number in twos-complement 
notation. 
Does Java have a 16-bit integer type? 
Just in case you are interested, the short type in Java is represented in 16-bit binary twos-complement 
signed notation, so this is the value range for type short. 
What about type byte? 
Similarly, a value of type byte is represented in 8-bit binary twos-complement signed notation, with a 
value range extending from -128 to 127. 
Back to Question 3 (p. 2951) 


7.2.7.9 Answer 2 
B. 2147483647 
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7.2.7.9.1 Explanation 2 


First question on types 

This is the first question on Java types in this group of self-assessment modules. 

32-bit signed twos-complement integers 

In Java, values of type int are stored as 32-bit signed integers in twos-complement notation. 

Can you calculate the values? 

There are no unsigned integer types in Java, as there are in C++. If you are handy with binary notation, 
you could calculate the largest positive value that can be stored in 32 bits in twos-complement notation. 

See documentation for the Integer class 

Otherwise, you can visit the documentation ê for the Integer class, which provides a symbolic constant 
(public static final variable) named MAX VALUE . The description of MAX_ VALUE reads as follows: 

"The largest value of type int. The constant value of this field is 2147483647." 

Back to Question 2 (p. 2951) 


7.2.7.10 Answer 1 
C. Hello World 


7.2.7.10.1 Explanation 1 


The answer to this first question is intended to be easy. The purpose of the first question is to introduce you 
to the syntax that will frequently be used for program code in this group of self-assessment modules. 
The controlling class and the main method 
In this example, the class named Ap001 isthe controlling class . It contains a method named main 
, with a signature that matches the required signature for the main method. When the user executes this 
program, the Java virtual machine automatically calls the method named main in the controlling class. 
Create an instance of Worker 
The main method uses the new operator along with the default constructor for the class named 
Worker to create a new instance of the class named Worker (an object of the Worker class) . This is 
often referred to as instantiating an object. 
A reference to an anonymous object 
The combination of the new operator and the default constructor for the Worker class returns a 
reference to the new object. In this case, the object is instantiated as an anonymous object , meaning that 
the object’s reference is not saved in a named reference variable. (Instantiation of a non-anonymous object 
will be illustrated later.) 
Call hello method on Worker object 
The main method contains a single executable statement. 
As soon as the reference to the new object is returned, the single statement in the main method calls 
the hello method on that reference. 
Output to standard output device 
This causes the hello method belonging to the new object (of the class named Worker ) to execute. 
The code in the hello method calls the println method on the static variable of the System class 
named out 
Lots of OOP embodied in the hello method 
I often tell my students that I can tell a lot about whether a student really understands object-oriented 
programming in Java by asking them to explain everything that they know about the following statement: 
System.out.println("Hello World"); 
I would expect the answer to consume about ten to fifteen minutes if the student really understands Java 
OOP. 


The one-minute version 


Shttp://cnx.org/content /m45117 
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When the virtual machine starts a Java application running, it automatically instantiates an I/O stream 
object linked to the standard output device (normally the screen) and stores a reference to that object in 
the static variable named out belonging to the class named System 

Call the println instance method on out 

Calling the println method on that reference, and passing a literal string ("Hello World") to that 

method causes the contents of the literal String object to be displayed on the standard output device. 
Display Hello World on the screen 

In this case, this causes the words Hello World to be displayed on the standard output device. This is 
the answer to the original question. 

Time for main method to terminate 

When the hello method returns, the main method has nothing further to do, so it terminates. When 
the main method terminates in a Java application, the application terminates and returns control to the 
operating system. This causes the system prompt to reappear. 

A less-cryptic form 
A less cryptic form of this program is shown in Listing 17 (p. 2971) . 


Listing 17 . Listing for Answer 1. 


public class Ap002{ 
public static void main( 
String args[]){ 
Worker refVar = new Worker(); 
refVar.hello(); 
}//end main() 
}//end class definition 
class Worker{ 


public void hello(){ 
System.out.println("Hello World"); 
}//end hello() 
}//end class definition 


Table 7.19 


Decompose single statement into two statements 

In this version, the single statement in the earlier version of the main method is replaced by two 
statements. 

A non-anonymous object 

In the class named Ap002 shown in Listing 2 (p. 2952) , the object of the class named Worker is 
not instantiated anonymously. Rather, a new object of the Worker class is instantiated and the object’s 
reference is stored in (assigned to) the named reference variable named refVar 

Call hello method on named reference 

Then the hello method is called on that reference in a separate statement. 

Produces the same result as before 

The final result is exactly the same as before. The only difference is that a little more typing is required 
to create the source code for the second version. 

Will often use anonymous objects 

In order to minimize the amount of typing required, I will probably use the anonymous form of instanti- 
ation whenever appropriate in these modules. 
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Now that you understand the framework ... 

Now that you understand the framework for the program code, I can present more specific questions. 
Also, the explanations will usually be shorter. 

Back to Question 1 (p. 2951) 

-end- 


7.3 Ap0020: Self-assessment, Assignment and Arithmetic Operators’ 


7.3.1 Table of Contents 


e Preface (p. 2972) 
e Questions (p. 2973) 


1 (p. 2973) , 2 (p. 2973) , 3 (p. 2974) , 4 (p. 2975) , 5 (p. 2976) , 6 (p. 2977) , 7 (p. 2978) , 8 
(p. 2978) , 9 (p. 2979) , 10 (p. 2980) , 11 (p. 2980) , 12 (p. 2981) , 13 (p. 2982) , 14 (p. 2982) , 
15 (p. 2983) 


e Programming challenge questions (p. 2984) 


16 (p. 2984) , 17 (p. 2984) , 18 (p. 2985) , 19 (p. 2986) , 20 (p. 2987) , 21 (p. 2988) , 22 (p. 
2989) 


e Listings (p. 2990) 
e Miscellaneous (p. 2991) 
e Answers (p. 2991) 


7.3.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

Questions and answers 

The test consists of a series of questions (p. 2973) with answers (p. 2991) and explanations of the 
answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

Programming challenge questions 

The module also contains a section titled Programming challenge questions (p. 2984) . This section 
provides specifications for one or more programs that you should be able to write once you understand the 
answers to all of the questions. (Note that it is not always possible to confine the programming knowledge 
requirement to this and earlier modules. Therefore, you may occasionally need to refer ahead to future 
modules in order to write the programs.) 

Unlike the other questions, solutions are not provided for the Programming challenge questions 
However, in most cases, the specifications will describe the output that your program should produce. 

Listings 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 2990) to easily find and view the listings while you are reading about them. 


“This content is available online at <http://cnx.org/content /m45286/1.6/>. 
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7.3.3 Questions 
7.3.3.1 Question 1 


What output is produced by the program shown in Listing 1 (p. 2973) ? 


A. Compiler Error 
B. Runtime Error 
C. 3.0 
D. 4.0 
E. 7.0 


Listing 1 . Listing for Question 1. 


public class Ap010f{ 
public static void main( 
String args[]){ 
new Worker () .doAsg() ;sx 
}//end main() 
}//end class definition 


class Worker{ 
public void doAsg(){ 
double myVar; 
myVar = 3.0; 
myVar += 4.0; 
System. out.println(myVar) ; 
}//end doAsg() 
3//end class definition 


Table 7.20 


Answer and Explanation (p. 2999) 


7.3.3.2 Question 2 
What output is produced by the program shown in Listing 2 (p. 2974) ? 


A. Compiler Error 
B. Runtime Error 
C. 2.147483647E9 
D. 2.14748365E9 


Listing 2 . Listing for Question 2. 


continued on next page 
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public class Ap011{ 
public static void main( 
String args[]){ 
new Worker () .doAsg() ;sx 
}//end main() 
}//end class definition 


class Worker{ 
public void doAsg(){ 
double myDoubleVar; 
//Integer.MAX_VALUE = 2147483647 
int myIntVar = Integer .MAX_VALUE; 
myDoubleVar = myIntVar; 
System. out .print1ln(myDoubleVar) ; 
}//end doAsg() 
}//end class definition 


Table 7.21 


Answer and Explanation (p. 2998) 


7.3.3.3 Question 3 


What output is produced by the following program? 


A. Compiler Error 
B. Runtime Error 
C. 2147483647 

D. 2.147483647E9 
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Listing 3 . Listing for Question 3. 


public class Ap012f{ 
public static void main( 
String args[]){ 
new Worker () .doAsg() ;sx 
}//end main() 
}//end class definition 


class Worker{ 
public void doAsg(){ 
//Integer .MAX_VALUE = 2147483647 
double myDoubleVar = 
Integer .MAX_VALUE; 
int myIntVar; 
myIntVar = myDoubleVar; 
System. out.println(myIntVar) ; 
}//end doAsg() 
3//end class definition 


Table 7.22 


Answer and Explanation (p. 2998) 


7.3.3.4 Question 4 


What output is produced by the program shown in Listing 4 (p. 2976) ? 


A. Compiler Error 
B. Runtime Error 
C. 2147483647 

D. 2.147483647E9 
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Listing 4 . Listing for Question 4. 


public class Ap013{ 
public static void main( 
String args[]){ 
new Worker () .doAsg() ;sx 
}//end main() 
}//end class definition 


class Worker{ 
public void doAsg(){ 
//Integer .MAX_VALUE = 2147483647 
double myDoubleVar = 
Integer .MAX_VALUE; 
int myIntVar; 
myIntVar = (int)myDoubleVar; 
System. out.println(myIntVar) ; 
}//end doAsg() 
3//end class definition 


Table 7.23 


Answer and Explanation (p. 2997) 


7.3.3.5 Question 5 


What output is produced by the program shown in Listing 5 (p. 2977) ? 


A. Compiler Error 
B. Runtime Error 
C. 4.294967294E9 
D. 4294967294 
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Listing 5 . Listing for Question 5. 


public class Ap014{ 
public static void main( 
String args[]){ 
new Worker () .doMixed() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doMixed(){ 
//Integer.MAX_VALUE = 2147483647 
int myIntVar = Integer .MAX_VALUE; 
System.out.println(2.0 * myIntVar) ; 
}//end doMixed() 
}//end class definition 


Table 7.24 


Answer and Explanation (p. 2996) 


7.3.3.6 Question 6 
What output is produced by the program shown in Listing 6 (p. 2977) ? 


A. Compiler Error 
B. Runtime Error 
C. 2147483649 
D. -2147483647 


Listing 6 . Listing for Question 6. 


public class Ap015{ 
public static void main( 
String args[]){ 
new Worker () .doMixed() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doMixed(){ 
//Integer .MAX_VALUE = 2147483647 
int myVar01 = Integer.MAX_VALUE; 
int myVar02 = 2; 
System. out.print1n( 
myVar01 + myVar02); 
}//end doMixed() 
}//end class definition 
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Table 7.25 


Answer and Explanation (p. 2996) 


7.3.3.7 Question 7 
What output is produced by the program shown in Listing 7 (p. 2978) ? 


A. Compiler Error 
B. Runtime Error 
C. 33.666666 

D. 34 

E. 33 


Listing 7 . Listing for Question 7. 


public class Ap016{ 
public static void main( 
String args[]){ 
new Worker () .doMixed() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doMixed(){ 
int myVar01 = 101; 
int myVar02 = 3; 
System. out. print1n( 
myVar01/myVar02) ; 
}//end doMixed() 
}//end class definition 


Table 7.26 


Answer and Explanation (p. 2995) 


7.3.3.8 Question 8 


What output is produced by the program shown in Listing 8 (p. 2979) ? 


A. Compiler Error 
B. Runtime Error 
C. Infinity 

D. 11 
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Listing 8 . Listing for Question 8. 


public class Ap017{ 
public static void main( 
String args[]){ 
new Worker () .doMixed() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doMixed(){ 
int myVar01 = 11; 
int myVar02 = 0; 
System. out .print1n( 
myVar01/myVar02) ; 
}//end doMixed() 
}//end class definition 


Table 7.27 


Answer and Explanation (p. 2994) 


7.3.3.9 Question 9 
What output is produced by the program shown in Listing 9 (p. 2979) ? 


A. Compiler Error 
B. Runtime Error 
C. Infinity 

D. 11 


Listing 9 . Listing for Question 9. 


public class Ap018{ 
public static void main( 
String args[]){ 
new Worker () .doMixed() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doMixed(){ 
double myVar01 = 11; 
double myVar02 = 0; 
System. out .print1n( 
myVar01/myVar02) ; 
}//end doMixed() 
}//end class definition 
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Table 7.28 


Answer and Explanation (p. 2994) 


7.3.3.10 Question 10 


What output is produced by the program shown in Listing 10 (p. 2980) ? 


A. Compiler Error 
B. Runtime Error 
C. 2 
D. -2 


Listing 10 . Listing for Question 10. 


public class Ap019{ 
public static void main( 
String args[]){ 
new Worker () .doMod() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doMod(){ 
int myVar01 = -11; 
int myVar02 = 3; 
System. out .print1n( 
myVar01 % myVar02) ; 
}//end doMod() 
}//end class definition 


Table 7.29 


Answer and Explanation (p. 2993) 


7.3.3.11 Question 11 


What output is produced by the program shown in Listing 11 (p. 2981) ? 


A. Compiler Error 
B. Runtime Error 
C. 2 

D. 11 
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Listing 11 . Listing for Question 11. 


public class Ap020{ 
public static void main( 
String args[]){ 
new Worker () .doMod() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doMod(){ 
int myVar01 = -11; 
int myVar02 = 0; 
System. out .print1n( 
myVar01 % myVar02) ; 


}//end doMod() 
}//end class definition 


Table 7.30 


Answer and Explanation (p. 2993) 


7.3.3.12 Question 12 
What output is produced by the program shown in Listing 12 (p. 2981) ? 


A. Compiler Error 
B. Runtime Error 
C. -0.010999999999999996 
D. 0.010999999999999996 


Listing 12 . Listing for Question 12. 


public class Ap021{ 
public static void main( 
String args[]){ 
new Worker () .doMod() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doMod(){ 
double myVar01 = -0.11; 
double myVar02 = 0.033; 
System. out .print1n( 
myVar01 % myVar02) ; 
}//end doMod() 
3//end class definition 
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Table 7.31 


Answer and Explanation (p. 2992) 


7.3.3.13 Question 13 


What output is produced by the program shown in Listing 13 (p. 2982) ? 


A. Compiler Error 

B. Runtime Error 

C. 0.0 

D. 1.5499999999999996 


Listing 13 . Listing for Question 13. 


public class Ap022{ 
public static void main( 
String args[]){ 
new Worker () .doMod() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doMod(){ 
double myVar01 = 15.5; 
double myVar02 = 1.55; 
System. out .print1n( 
myVar01 % myVar02) ; 
}//end doMod() 
}//end class definition 


Table 7.32 


Answer and Explanation (p. 2992) 


7.3.3.14 Question 14 


What output is produced by the program shown in Listing 14 (p. 2983) ? 


A. Compiler Error 
B. Runtime Error 
C. Infinity 

D. NaN 
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Listing 14 . Listing for Question 14. 


public class Ap023{ 
public static void main( 
String args[]){ 
new Worker () .doMod() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doMod(){ 
double myVar01 = 15.5; 
double myVar02 = 0.0; 
System. out. print1n( 
myVar01 % myVar02) ; 
}//end doMod() 
}//end class definition 


Table 7.33 


Answer and Explanation (p. 2992) 


7.3.3.15 Question 15 
What output is produced by the program shown in Listing 15 (p. 2983) ? 


. Compiler Error 
. Runtime Error 
. -3 2 

. -3 -2 


Jawe 


Listing 15 . Listing for Question 15. 


public class Ap024{ 
public static void main( 
String args[]){ 
new Worker () .doMod() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doMod(){ 


int x = 11; 
int y = -3; 
System. out .print1n( 


x/y +" "+x% y); 
}//end doMod() 
}//end class definition 
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Table 7.34 
Answer and Explanation (p. 2991) 
7.3.4 Programming challenge questions 


7.3.4.1 Question 16 
Write the program described in Listing 16 (p. 2984) . 


Listing 16 . Listing for Question 16. 


/*File Ap0020a1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 

Beginning with the code fragment shown below, write a 
method named doIt that: 

1. Illustrates the proper use of the combined 
arithmetic/assignment operators such as the following 
operators: 


+= 
x= 


FESO OOS OAS III SAI II IAI I I IA I A I A I Ak A kK ak 2k EEEE a / 
public class Ap0020a1f{ 
public static void main(String args[]){ 
new Worker().doItQ; 
}//end main() 
}//end class definition 


fa a / / 
class Worker{ 
[| -------- 7-7-7252 5-252 on nnn nnn nnn nnn nnn nnn nnne // 
//Student: insert the method named doIt between these 
// lines. 
EE // 
}//end class definition 
Ji a a ey 
Table 7.35 


7.3.4.2 Question 17 
Write the program described in Listing 17 (p. 2985) . 
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Listing 17 . Listing for Question 17. 


/*File Ap0020b1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 

Beginning with the code fragment shown below, write a 
method named doIt that: 

1. Illustrates the detrimental impact of integer arithmetic 
overflow. 


FOSS SOO IO AAS IIIS II II IAI I ICI I A IK I I A A aK ak ok ak kk ak EN 
public class Ap0020b1{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class definition 


i ae ey 
class Worker{ 
/[----------------------------------------------------- Ti 
//Student: insert the method named doIt between these 
// lines. 
/L----------------------------------------------------- // 
}ł}//end class definition 
/ /====================================================== / / 
Table 7.36 


7.3.4.3 Question 18 
Write the program described in Listing 18 (p. 2986) . 
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Listing 18 . Listing for Question 18. 


/*File Ap0020c1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 

Beginning with the code fragment shown below, write a 
method named doIt that: 

1. Illustrates the effect of integer truncation that 
occurs with integer division. 


FOS OO GSAS OSS IIIS ASAI II IAI ICI ICI I I I A I I A I aK ak 2k ak ok a ak EN 
public class Ap0020c1if{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class definition 


i ae ey 
class Worker{ 
/[----------------------------------------------------- Ti 
//Student: insert the method named doIt between these 
// lines. 
/L----------------------------------------------------- // 
}ł}//end class definition 
/ /====================================================== / / 
Table 7.37 


7.3.4.4 Question 19 
Write the program described in Listing 19 (p. 2987) . 
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Listing 19 . Listing for Question 19. 


/*File Ap0020d1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 

Beginning with the code fragment shown below, write a 
method named doIt that: 

1. Illustrates the effect of double divide by zero. 
2. Illustrates the effect of integer divide by zero. 


FOS OO SSO IOS IO IORI ISAS III II II I A I A I A I I aK a ok ak ok a ak a / 
public class Ap0020d1f{ 
public static void main(String args[]){ 
new Worker().doItQ; 
}//end main() 
}//end class definition 


i ae ey 
class Worker{ 
/[----------------------------------------------------- Ti 
//Student: insert the method named doIt between these 
// lines. 
/L----------------------------------------------------- // 
}ł}//end class definition 
/ /===================================================== / / 
Table 7.38 


7.3.4.5 Question 20 
Write the program described in Listing 20 (p. 2988) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2982 CHAPTER 7. OOP SELF-ASSESSMENT 


Listing 20 . Listing for Question 20. 


/*File Ap0020e1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 

Beginning with the code fragment shown below, write a 
method named doIt that: 

1. Illustrates the effect of the modulus operation with 
integers. 


FOO IO ASA IRIS IAI ICI I II I A I A I KA kK a 2k ak ok ak ak EN 
public class Ap0020e1f{ 
public static void main(String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class definition 


i ae ey 
class Worker{ 
/[----------------------------------------------------- Ti 
//Student: insert the method named doIt between these 
// lines. 
/L----------------------------------------------------- // 
}ł}//end class definition 
/ /====================================================== / / 
Table 7.39 


7.3.4.6 Question 21 
Write the program described in Listing 21 (p. 2989) . 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2983 


Listing 21 . Listing for Question 21. 


/*File Ap0020f1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 

Beginning with the code fragment shown below, write a 
method named doIt that: 

1. Illustrates the effect of the modulus operation with 
doubles. 


FESO SOOO OAS IRIS II IAI ICICI I A I A I I I A aK a1 2k ak ak a ak a / 
public class Ap0o20f1f{ 
public static void main(String args[]){ 
new Worker().doItQ; 
}//end main() 
}//end class definition 


i ae ey 
class Worker{ 
/[----------------------------------------------------- Ti 
//Student: insert the method named doIt between these 
// lines. 
/L----------------------------------------------------- // 
}ł}//end class definition 
/ /======================================================= / / 
Table 7.40 


7.3.4.7 Question 22 
Write the program described in Listing 22 (p. 2990) . 
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Listing 22 . Listing for Question 22. 


/*File Ap0020g1.java Copyright 2012, R.G.Baldwin 


Instructions to student: 

Beginning with the code fragment shown below, write a 
method named doIt that: 

1. Illustrates the concatenation of the following strings 
separated by space characters. 


"This" 
" is" 
"foun" 


Cause your program to produce the following output: 
This 
is 
fun 
This is fun 
FOSSA OAS OI I II I I I IK I ICI IK 1 4 21 4 2k FA 1K EEE EEEE a aK a EEE EEEN 
public class Ap0020g1f{ 

public static void main(String args[]){ 

new Worker() .doItQ; 

}//end main() 

}//end class definition 


a a ey 
class Worker{ 

/L----------------------------------------------------- // 

//Student: insert the method named doIt between these 

// lines. 

[| -------- 7-7-7525 22222 nnn nn nnn nnn nnn nnn nnn nne // 
}//end class definition 
Poy / 

Table 7.41 


7.3.5 Listings 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


Listing 1 (p. 2973) . Listing for Question 1. 
Listing 2 (p. 2974) . Listing for Question 2. 
Listing 3 (p. 2975) . Listing for Question 3. 
Listing 4 (p. 2976) . Listing for Question 4. 
Listing 5 (p. 2977) . Listing for Question 5. 
Listing 6 (p. 2977) . Listing for Question 6. 

( ) 


Listing 7 (p. 2978) . Listing for Question 7. 
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e Listing 8 (p. 2979) . Listing for Question 8. 

e Listing 9 (p. 2979) . Listing for Question 9. 

e Listing 10 (p. 2980) . Listing for Question 10. 
e Listing 11 (p. 2981) . Listing for Question 11. 
e Listing 12 (p. 2981) . Listing for Question 12. 
e Listing 13 (p. 2982) . Listing for Question 13. 
e Listing 14 (p. 2983) . Listing for Question 14. 
e Listing 15 (p. 2983) . Listing for Question 15. 
e Listing 16 (p. 2984) . Listing for Question 16. 
e Listing 17 (p. 2985) . Listing for Question 17. 
e Listing 18 (p. 2986) . Listing for Question 18. 
e Listing 19 (p. 2987) . Listing for Question 19. 
e Listing 20 (p. 2988) . Listing for Question 20. 
e Listing 21 (p. 2989) . Listing for Question 21. 
e Listing 22 (p. 2990) . Listing for Question 22. 


7.3.6 Miscellaneous 


This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Ap0020: Self-assessment, Assignment and Arithmetic Operators 
e File: Ap0020.htm 

e Originally published: January 7, 2002 

e Published at cnx.org: 12/01/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.3.7 Answers 


7.3.7.1 Answer 15 
C. -3 2 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


2986 CHAPTER 7. OOP SELF-ASSESSMENT 


7.3.7.1.1 Explanation 15 


String concatenation 

This program uses String concatenation, which has not been previously discussed in this group of 
self-assessment modules. 

In this case, the program executes both an integer divide operation and an integer modulus operation, 
using String concatenation to display both results on a single line of output. 

Quotient = -3 with a remainder of 2 

Thus, the displayed result is the integer quotient followed by the remainder. 

What is String concatenation? 

If either operand of the plus (+) operator is of type String , no attempt is made to perform arithmetic 
addition. Rather, the other operand is converted to a String , and the two strings are concatenated. 

A space character, " " 

The string containing a space character (" ") in this expression appears as the right operand of one plus 
operator and as the left operand of the other plus operator. 

If you already knew about String concatenation, you should have been able to figure out the correct 
answer to the question on the basis of the answers to earlier questions in this module. 

Back to Question 15 (p. 2983) 


7.3.7.2 Answer 14 
D. NaN 


7.3.7.2.1 Explanation 14 


Floating modulus operation involves floating divide 
The modulus operation with floating operands and 0.0 as the right operand produces NaN , which 
stands for Not a Number . 
What is the actual value of Not a Number? 
A symbolic constant that is accessible as Double.NaN specifies the value that is returned in this case. 
Be careful what you try to do with it. It has some peculiar behavior of its own. 
Back to Question 14 (p. 2982) 


7.3.7.3 Answer 13 
D. 1.5499999999999996 


7.3.7.3.1 Explanation 13 


A totally incorrect result 

Unfortunately, due to floating arithmetic inaccuracy, the modulus operation in this program produces an 
entirely incorrect result. 

The result should be 0.0, and that is the result produced by my hand calculator. 

Terminates one step too early 

However, this program terminates the repetitive subtraction process one step too early and produces an 
incorrect remainder. 

Be careful 

This program is included here to emphasize the need to be very careful how you interpret the result of 
performing modulus operations on floating operands. 

Back to Question 13 (p. 2982) 


7.3.7.4 Answer 12 
C. -0.010999999999999996 
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7.3.7.4.1 Explanation 12 


Modulus operator can be used with floating types 

In this case, the program returns the remainder that would be produced by dividing a double value of 
-0.11 by a double value of 0.033 and terminating the divide operation at the beginning of the fractional part 
of the quotient. 

Say that again 

Stated differently, the result of the modulus operation is the remainder that results after 


e subtracting the right operand from the left operand an integral number of times, and 
e terminating the repetitive subtraction process when the result of the subtraction is less than the right 
operand 


Modulus result is not exact 

According to my hand calculator, taking into account the fact that the left operand is negative, this 
operation should produce a modulus result of -0.011. As you can see, the result produced by the application 
of the modulus operation to floating types is not exact. 

Back to Question 12 (p. 2981) 


7.3.7.5 Answer 11 


B. Runtime Error 


7.3.7.5.1 Explanation 11 


Integer modulus involves integer divide 

The modulus operation with integer operands involves an integer divide. 

Therefore, it is subject to the same kind of problem as an ordinary integer divide when the right operand 
has a value of zero. 

Program produces a runtime error 

In this case, the program produced a runtime error that terminated the program. The error produced 
by JDK 1.3 is as follows: 


Exception in thread "main" java.lang.ArithmeticException: / by zero 
at Worker.doMod(Ap020. java: 14) 
at Ap020.main(Ap020.java:6) 


Table 7.42 


Dealing with the problem 

As with integer divide, you can either test the right operand for a zero value before performing the 
modulus operation, or you can deal with the problem after the fact using try-catch. 

Back to Question 11 (p. 2980) 
7.3.7.6 Answer 10 


D. -2 
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7.3.7.6.1 Explanation 10 


What is a modulus operation? 

In elementary terms, we like to say that the modulus operation returns the remainder that results from 
a divide operation. 

In general terms, that is true. 

Some interesting behavior 

However, the modulus operation has some interesting behaviors that are illustrated in this and the next 
several questions. 

This program returns the modulus of -11 and 3, with -11 being the left operand. 

What is the algebraic sign of the result? 

Here is a rule: 

The result of the modulus operation takes the sign of the left operand, regardless of the sign of the 
quotient and regardless of the sign of the right operand. In this program, that produced a result of -2. 

Changing the sign of the right operand would not have changed the sign of the result. 

Exercise care with sign of modulus result 

Thus, you may need to exercise care as to how you interpret the result when you perform a modulus 
operation having a negative left operand. 

Back to Question 10 (p. 2980) 


7.3.7.7 Answer 9 
C. Infinity 


7.3.7.7.1 Explanation 9 


Floating divide by zero 
This program attempts to divide the double value of 11 by the double value of zero. 
No runtime error with floating divide by zero 
In the case of floating types, an attempt to divide by zero does not produce a runtime error. Rather, it 
returns a value that the println method interprets and displays as Infinity. 
What is the actual value? 
The actual value returned by this program is provided by a static final variable in the Double class 
named POSITIVE INFINITY 
(There is also a value for NEGATIVE_INFINITY, which is the value that would be returned if one of 
the operands were a negative value.) 
Is this a better approach? 
Is this a better approach than throwing an exception as is the case for integer divide by zero? 
I will let you be the judge of that. 
In either case, you can test the right operand before the divide to assure that it isn’t equal to zero. 
Cannot use exception handling in this case 
For floating divide by zero, you cannot handle the problem by using try-catch. 
However, you can test the result following the divide to see if it is equal to either of the infinity values 
mentioned above. 
Back to Question 9 (p. 2979) 


7.3.7.8 Answer 8 


B. Runtime Error 
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7.3.7.8.1 Explanation 8 


Dividing by zero 
This program attempts to divide the int value of 11 by the int value of zero. 
Integer divide by zero is not allowed 
This produces a runtime error and terminates the program. 
The runtime error is as follows under JDK 1.3: 


Exception in thread "main" java.lang.ArithmeticException: / by zero 
at Worker .doMixed(Ap017.java:14) 
at Ap017.main(Ap017.java:6) 


Table 7.43 


Two ways to deal with this sort of problem 

One way is to test the right operand before each divide operation to assure that it isn’t equal to zero, 
and to take appropriate action if it is. 

A second (possibly preferred) way is to use exception handling and surround the divide operation with 
a try block, followed by a catch block for the type 


java.lang.ArithmeticException. 


Table 7.44 


The code in the catch block can be designed to deal with the problem if it occurs. (Exception handling 
will be discussed in a future module.) 
Back to Question 8 (p. 2978) 


7.3.7.9 Answer 7 
E. 33 


7.3.7.9.1 Explanation 7 


Integer truncation 

This program illustrates the integer truncation that results when the division operator is applied to 
operands of the integer types. 

The result of simple long division 

We all know that when we divide 101 by 3, the result is 33.666666 with the sixes extending out to the 
limit of our arithmetic accuracy. 

The result of rounding 

If we round the result to the next closest integer, the result is 34. 

Integer division does not round 

However, when division is performed using operands of integer types in Java, the fractional part is simply 
discarded (not rounded) . 

The result is the whole number result without regard for the fractional part or the remainder. 

Thus, with integer division, 101/3 produces the integer value 33. 
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If either operand is a floating type ... 
If either operand is one of the floating types, 


e the integer operand will be converted to the floating type, 
e the result will be of the floating type, and 
e the fractional part of the result will be preserved to some degree of accuracy 


Back to Question 7 (p. 2978) 


7.3.7.10 Answer 6 
D. -2147483647 


7.3.7.10.1 Explanation 6 


Danger, integer overflow ahead! 

This program illustrates a very dangerous situation involving arithmetic using operands of integer types. 
This situation involves a condition commonly known as integer overflow . 

The good news 

The good news about doing arithmetic using operands of integer types is that as long as the result is 
within the allowable value range for the wider of the integer types, the results are exact (floating arithmetic 
often produces results that are not exact) . 

The bad news 

The bad news about doing arithmetic using operands of integer types is that when the result is not 
within the allowable value range for the wider of the integer types, the results are garbage, having no usable 
relationship to the correct result (floating arithmetic has a high probability of producing approximately 
correct results, even though the results may not be exact). 

For this specific case ... 

As you can see by the answer to this question, when a value of 2 was added to the largest positive value 
that can be stored in type int , the incorrect result was a very large negative value. 

The result is simply incorrect. (If you know how to do binary arithmetic, you can figure out how this 
happens.) 

No safety net in this case — just garbage 

Furthermore, there was no compiler error and no runtime error. The program simply produced an 
incorrect result with no warning. 

You need to be especially careful when writing programs that perform arithmetic using operands of 
integer types. Otherwise, your programs may produce incorrect results. 

Back to Question 6 (p. 2977) 


7.3.7.11 Answer 5 
C. 4.294967294E9 


7.3.7.11.1 Explanation 5 


Mixed-type arithmetic 

This program illustrates the use of arithmetic operators with operands of different types. 

Declare and initialize an int 

The method named doMixed declares a local variable of type int named myIntVar and initializes 
it with the largest positive value that can be stored in type int 

Evaluate an arithmetic expression 

An arithmetic expression involving myIntVar is evaluated and the result is passed as a parameter to 
the println method where it is displayed on the computer screen. 
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Multiply by a literal double value 

The arithmetic expression uses the multiplication operator (*) to multiply the value stored in myInt Var 
by 2.0 (this literal operand is type double by default) . 

Automatic conversion to wider type 

When arithmetic is performed using operands of different types, the type of the operand of the narrower 
type is automatically converted to the type of the operand of the wider type, and the arithmetic is performed 
on the basis of the wider type. 

Result is of the wider type 

The type of the result is the same as the wider type. 

In this case ... 

Because the left operand is type double , the int value is converted to type double and the 
arithmetic is performed as type double 

This produces a result of type double , causing the floating value 4.294967294E9 to be displayed on 
the computer screen. 

Back to Question 5 (p. 2976) 


7.3.7.12 Answer 4 
C. 2147483647 


7.3.7.12.1 Explanation 4 


Uses a cast operator 

This program, named Ap013.java , differs from the earlier program named Ap012.java_ in one 
important respect. 

This program uses a cast operator to force the compiler to allow a narrowing conversion in order to 
assign a double value to an int variable. 

The cast operator 

The statement containing the cast operator is shown below for convenient viewing. 


myIntVar = (int)myDoubleVar; 


Table 7.45 


Syntax of a cast operator 

The cast operator consists of the name of a type contained within a pair of matching parentheses. 

A unary operator 

The cast operator always appears to the left of an expression whose type is being converted to the type 
specified by the cast operator. 

Assuming responsibility for potential problems 

When dealing with primitive types, the cast operator is used to notify the compiler that the programmer 
is willing to assume the risk of a possible loss of precision in a narrowing conversion. 

No loss of precision here 

In this case, there was no loss in precision, but that was only because the value stored in the double 
variable was within the allowable value range for an int 

In fact, it was the largest positive value that can be stored in the type int . Had it been any larger, a 
loss of precision would have occurred. 

More on this later ... 

I will have quite a bit more to say about the cast operator in future modules. I will also have more to 
say about the use of the assignment operator in conjunction with the non-primitive types. 
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Back to Question 4 (p. 2975) 


7.3.7.13 Answer 3 


A. Compiler Error 


7.3.7.13.1 Explanation 3 


Conversion from double to int is not automatic 

This program attempts to assign a value of type double to a variable of type int 

Even though we know that the specific double value involved would fit in the int variable with no loss 
of precision, the conversion from double to int is not a widening conversion. 

This is a narrowing conversion 

In fact, it is a narrowing conversion because the allowable value range for an int is less than the 
allowable value range for a double 

The conversion is not allowed by the compiler. The following compiler error occurs under JDK 1.3: 


Ap012.java:16: possible loss of precision 
found : double 
required: int 
myIntVar = myDoubleVar myIntVar = myDoubleVar; 


Table 7.46 


Back to Question 3 (p. 2974) 


7.3.7.14 Answer 2 
C. 2.147483647E9 


7.3.7.14.1 Explanation 2 


Declare a double 

The method named doAsg first declares a local variable of type double named myDoubleVar 
without providing an initial value. 

Declare and initialize an int 

Then it declares an int variable named mylIntVar and initializes its value to the integer value 
2147483647 (you learned about Integer. MAX_ VALUE in an earlier module) . 

Assign the int to the double 

Following this, the method assigns contents of the int variable to the double variable. 

An assignment compatible conversion 

This is an assignment compatible conversion. In particular, the integer value of 2147483647 is auto- 
matically converted to a double value and stored in the double variable. 

The double representation of that value is what appears on the screen later when the value of 
myDoubleVar is displayed. 

What is an assignment compatible conversion? 

An assignment compatible conversion for the primitive types occurs when the required conversion is a 
widening conversion. 

What is a widening conversion? 
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A widening conversion occurs when the allowable value range of the type of the left operand of the 
assignment operator is greater than the allowable value range of the right operand of the assignment operator. 

A double is wider than an int 

Since the allowable value range of type double is greater than the allowable value range of type int 
, assignment of an int value toa double variable is allowed, with conversion from int to double 
occurring automatically. 

A safe conversion 

It is also significant to note that there is no loss in precision when converting from an int toa double 


An unsafe but allowable conversion 

However, a loss of precision may occur when an int is assigned to a float , or when a long is 

assigned to a double 
What would a float produce ? 

The value of 2.14748365E9 shown for selection D is what you would see for this program if you were 
to change the double variable toa float variable. (Contrast this with 2147483647 to see the loss of 
precision.) 

Widening is no guarantee that precision will be preserved 

The fact that a type conversion is a widening conversion does not guarantee that there will be no loss 
of precision in the conversion. It simply guarantees that the conversion will be allowed by the compiler. In 
some cases, such as that shown above (p. 2999) , an assignment compatible conversion can result in a loss 
of precision, so you always need to be aware of what you are doing. 

Back to Question 2 (p. 2973) 


7.3.7.15 Answer 1 
E. 7.0 


7.3.7.15.1 Explanation 1 


Declare but don’t initialize a double variable 

The method named doAsg begins by declaring a double variable named myVar without initializing 
it. 

Use the simple assignment operator 

The simple assignment operator (=) is then used to assign the double value 3.0 to the variable. 
Following the execution of that statement, the variable contains the value 3.0. 

Use the arithmetic/assignment operator 

The next statement uses the combined arithmetic/assignment operator (+=) to add the value 4.0 to the 
value of 3.0 previously assigned to the variable. The following two statements are functionally equivalent: 


myVar += 4.0; 


myVar = myVar + 4.0; 


Table 7.47 
Two statements are equivalent 


This program uses the first statement listed above. If you were to replace the first statement with the 
second statement, the result would be the same. 
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In this case, either statement would add the value 4.0 to the value of 3.0 that was previously assigned 
to the variable named myVar , producing the sum of 7.0. Then it would assign the sum of 7.0 back to 
the variable. When the contents of the variable are then displayed, the result is that 7.0 appears on the 
computer screen. 

No particular benefit 

To the knowledge of this author, there is no particular benefit to using the combined arith- 
metic/assignment notation other than to reduce the amount of typing required to produce the source code. 
However, if you ever plan to interview for a job as a Java programmer, you need to know how to use the 
combined version. 

Four other similar operators 

Java support several combined operators. Some involve arithmetic and some involve other operations 

such as bit shifting. Five of the combined operators are shown below. These five all involve arithmetic. 


In all five cases, you can construct a functionally equivalent arithmetic and assignment statement in the 
same way that I constructed the functionally equivalent statement for += above. 

Back to Question 1 (p. 2973) 

-end- 


7.4 Ap0030: Self-assessment, Relational Operators, Increment Op- 
erator, and Control Structures’ 


7.4.1 Table of Contents 


e Preface (p. 3000) 
e Questions (p. 3001) 


1 (p. 3001) , 2 (p. 3001) , 3 (p. 3003) , 4 (p. 3004) , 5 (p. 3005) , 6 (p. 3006) , 7 (p. 3007) , 8 
(p. 3008) , 9 (p. 3009) , 10 (p. 3010) , 11 (p. 3011) , 12 (p. 3012) , 13 (p. 3013) , 14 (p. 3014) , 
15 (p. 3015) 
) 


e Listings (p. 3016 
e Miscellaneous (p. 3016) 
e Answers (p. 3017) 


7.4.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

The test consists of a series of questions with answers and explanations of the answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 3016) to easily find and view the listings while you are reading about them. 


®This content is available online at <http://cnx.org/content /m45287/1.4/>. 
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7.4.3 Questions 
7.4.3.1 Question 1 


Given: The use of String concatenation in the argument list of the call to the println method in the 
program shown in Listing 1 (p. 3001) will cause seven items to be displayed on the screen, separated by 
spaces. 

True or False? The program produces the output shown below: 


false true false false true true false 


Table 7.48 


Listing 1 . Listing for Question 1. 


public class Ap025{ 
public static void main( 
String args[]){ 
new Worker () .doRelat () ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doRelat(){ 


int a = 1, b= 2, c= 3, d= 2; 

System. out .print1n( 
(a = b) um 
(b —— d) + om my 
(b l= d) + ow my 
(c < a) + woot + 
(b = d) + og 
(c > d) + un + 
(a >= c)); 


}//end doRelat () 
}//end class definition 


Table 7.49 
Answer and Explanation (p. 3025) 
7.4.3.2 Question 2 
What output is produced by the program shown in Listing 2 (p. 3003) ? 


e A. Compiler Error 
e B. Runtime Error 
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e C. true 
e D. false 
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Listing 2 . Listing for Question 2. 


public class Ap026{ 
public static void main( 
String args[]){ 
new Worker () .doRelat() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doRelatQ{ 
Dummy x = new Dummy(); 
Dummy y = new Dummy(); 
System.out.printin(x == y); 
}//end doRelat () 
}//end class definition 


class Dummy{ 

int x = 5; 

double y = 5.5; 

String z = "A String Object"; 
}//end class Dummy 


Table 7.50 


Answer and Explanation (p. 3024) 


7.4.3.3 Question 3 


What output is produced by the program shown in Listing 3 (p. 3004) ? 


A. Compiler Error 
B. Runtime Error 
C. true 
D. false 
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Listing 3 . Listing for Question 3. 


public class Ap027{ 
public static void main( 
String args[]){ 
new Worker () .doRelat() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doRelatQ){ 
Dummy x = new Dummy(); 
Dummy y = new Dummy(); 
System. out.println(x.equals(y)); 
}//end doRelat () 
}//end class definition 


class Dummy{ 

int x = 5; 

double y = 5.5; 

String z = "A String Object"; 
}//end class Dummy 


Table 7.51 


Answer and Explanation (p. 3023) 


7.4.3.4 Question 4 
What output is produced by the program shown in Listing 4 (p. 3005) ? 


A. Compiler Error 
B. Runtime Error 
C. true false 
D. false true 
E. true true 
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Listing 4 . Listing for Question 4. 


public class Ap028{ 
public static void main( 
String args[]){ 
new Worker () .doRelat() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doRelatQ{ 
Dummy x = new Dummy(); 


Dummy y = X; 
System. out .print1n( 
(x == y) +" " + x.equals(y)); 


3//end doRelat () 
}//end class definition 


class Dummy{ 

int x = 5; 

double y = 5.5; 

String z "A String Object"; 
}//end class Dummy 


Table 7.52 


Answer and Explanation (p. 3023) 


7.4.3.5 Question 5 
What output is produced by the program shown in Listing 5 (p. 3006) ? 


A. Compiler Error 
B. Runtime Error 
C. true 
D. false 
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Listing 5 . Listing for Question 5. 


public class Ap029{ 
public static void main( 
String args[]){ 
new Worker () .doRelat() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doRelatQ{ 
Dummy x = new Dummy(); 
Dummy y = new Dummy(); 
System.out.println(x > y); 
}//end doRelat () 
}//end class definition 


class Dummy{ 

int x = 5; 

double y = 5.5; 

String z = "A String Object"; 
}//end class Dummy 


Table 7.53 


Answer and Explanation (p. 3023) 


7.4.3.6 Question 6 


What output is produced by the program shown in Listing 6 (p. 3007) ? 


A. Compiler Error 

B. Runtime Error 

C. 5 5 8.3 8.3 

D. 6 4 9.3 7.300000000000001 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3001 


Listing 6 . Listing for Question 6. 


public class Ap030{ 
public static void main( 
String args[]){ 
new Worker () .doIncr() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doIncr(){ 
int w= 5, x = 5; 
double y = 8.3, z = 8.3; 


Wtt 3 

xX--; 

ytt; 

Zz--; 

System. out.println(w +" "+ 
x + LLI "u + 
y + "u "u + 
zZ); 


}//end doIncr() 
}//end class definition 


Table 7.54 


Answer and Explanation (p. 3022) 


7.4.3.7 Question 7 


What output is produced by the program shown in Listing 7 (p. 3008) ? 


A. Compiler Error 
B. Runtime Error 

C. Hello 

D. None of the above 
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Listing 7 . Listing for Question 7. 


public class Ap031{ 
public static void main( 
String args[]){ 
new Worker() .dolfQ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doIf(){ 
int x = 5, y = 6; 
if(x - y){ 
System.out.println("Hello") ; 
}//end if 
}//end dolf() 
}//end class definition 


Table 7.55 


Answer and Explanation (p. 3022) 


7.4.3.8 Question 8 
What output is produced by the program shown in Listing 8 (p. 3009) ? 


A. Compiler Error 
B. Runtime Error 

C. World 

D. Hello World 

E. None of the above 
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Listing 8 . Listing for Question 8. 


public class Ap032{ 
public static void main( 
String args[]){ 
new Worker() .dolfQ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doIf(){ 
int x = 5, y = 6; 
if(x < y)f 
System.out.print("Hello "); 
}//end if 
System. out.println("World") ; 
}//end doIf() 
}//end class definition 


Table 7.56 


Answer and Explanation (p. 3021) 


7.4.3.9 Question 9 
What output is produced by the program shown in Listing 9 (p. 3010) ? 


A. Compiler Error 
B. Runtime Error 

C. Hello World 

D. Goodbye World 
E. None of the above 
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Listing 9 . Listing for Question 9. 


public class Ap033{ 
public static void main( 
String args[]){ 
new Worker() .dolfQ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doIf(){ 
int x = 5, y = 6; 
if(x == y){ 
System.out .print1n( 
"Hello World"); 
}else{ 
System.out.println( 
"Goodbye World"); 
}//end else 
}//end doIf() 
}//end class definition 


Table 7.57 


Answer and Explanation (p. 3020) 


7.4.3.10 Question 10 
What output is produced by the program shown in Listing 10 (p. 3011) ? 


e A. Compiler Error 

e B. Runtime Error 

e C.x=4 

e D.x=5 

e E.x=6 

e F.x!= 4,5,6 

e G. None of the above 
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Listing 10 . Listing for Question 10. 


public class Ap034{ 
public static void main( 
String args[]){ 
new Worker() .dolfQ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doIf(){ 
int x = 2; 
if(x == 4){ 


System.out.println("x = 4"); 
}else if (x == 5){ 

System.out.println("x = 5"); 
}else if (x == 6){ 

System.out.println("x = 6"); 


}else{ 
System.out.println("x != 4,5,6"); 
}//end else 
}//end doIf() 
}//end class definition 


Table 7.58 


Answer and Explanation (p. 3020) 


7.4.3.11 Question 11 


What output is produced by the program shown in Listing 11 (p. 3012) ? 


A. Compiler Error 
B. Runtime Error 
C.01234 
D.12345 

E. None of the above 
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Listing 11 . Listing for Question 11. 


public class Ap035{ 
public static void main( 
String args[]){ 
new Worker () .doLoop() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doLoop(){ 
int cnt = 0; 
while(cnt<5){ 
cntt++; 
System.out.print(cnt + " "); 
cntt++; 
}//end while loop 
System.out.println("") ; 
}//end doLoop() 
}//end class definition 


Table 7.59 


Answer and Explanation (p. 3020) 


7.4.3.12 Question 12 


What output is produced by the program shown in Listing 12 (p. 3013) ? 


A. Compiler Error 
B. Runtime Error 
C.012345 
D.123455 

E. None of the above 
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Listing 12 . Listing for Question 12. 


public class Ap036{ 
public static void main( 
String args[]){ 
new Worker () .doLoop() ;s 
}//end main() 
}//end class definition 


class Worker{ 
public void doLoop(){ 


int cnt; 
for(cnt = 0; cnt < 5; cnt++){ 
System.out.print(cnt + " "); 


}//end for loop 
System.out.println(cnt + " "); 
}//end doLoop() 
}//end class definition 


Table 7.60 


Answer and Explanation (p. 3019) 


7.4.3.13 Question 13 
What output is produced by the program shown in Listing 13 (p. 3014) ? 


A. Compiler Error 
B. Runtime Error 
C.012345 
D.123455 

E. None of the above 
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Listing 13 . Listing for Question 13. 


public class Ap037{ 
public static void main( 
String args[]){ 
new Worker () .doLoop() ;s 
}//end main() 
}//end class definition 


class Worker{ 
public void doLoop()f{ 
for(int cnt = 0; cnt < 5; cnt++){ 
System.out.print(cnt + " "); 
}//end for loop 
System.out.printin(cnt + " "); 
}//end doLoop() 
}//end class definition 


Table 7.61 


Answer and Explanation (p. 3018) 


7.4.3.14 Question 14 
What output is produced by the program shown in Listing 14 (p. 3015) ? 


A. Compiler Error 
B. Runtime Error 
C.01233 
D.01234 

E. None of the above 
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Listing 14 . Listing for Question 14. 


public class Ap037{ 
public static void main( 
String args[]){ 
new Worker () .doLoop() ;s 
}//end main() 
}//end class definition 


class Worker{ 
public double doLoop(){ 
for(int cnt = 0; cnt < 5; cnt++){ 
System.out.print(cnt + " "); 
if(cnt == 3){ 
System. out.println(cnt) ; 
return cnt; 
}//end if 
}//end for loop 
//return 3.5; 
}//end doLoop() 
}//end class definition 


Table 7.62 


Answer and Explanation (p. 3017) 


7.4.3.15 Question 15 
What output is produced by the program shown in Listing 15 (p. 3016) ? 


A. Compiler Error 
B. Runtime Error 
C.012338 
D.01234 

E. None of the above 
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Listing 15 . Listing for Question 15. 


public class Ap038{ 
public static void main( 
String args[]){ 
new Worker () .doLoop() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doLoop()f{ 
for(int cnt = 0; cnt < 5; cnt++){ 
System.out.print(cnt + " "); 
if(cnt == 3){ 
System. out.println(cnt) ; 
return; 
}//end if 
}//end for loop 
}//end doLoop() 
}//end class definition 


Table 7.63 


Answer and Explanation (p. 3017) 


7.4.4 Listings 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


Listing 1 (p. 3001) 
Listing 2 (p. 3003) 
Listing 3 (p. 3004) 
Listing 4 (p. 3005) 
Listing 5 (p. 3006) . 
Listing 6 (p. 3007) 
Listing 7 (p. 3008) 
Listing 8 (p. 3009) 
Listing 9 (p ) 
Listing 10 (p. 3011) 
Listing 11 (p. 3012) 
Listing 12 (p. 3013) 
Listing 13 (p. 3014) . 
Listing 14 (p. 3015) 
Listing 15 (p. 3016) 


7.4.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


. Listing for Question 1. 
. Listing for Question 2. 
. Listing for Question 3. 
. Listing for Question 4. 
Listing for Question 5. 
. Listing for Question 6. 
. Listing for Question 7. 
. Listing for Question 8. 
. Listing for Question 9. 


. Listing for Question 10. 
. Listing for Question 11. 
. Listing for Question 12. 
Listing for Question 13. 
. Listing for Question 14. 
. Listing for Question 15. 
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Housekeeping material 


e Module name: Ap0030: Self-assessment, Relational Operators, Increment Operator, and Con- 
trol Structures 

e File: Ap0030.htm 

e Originally published: January, 2002 

e Published at cnx.org: 12/02/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.4.6 Answers 
7.4.6.1 Answer 15 
C.01233 


7.4.6.1.1 Explanation 15 


No return statement is required 

A method with a signature that specifies a void return type does not require a return statement. 

However, such a method may contain a return statement, provided that it is terminated immediately 
with a semicolon (no expression between the word return and the semicolon) . 

(Every method whose return type is not void must contain at least one return statement.) 

Multiple return statements are allowed 

Any method may contain any number of return statements provided that they make sense from a 
syntax viewpoint, and provided the expression (or lack thereof) between the word return and the 
semicolon evaluates to the type specified in the method signature (or a type that will be automatically 
converted to the type specified in the method signature) . 

A return statement terminates a method immediately 

Whenever the execution stream encounters any return statement, the method is terminated immedi- 
ately, and control is returned to the method that called that method. 

Back to Question 15 (p. 3015) 


7.4.6.2 Answer 14 


A. Compiler Error 
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7.4.6.2.1 Explanation 14 


Missing return statement 
This program produces the following compiler error under JDK 1.3: 


Ap037.java:11: missing return statement 
public int doLoop(){ 


Table 7.64 


Even though this program contains a return statement inside the for loop, it is still necessary to 
place a return statement at the end of the method to satisfy the compiler. (The one shown in the code 
is a comment.) 

The method named doLoop must return a value of type double . Apparently the compiler assumes 
that the return statement inside the for loop may never be executed (although that isn’t true in this 
case) . 

Both of the return statements must return a value that satisfies the double type requirement given 
in the method signature. 

Returning a value of type int inthe for loop will satisfy the type requirement because type int 
will be automatically converted to type double as it is returned. (Conversion from type int to type 
double is a widening conversion.) 

Back to Question 14 (p. 3014) 


7.4.6.3 Answer 13 


A. Compiler Error 


7.4.6.3.1 Explanation 13 


The scope of a local variable 

In general, the scope of a local variable extends from the point at which it is declared to the curly brace 
that signals the end of the block in which it is declared. 

This applies to for loop in an interesting way 

While it is allowable to declare a variable within the first clause of a for loop, the scope of that variable 
is limited to the block of code contained in the loop structure. 

The variable cannot be accessed outside the loop. 

Attempts to access variable out of scope 

This program attempts to access the value of the variable named cnt after the loop terminates. 

The program displays the following compiler error under JDK 1.3. This error results from the attempt 
to display the value of the counter after the loop terminates. 


Ap037.java:15: cannot resolve symbol 
symbol : variable cnt 
location: class Worker 
System.out.printin(cnt + " "); 


Table 7.65 


Back to Question 13 (p. 3013) 
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7.4.6.4 Answer 12 
C.012345 


7.4.6.4.1 Explanation 12 


A simple for loop structure 

This program illustrates a simple for loop that displays the value of its counter using a call to the 
print method inside the loop. 

After the loop terminates, the program displays the value of the counter one last time using a call to 
println 

Three clauses separated by semicolons 

The first line of a for loop structure always contains three clauses separated by semicolons. 

The first and third clauses may be empty, but the semicolons are required in any case. 

The first clause ... 

The first clause is executed once and only once at the beginning of the loop. 

It can contain just about any valid Java expression. 

It can even contain more than one expression with the individual expression separated by commas. 

When the first clause contains more than one expression separated by commas, the expressions are 
evaluated in left-to-right order. 

The second clause 

The second clause is a conditional clause. It must contain an expression that returns a boolean value. 

(Actually, this clause can also be empty, in which case it is apparently assumed to be true. This leads 
to an infinite loop unless there is some code inside the loop to terminate it, perhaps by executing a return 
or a break statement.) 

An entry-condition loop 

The for loop is an entry condition loop, meaning that the conditional expression is evaluated once 
immediately after the first clause is executed, and once per iteration thereafter. 

Behavior of the for loop 

If the conditional expression returns true, the block of code following the closing parenthesis is executed. 
If it returns false, the block of code is skipped, and control passes to the first executable statement 
following the block of code. 

(For the case where the block contains only one statement, the matching curly brackets can be omitted.) 

The third clause 

The third clause can contain none, one, or more valid expressions separated by commas. 

If there are more than one, they are evaluated in left-to-right order. 

When they are evaluated 

The expressions in the third clause are evaluated once during each iteration. 

However, it is very important to remember that despite the physical placement of the clause in the first 
line, the expressions in the third clause are not evaluated until after the code in the block has been evaluated. 

Typically an update clause 

The third clause is typically used to update a counter, but this is not a technical requirement. 

This clause can be used for just about any purpose. 

However, the counter must be updated somewhere within the block of code or the loop will never termi- 
nate. 

(Stated differently, something must occur within the block of code to eventually cause the conditional 
expression to evaluate to false. Otherwise, the loop will never terminate on its own. However, it is possible 
to execute a return or break within the block to terminate the loop.) 

Note the first output value for this program 

Because the update in the third clause is not executed until after the code in the block has been executed, 
the first value displayed (p. 3019) by this program is the value zero. 
Back to Question 12 (p. 3012) 
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7.4.6.5 Answer 11 
E. None of the above 


7.4.6.5.1 Explanation 11 


And the answer is ... 

The output produced by this program is: 

135 

A simple while loop 

This program uses a simple while loop to display the value of a counter, once during each iteration. 

Behavior of a while loop 

As long as the relational expression in the conditional clause returns true, the block of code immediately 
following the conditional clause is executed. 

When the relational expression returns false, the block of code following the conditional clause is skipped 
and control passes to the next executable statement following that block of code. 

An entry-condition loop 

The while loop is an entry condition loop, meaning that the test is performed once during each iteration 
before the block of code is executed. 

If the first test returns false, the block of code is skipped entirely. 

An exit-condition loop 

There is another loop, known as a do-while loop, that performs the test after the block of code has 
been executed once. This guarantees that the block of code will always be executed at least once. 

Just to make things interesting ... 

Two statements using the increment operator were placed inside the loop in this program. 

Therefore, insofar as the conditional test is concerned, the counter is being incremented by twos. This 
causes the output to display the sequence 1 3 5. 

Nested while loops 

The while loop control structure can contain loops nested inside of loops, which leads to some interesting 
behavior. 

Back to Question 11 (p. 3011) 


7.4.6.6 Answer 10 
F. x != 4,5,6 


7.4.6.6.1 Explanation 10 


A multiple-choice structure 

This is a form of control structure that is often used to make logical decisions in a multiple-choice sense. 

This is a completely general control structure. It can be used with just about any type of data. 

A switch structure 

There is a somewhat more specialized, control structure named switch that can also be used to make 
decisions in a multiple choice sense under certain fairly restrictive conditions. 

However, the structure shown in this program can always be used to replace a switch. Therefore, I find 
that I rarely use the switch structure, opting instead for the more general form of multiple-choice structure. 

Back to Question 10 (p. 3010) 


7.4.6.7 Answer 9 
D. Goodbye World 
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7.4.6.7.1 Explanation 9 


An if-else control structure 

This program contains a simple if-else control structure. 

Behavior of if-else structure 

If the expression in the conditional clause returns true, the block of code following the conditional clause 
is executed, and the block of code following the word else is skipped. 

If the expression in the conditional clause returns false, the block of code following the conditional clause 
is skipped, and the block of code following the word else is executed. 

This program executes the else block 

In this program, the expression in the conditional clause returns false. 

Therefore, the block of code following the word else is executed, producing the words Goodbye World 
on the computer screen. 

Can result in very complex structures 

While the structure used in this program is relatively simple, it is possible to create very complex control 
structures by nesting additional if-else structures inside the blocks of code. 

Back to Question 9 (p. 3009) 


7.4.6.8 Answer 8 
D. Hello World 


7.4.6.8.1 Explanation 8 


A simple if statement 
This program contains a simple if statement that 


e uses a relational expression 
e to return a value of type boolean inside its conditional clause 


Tests for x less than y 

The relational expression tests to determine if the value of the variable named x is less than the value 
of the variable named y 

Since the value of x is 5 and the value of y is 6, this relational expression returns true. 

Behavior of an if statement 

If the expression in the conditional clause returns true, the block of code following the conditional clause 

is executed 
What is a block of code? 

A block of code is one or more statements surrounded by matching curly brackets. 

For cases like this one where the block includes only one statement, the curly brackets can be omitted. 
However, I prefer to put them there anyway. They don’t cause any harm and help me avoid programming 
errors if I come back later and add more statements to the body of the if statement. 

Display the word Hello 

In this program, execution of the code in the block causes the print method to be called and the word 

Hello to be displayed followed by a space, but without a newline following the space. 
What if the conditional clause returns false? 

If the expression in the conditional clause returns false, the block of code following the conditional clause 
is bypassed. 

(That is not the case in this program.) 
After the if statement ... 

After the if statement is executed in this program, the printlIn method is called to cause the word 
World to be displayed on the same line as the word Hello . 

Back to Question 8 (p. 3008) 
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7.4.6.9 Answer 7 


A. Compiler Error 


7.4.6.9.1 Explanation 7 
Not the same as C and C++ 


Unlike C and C++, which can use an integer numeric expression in the conditional clause of an 


if 


statement, Java requires the conditional clause of an if statement to contain an expression that will return 


a boolean result. 
Bad conditional expression 


That is not the case in this program, and the following compiler error occurs under JDK 1.3: 


Ap031.java:13: incompatible types 


found : int 
required: boolean 
if(x - y){ 


Table 7.66 


Back to Question 7 (p. 3007) 


7.4.6.10 Answer 6 
D. 6 4 9.3 7.300000000000001 


7.4.6.10.1 Explanation 6 


Postfix increment and decrement operators 


This program illustrates the use of the increment (++) and decrement (—) operators in their postfix form. 


Behavior of increment operator 
Given a variable x , the following two statements are equivalent: 


Table 7.67 


Behavior of decrement operator 
Also, the following two statements are equivalent: 


Table 7.68 
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Prefix and postfix forms available 

These operators have both a prefix form and a postfix form. 

Can be fairly complex 

It is possible to construct some fairly complex scenarios when using these operators and combining them 
into expressions. 

In these modules ... 

In this group of self-assessment modules, the increment and decrement operators will primarily be used 
to update control variables in loops. 

Inaccurate results 

Regarding the program output, you will note that there is a little arithmetic inaccuracy when this program 
is executed using JDK 1.3. (The same is still true with JDK version 1.7.) 

Ideally, the output value 7.300000000000001 should simply be 7.3 without the very small additional 
fractional part, but that sort of thing often happens when using floating types. 

Back to Question 6 (p. 3006) 


7.4.6.11 Answer 5 


A. Compiler Error 


7.4.6.11.1 Explanation 5 


Cannot use > with reference variables 

The only relational operator that can be applied to reference variables is the == operator. 

As discussed in the previous questions, even then it can only be used to determine if two reference 
variables refer to the same object. 

This program produces the following compiler error under JDK 1.3: 


Ap0O29.java:14: operator > cannot be applied to Dummy,Dummy 
System.out.printin(x > y); 


Table 7.69 


Back to Question 5 (p. 3005) 


7.4.6.12 Answer 4 


E. true true 


7.4.6.12.1 Explanation 4 


Two references to the same object 

In this case, the reference variables named x and y both refer to the same object. Therefore, when 
tested for equality, using either the == operator or the default equals method, the result is true. 

Back to Question 4 (p. 3004) 
7.4.6.13 Answer 3 


D. false 
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7.4.6.13.1 Explanation 3 


Read question 2 

In case you skipped it, you need to read the explanation for the answer to Question 2 (p. 3001) before 
reading this explanation. 

Objects appear to be equal 

These two objects are of the same type and contain the same values. Why are they reported as not being 
equal? 

Did not override the equals method 

When I defined the class named Dummy used in the programs for Question 2 (p. 3001) and Question 
3 (p. 3003) , I did not override the method named equals 

Therefore, my class named Dummy simply inherited the default version of the method named equals 
that is defined in the class named Object 

Default behavior of equals method 

The default version of the equals method behaves essentially the same as the == operator. 

That is to say, the inherited default version of the equals method will return true if the two objects 
being compared are actually the same object, and will return false otherwise. 

As a result, this program displays false. 

Overridden equals is required for valid testing 

If you want to be able to determine if two objects instantiated from a class that you define are "equal", 
you must override the inherited equals method for your new class. You cannot depend on the inherited 
version of the equals method to do that job for you. 

Overriding may not be easy 

That is not to say that overriding the equals method is easy. In fact, it may be quite difficult in those 
cases where the class declares instance variables that refer to other objects. In this case, it may be necessary 
to test an entire tree of objects for equality. 

Back to Question 3 (p. 3003) 


7.4.6.14 Answer 2 
D. false 


7.4.6.14.1 Explanation 2 


Use of the == operator with references to objects 

This program illustrates an extremely important point about the use of the == operator with objects 

and reference variables containing references to objects. 
You cannot determine... 

You cannot determine if two objects are "equal" by applying the == operator to the reference variables 
containing references to those objects. 

Rather, that test simply determines if two reference variables refer to the same object. 

Two references to the same object 

Obviously, if there is only one object, referred to by two different reference variables, then it is "equal" 
to itself. 

Objects of same type containing same instance values 

On the other hand, two objects of the same type could contain exactly the same data values, but this 
test would not indicate that they are "equal." (In fact, that is the case in this program.) 

So, how do you test two objects for equal? 

In order to determine if two objects are "equal", you must devise a way to compare the types of the two 
objects and actually compare the contents of one object to the contents of the other object. Fortunately, 
there is a standard framework for doing this. 

The equals method 
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In particular, the class named Object defines a default version of a method named equals that. is 
inherited by all other classes. 

Class author can override the equals method 

The intent is that the author of a new class can override the equals method so that it can be called to 
determine if two objects instantiated from that class are "equal." 

What does "equal" mean for objects? 

Actually, that is up to the author of the class to decide. 

After having made that decision, the author of the class writes that behavior into her overridden version 
of the method named equals 

Back to Question 2 (p. 3001) 


7.4.6.15 Answer 1 


The answer is True. 


7.4.6.15.1 Explanation 1 


Not much to explain here 

There isn’t much in the way of an explanation to provide for this program. 

Evaluate seven relational expressions 

Each of the seven relational expressions in the argument list for the printIn method is evaluated and 
returns either true or false as a boolean value. 

Concatenate the individual results, separated by a space 

The seven boolean results are concatenated, separated by space characters, and displayed on the 
computer screen. 

Brief description of the relational operators 

Just in case your aren’t familiar with the relational operators, here is a brief description. 

Each of these operators returns the boolean value true if the specified condition is met. Otherwise, it 
returns false. 


== Left operand equals the right operand 


!= Left operand is not equal to the right operand 


< Left operand is less than the right operand 


<= Left operand is less than or equal to the right operand 


> Left operand is greater than the right operand 


>= Left operand is greater than or equal to the right operand 


Table 7.70 


Back to Question 1 (p. 3001) 
-end- 
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7.5 Ap0040: Self-assessment, Logical Operations, Numeric Casting, 
String Concatenation, and the toString Method’ 


7.5.1 Table of Contents 


e Preface (p. 3026) 
e Questions (p. 3026) 


1 (p. 3026) , 2 (p. 3027) , 3 (p. 3028) , 4 (p. 3029) , 5 (p. 3030) , 6 (p. 3031) , 7 (p. 3032) , 8 
(p. 3033) , 9 (p. 3034) , 10 (p. 3035) 


e Listings (p. 3036) 
e Miscellaneous (p. 3036) 
e Answers (p. 3037) 


7.5.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

The test consists of a series of questions with answers and explanations of the answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 3036) to easily find and view the listings while you are reading about them. 


7.5.3 Questions 
7.5.3.1 Question 1 
What output is produced by the program shown in Listing 1 (p. 3027) ? 


A. Compiler Error 
B. Runtime Error 

C. A 

D. B 

E. None of the above 


This content is available online at <http://cnx.org/content /m45260/1.6/>. 
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Listing 1 . Listing for Question 1. 


public class Ap039{ 
public static void main( 
String args[]){ 
new Worker () .doLogical () ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doLogical(){ 
int x = 5, y = 6; 
if((x > y) Il (y < x/0)){ 
System.out.println("A"); 
}else{ 
System.out.println("B"); 
}//end else 
}//end doLogical() 
}//end class definition 


Table 7.71 


Answer and Explanation (p. 3045) 


7.5.3.2 Question 2 
What output is produced by the program shown in Listing 2 (p. 3028) ? 


A. Compiler Error 
B. Runtime Error 
C. A 

D. B 

E. None of the above 
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Listing 2 . Listing for Question 2. 


public class Ap040f{ 
public static void main( 
String args[]){ 
new Worker () .doLogical () ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doLogical(){ 
int x = 5, y = 6; 
if(@ < y) Il (y < x/0)){ 
System.out.println("A"); 
}else{ 
System.out.println("B"); 
}//end else 
}//end doLogical() 
}//end class definition 


Table 7.72 


Answer and Explanation (p. 3044) 


7.5.3.3 Question 3 
What output is produced by the program shown in Listing 3 (p. 3029) ? 


A. Compiler Error 
B. Runtime Error 
C. A 

D. B 

E. None of the above 
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Listing 3 . Listing for Question 3. 


public class Ap041{ 
public static void main( 
String args[]){ 
new Worker () .doLogical () ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doLogical(){ 
int x = 5, y = 6; 
if(! (x < y) && !(y < x/0)){ 
System.out.println("A"); 
}else{ 
System.out.println("B"); 
}//end else 
}//end doLogical() 
}//end class definition 


Table 7.73 


Answer and Explanation (p. 3042) 


7.5.3.4 Question 4 
What output is produced by the program shown in Listing 4 (p. 3029) ? 


A. Compiler Error 
B. Runtime Error 

C. true 

D. 1 

E. None of the above 
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Listing 4 . Listing for Question 4. 


public class Ap042{ 
public static void main( 
String args[]){ 
new Worker () .doCast () ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doCast()f{ 
boolean x = true; 
int y = (int)x; 
System.out.println(y) ; 
}//end doCast () 
}//end class definition 


Table 7.74 


Answer and Explanation (p. 3041) 


7.5.3.5 Question 5 
What output is produced by the program shown in Listing 5 (p. 3031) ? 


A. Compiler Error 
B. Runtime Error 

C. 4-4 

D. 3-3 

E. None of the above 
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Listing 5 . Listing for Question 5. 


public class Ap043{ 
public static void main( 
String args[]){ 
new Worker () .doCast () ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doCast()f{ 
double w = 3.7; 
double x = -3.7; 
int y = (int)w; 
int z = (int)x; 
System.out.println(y + " " + z); 
}//end doCast () 
}//end class definition 


Table 7.75 


Answer and Explanation (p. 3041) 


7.5.3.6 Question 6 


What output is produced by the program shown in Listing 6 (p. 3032) ? 


A. Compiler Error 
B. Runtime Error 

C. 4-3 

D. 3 -4 

E. None of the above 
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Listing 6 . Listing for Question 6. 


public class Ap044{ 
public static void main( 
String args[]){ 
new Worker () .doCast () ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doCast()f{ 
double w = 3.5; 
double x -3.499999999999; 


System.out.println(doIt(w) + 
un + 
doIt(x)); 

}//end doCast () 


private int doIt(double arg){ 
if (arg > 0){ 
return (int)(arg + 0.5); 
}else{ 
return (int) (arg - 0.5); 
}//end else 
}//end doIt() 
}//end class definition 


Table 7.76 


Answer and Explanation (p. 3041) 


7.5.3.7 Question 7 
What output is produced by the program shown in Listing 7 (p. 3032) ? 


A. Compiler Error 
B. Runtime Error 

C. 3.5/9/true 

D. None of the above 


Listing 7 . Listing for Question 7. 


continued on next page 
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public class Ap045{ 
public static void main( 
String args[]){ 
new Worker () .doConcat (); 
}//end main() 
}//end class definition 


class Worker{ 
public void doConcat(){ 
double w = 3.5; 
int x = 9; 
boolean y = true; 
String z= W+ "y" + x+ "y" + y; 
System. out .println(z); 
}//end doConcat () 
}// end class 


Table 7.77 


Answer and Explanation (p. 3039) 


7.5.3.8 Question 8 
Which of the following best approximates the output from the program shown in Listing 8 (p. 3034) ? 


A. Compiler Error 
B. Runtime Error 
C. Dummy @273d3c 
D. Joe 35 162.5 
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Listing 8 . Listing for Question 8. 


public class Ap046{ 
public static void main( 
String args[]){ 
new Worker () .doConcat (); 
}//end main() 
}//end class definition 


class Worker{ 
public void doConcat(){ 
Dummy y = new Dummy(); 
System.out.println(y) ; 
}//end doConcat() 
}// end class 


class Dummy{ 
private String name = "Joe"; 
private int age = 35; 
private double weight = 162.5; 
}//end class dummy 


Table 7.78 


Answer and Explanation (p. 3038) 


7.5.3.9 Question 9 


Which of the following best approximates the output from the program shown in Listing 9 (p. 3035) ? 


A. Compiler Error 

B. Runtime Error 

C. C. Dummy @273d3c 

D. Joe Age = 35 Weight = 162.5 
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Listing 9 . Listing for Question 9. 


public class Ap047{ 
public static void main( 
String args[]){ 
new Worker () .doConcat (); 
}//end main() 
}//end class definition 


class Worker{ 
public void doConcat(){ 
Dummy y = new Dummy(); 
System.out.println(y) ; 
}//end doConcat() 
}// end class 


class Dummy{ 
private String name = "Joe"; 
private int age = 35; 
private double weight = 162.5; 


public String toString(){ 


String x = name +" " + 
" Age = " + age + LLES L + 
" Weight = " + weight; 
return x; 


} 
}//end class dummy 


Table 7.79 


Answer and Explanation (p. 3038) 


7.5.3.10 Question 10 


Which of the following best approximates the output from the program shown in Listing 10 (p. 3036) ? 
(Note the use of the constructor for the Date class that takes no parameters.) 


A. Compiler Error 

B. Runtime Error 

C. Sun Dec 02 17:35:00 CST 2012 1354491300781 
D. Thur Jan 01 00:00:00 GMT 1970 

0 

None of the above 
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Listing 10 . Listing for Question 10. 


import java.util.*; 
public class Ap048{ 
public static void main( 
String args[]){ 
new Worker () .doConcat (); 
}//end main() 
}//end class definition 


class Worker{ 
public void doConcat(){ 
Date w = new Date(); 
String y = w.toString(); 
System. out.print (y); 
System. out.println(" " + w.getTime()); 
}//end doConcat () 
}// end class 


Table 7.80 


Answer and Explanation (p. 3037) 


7.5.4 Listings 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


Listing 1 (p. 3027 
Listing 2 (p. 3028 
Listing 3 (p. 3029 


( ) . Listing for Question 1. 

( ) . Listing for Question 2. 

( ) . Listing for Question 3. 
Listing 4 (p. 3030) . Listing for Question 4. 
Listing 5 (p. 3031) . Listing for Question 5. 
Listing 6 (p. 3032) . Listing for Question 6. 
Listing 7 (p. 3032) . Listing for Question 7. 
Listing 8 (p. 3034) . Listing for Question 8. 
Listing 9 (p. 3035) . Listing for Question 9. 
Listing 10 (p. 3036) . Listing for Question 10. 


7.5.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Ap0040: Self-assessment, Logical Operations, Numeric Casting, String Con- 


catenation, and the toString Method 
e File: Ap0040.htm 
e Originally published: 2002 
e Published at cnx.org: 12/02/12 
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e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.5.6 Answers 
7.5.6.1 Answer 10 
C. Sun Dec 02 17:35:00 CST 2012 1354491300781 


7.5.6.1.1 Explanation 10 


The noarg constructor for the Date class 
The Date class has a constructor that takes no parameters and is described in the documentation as 
follows: 
"Allocates a Date object and initializes it so that it represents the time at which it was allocated, 
measured to the nearest millisecond." 
In other words, this constructor can be used to instantiate a Date object that represents the current 
date and time according to the system clock. 
A property named time of type long 
The actual date and time information encapsulated in a Date object is apparently stored in a property 
named time asa long integer. 
Milliseconds since the epoch 
The long integer encapsulated ina Date object represents the total number of milliseconds for the 
encapsulated date and time, relative to the epoch, which was Jan 01 00:00:00 GMT 1970. 
Earlier dates are represented as negative values. Later dates are represented as positive values. 
An overridden toString method 
An object of the Date class has an overridden toString method that converts the value in milliseconds 
to a form that is more useful for a human observer, such as: 
Sun Dec 02 17:35:00 CST 2012 
Instantiate a Date object with the noarg constructor 
This program instantiates an object of the Date class using the constructor that takes no parameters. 
Call the overridden toString method 
Then it calls the overridden toString method to populate a String object that represents the Date 
object. 
Following this, it displays that String object by calling the print method, producing the first part of 
the output shown above. (The actual date and time will vary depending on when the program is executed.) 
Get the time property value 
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Then it calls the getTime method to get and display the value of the time property. 

This is a representation of the same date and time shown above (p. 3037) , but in milliseconds: 
1354491300781 

Back to Question 10 (p. 3035) 


7.5.6.2 Answer 9 
D. Joe Age = 35 Weight = 162.5 


7.5.6.2.1 Explanation 9 


Upgraded program from Question 8 
The program used for this question is an upgrade to the program that was used for Question 8 (p. 3033) 


Dummy class overrides the toString method 

In particular, in this program, the class named Dummy overrides the toString method in such a 
way as to return a String representing the object that would be useful to a human observer. 

The String that is returned contains the values of the instance variables of the object: name, age, and 
weight. 

Overridden toString method code 

The overridden toString method for the Dummy class is shown below for easy reference. 


Overridden toString method 


public String toString(){ 


String x = name +" " + 
Ww Age = " + age + un + 
" Weight = " + weight; 
return x; 


}//end toString() 


Table 7.81 


The code in the overridden toString method is almost trivial. 

The important thing is not the specific code in a specific overridden version of the toString method. 

Why override the toString method? 

Rather, the important thing is to understand why you should probably override the toString method 
in most of the new classes that you define. 

In fact, you should override the toString method in all new classes that you define if a String 
representation of an instance of that class will ever be needed for any purpose. 

The code will vary 

The code required to override the toString method will vary from one class to another. The important 
point is that the code must return a reference toa String object. The String object should encapsulate 
information that represents the original object in a format that is meaningful to a human observer. 

Back to Question 9 (p. 3034) 


7.5.6.3 Answer 8 
C. Dummy@273d3c 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3033 


7.5.6.3.1 Explanation 8 


Display an object of the Dummy class 

This program instantiates a new object of the Dummy class, and passes that object’s reference to 
the method named _ println 

The purpose of the println method is to display a representation of the new object that is meaningful 
to a human observer. In order to do so, it requires a String representation of the object. 

The toString method 

The class named Object defines a default version of a method named toString 

All classes inherit the toString method. 

A child of the Object class 

Those classes that extend directly from the class named Object inherit the default version of the 
toString method. 

Grandchildren of the Object class 

Those classes that don’t directly extend the class named Object also inherit a version of the toString 
method. 

May be default or overridden version 

The inherited toString method may be the default version, or it may be an overridden version, 
depending on whether the method has been overridden in a superclass of the new class. 

The purpose of the toString method 

The purpose of the toString method defined in the Object class is to be overridden in new classes. 

The body of the overridden version should return a reference to a String object that represents an 
object of the new class. 

Whenever a String representation of an object is required 

Whenever a String representation of an object is required for any purpose in Java, the toString 
method is called on a reference to the object. 

The String that is returned by the toString method is taken to be a String that represents the 
object. 

When toString has not been overridden 

When the toString method is called on a reference to an object for which the method has not been 
overridden, the default version of the method is called. 

The default String representation of an object 

The String returned by the default version consists of the following: 


e The name of the class from which the object was instantiated 
e The @ character 
e A hexadecimal value that is the hashcode value for the object 


As you can see, this does not include any information about the values of the data stored in the object. 

Other than the name of the class from which the object was instantiated, this is not particularly useful 
to a human observer. 

Dummy class does not override toString method 

In this program, the class named Dummy extends the Object class directly, and doesn’t override 
the toString method. 

Therefore, when the toString method is called on a reference to an object of the Dummy lass, the 
String that is returned looks something like the following: 

Dummy @273d3c 

Note that the six hexadecimal digits at the end will probably be different from one program to the next. 

Back to Question 8 (p. 3033) 


7.5.6.4 Answer 7 
C. 3.5/9/true 
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7.5.6.4.1 Explanation 7 


More on String concatenation 

This program illustrates String concatenation. 

The plus (+) operator is what is commonly called an overloaded operator 

What is an overloaded operator? 

An overloaded operator is an operator whose behavior depends on the types of its operands. 

Plus (+) as a unary operator 

The plus operator can be used as either a unary operator or a binary operator. However, as a 
unary operator, with only one operand to its right, it doesn’t do anything useful. This is illustrated by the 
following two statements, which are functionally equivalent. 

x= y; 

x = +y; 

Plus (+) as a binary operator 

As a binary operator, the plus operator requires two operands, one on either side. (This is called infix 
notation.) When used as a binary operator, its behavior depends on the types of its operands. 

Two numeric operands 

If both operands are numeric operands, the plus operator performs arithmetic addition. 

If the two numeric operands are of different types, the narrower operand is converted to the type of the 
wider operand, and the addition is performed as the wider type. 

Two String operands 

If both operands are references to objects of type String , the plus operator creates and returns a new 
String object that contains the concatenated values of the two operands. 

One String operand and one of another type 

If one operand is a reference to an object of type String and the other operand is of some type other 
than String , the plus operator causes a new String object to come into existence. 

This new String object isa String representation of the non-String operand (such as a value of 
type int ) , 

Then it concatenates the two String objects, producing another new String object, which is the 
concatenation of the two. 

How is the new String operand representing the non-string operand created? 

The manner in which it creates the new String object that represents the non-String operand varies 
with the actual type of the operand. 

A primitive operand 

The simplest case is when the non-String operand is one of the primitive types. In these cases, the 
capability already exists in the core programming language to producea String object that represents the 
value of the primitive type. 

A boolean operand 

For example, if the operand is of type boolean , the new String object that represents the operand 
will either contain the word true or the word false. 

A numeric operand 

If the operand is one of the numeric types, the new String object will be composed of some of the 
following: 


numeric characters 

a decimal point character 
minus characters 

plus character 

other characters such as E or e 


These characters will be arranged in such a way as to represent the numeric value of the operand to a human 
observer. 
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In this program ... 

In this program, a numeric double value, a numeric int value, anda boolean value were concatenated 
with a pair of slash characters to produce a String object containing the following: 

3.5/9/true 

When a reference to this String object was passed as a parameter to the printIn method, the code 
in that method extracted the character string from the String object, and displayed that character string 
on the screen. 

The toString method 

If one of the operands to the plus operator is a reference to an object, the toString method is called 
on the reference to produce a string that represents the object. The toString method may be overridden 
by the author of the class from which the object was instantiated to produce a String that faithfully 
represents the object. 

Back to Question 7 (p. 3032) 


7.5.6.5 Answer 6 
C. 4-3 


7.5.6.5.1 Explanation 6 


A rounding algorithm 

The method named dolIt in this program illustrates an algorithm that can be used with a numeric cast 
operator (int) to cause double values to be rounded to the nearest integer. 

Different than truncation toward zero 

Note that this is different from simply truncating to the next integer closer to zero (as was illustrated 
in Question 5 (p. 3030) ) . 

Back to Question 6 (p. 3031) 


7.5.6.6 Answer 5 
D. 3-3 


7.5.6.6.1 Explanation 5 


Truncates toward zero 

When a double value is cast to an int , the fractional part of the double value is discarded. 

This produces a result that is the next integer value closer to zero. 

This is true regardless of whether the double is positive or negative. This is sometimes referred to as 
its "truncation toward zero" behavior. 

Not the same as rounding 

If each of the values assigned to the variables named w and x in this program were rounded to the 
nearest integer, the result would be 4 and -4, not 3 and -3 as produced by the program. 

Back to Question 5 (p. 3030) 


7.5.6.7 Answer 4 


A. Compiler Error 


7.5.6.7.1 Explanation 4 


Cannot cast a boolean type 
A boolean type cannot be cast to any other type. This program produces the following compiler error: 
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Ap042.java:13: inconvertible types 
found : boolean 
required: int 

int y = (int)x; 


Table 7.82 
Back to Question 4 (p. 3029) 


7.5.6.8 Answer 3 
D.B 


7.5.6.8.1 Explanation 3 


The logical and operator 
The logical and operator shown below 


The logical and operator 


&& 


Table 7.83 


performs an and operation between its two operands, both of which must be of type boolean . If 
both operands are true, the operator returns true. Otherwise, it returns false. 

The boolean negation operator 

The boolean negation operator shown below 


The boolean negation operator ! 


Table 7.84 


is a unary operator, meaning that it always has only one operand. That operand must be of type 
boolean , and the operand always appears immediately to the right of the operator. 

The behavior of this operator is to change its right operand from true to false, or from false to true. 

Evaluation from left to right 

Now, consider the following code fragment from this program. 
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int x = 5, y = 6; 
if(! (x < y) && !(y < x/0))f 
System.out.printin("A") ; 
}else{ 
System.out.println("B"); 
}//end else 


Table 7.85 


The individual operands of the logical and operator are evaluated from left to right. 
Consider the left operand of the logical and operator that reads: 


! (x<y) 
Table 7.86 
The following expression is true 
(x < y) 
Table 7.87 


In this case, x is less than y , so the expression inside the parentheses evaluates to true. 
The following expression is false 


I(x < y) 


Table 7.88 


The true result becomes the right operand for the boolean negation operator at this point. 

You might think of the state of the evaluation process at this point as being something like 

not true 

When the ! operator is applied to the true result, the combination of the two become a false result. 

Short-circuit evaluation applies 

This, in turn, causes the left operand of the logical and operator to be false 

At that point, the final outcome of the logical expression has been determined. It doesn’t matter whether 
the right operand is true or false. The final result will be false regardless. 

No attempt is made to evaluate the right operand 

Therefore, no attempt is made to evaluate the right operand of the logical and operator in this case. 

No attempt is made to divide the integer variable x by zero, no exception is thrown, and the program 
doesn’t terminate abnormally. It runs to completion and displays a B on the screen. 

Back to Question 3 (p. 3028) 
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7.5.6.9 Answer 2 
C.A 


7.5.6.9.1 Explanation 2 


Short-circuit evaluation 

Question 1 (p. 3026) was intended to set the stage for this question. 

This Question, in combination with Question 1 (p. 3026) , is intended to help you understand and 
remember the concept of short-circuit evaluation. 

What is short-circuit evaluation? 

Logical expressions are evaluated from left to right. That is, the left operand of a logical operator is 
evaluated before the right operand of the same operator is evaluated. 

When evaluating a logical expression, the final outcome can often be determined without the requirement 
to evaluate all of the operands. 

Once the final outcome is determined, no attempt is made to evaluate the remainder of the expression. 
This is short-circuit evaluation. 

Code from Question 1 

Consider the following code fragment from Question 1 (p. 3026) : 


int x = 5, y = 6; 
if((x > y) Il (y < x/0)){ 


Table 7.89 


The (||) operator is the logical or operator. 

Boolean operands required 

This operator requires that its left and right operands both be of type boolean . This operator performs 
an inclusive or on its left and right operands. The rules for an inclusive or are: 

If either of its operands is true, the operator returns true. Otherwise, it returns false. 

Left operand is false 

In this particular expression, the value of x is not greater than the value of y . Therefore, the left 
operand of the logical or operator is not true. 

Right operand must be evaluated 

This means that the right operand must be evaluated in order to determine the final outcome. 

Right operand attempts to divide by zero 

However, when an attempt is made to evaluate the right operand, an attempt is made to divide x by 
zero. This throws an exception, which is not caught and handled by the program, so the program terminates 
as described in Question 1 (p. 3026) . 

Similar code from Question 2 

Now consider the following code fragment from Question 2 (p. 3027) . 


int x = 5, y = 6; 
if((x < y) Il (y < x/0)){ 
System.out.println("A"); 
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Table 7.90 


Note that the right operand of the logical or operator still contains an expression that attempts to 
divide the integer x by zero. 

No runtime error in this case 

This program does not terminate with a runtime error. Why not? 

And the answer is ... 

In this case, x is less than y . Therefore, the left operand of the logical or operator is true. 

Remember the rule for inclusive or 

It doesn’t matter whether the right operand is true or false. The final outcome is determined as soon as 
it is determined that the left operand is true. 

The bottom line 

Because the final outcome has been determined as soon as it is determined that the left operand is true, 
no attempt is made to evaluate the right operand. 

Therefore, no attempt is made to divide x by zero, and no runtime error occurs. 

Short-circuit evaluation 

This behavior is often referred to as short-circuit evaluation . 

Only as much of a logical expression is evaluated as is required to determine the final outcome. 

Once the final outcome is determined, no attempt is made to evaluate the remainder of the logical 
expression. 

This is not only true for the logical or operator, it is also true for the logical and operator, which 
consists of two ampersand characters with no space between them. 

Back to Question 2 (p. 3027) 


7.5.6.10 Answer 1 


B. Runtime Error 


7.5.6.10.1 Explanation 1 


Divide by zero 

Whenever a Java program attempts to evaluate an expression requiring that a value of one of the integer 
types be divided by zero, it will throw an ArithmeticException . If this exception is not caught and 
handled by the program, it will cause the program to terminate. 

Attempts to divide x by 0 

This program attempts to evaluate the following expression: 


(y < x/0) 


Table 7.91 


This expression attempts to divide the variable named x by zero. This causes the program to terminate 
with the following error message when running under JDK 1.3: 
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java.lang.ArithmeticException: / by zero 
at Worker .doLogical (Ap039. java: 13) 
at Ap039.main(Ap039.java:6) 


Table 7.92 


Back to Question 1 (p. 3026) 
-end- 


7.6 Ap0050: Self-assessment, Escape Character Sequences and 
Arrays” 


7.6.1 Table of Contents 


e Preface (p. 3046) 
e Questions (p. 3046) 


1 (p. 3046) , 2 (p. 3047) , 3 (p. 3048) , 4 (p. 3049) , 5 (p. 3050) , 6 (p. 3052) , 7 (p. 3052) , 8 
(p. 3053) , 9 (p. 3054) , 10 (p. 3055) , 11 (p. 3056) , 12 (p. 3057) , 13 (p. 3058) , 14 (p. 3059) , 
15 (p. 3060) 


e Listings (p. 3061) 
e Miscellaneous (p. 3062) 
e Answers (p. 3062) 


7.6.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

The test consists of a series of questions with answers and explanations of the answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 3061) to easily find and view the listings while you are reading about them. 


7.6.3 Questions 
7.6.3.1 Question 1 


What output is produced by the program shown in Listing 1 (p. 3047) ? 


A. Compiler Error 
B. Runtime Error 
Cc. \"Backslash\"->\\\nUnderstand 
D. "Backslash"->\ 
Understand 


10This content is available online at <http://cnx.org/content /m45280/1.8/>. 
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Listing 1 . Listing for Question 1. 


public class Ap049{ 
public static void main( 
String args[]){ 
new Worker () .doEscape(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doEscape(){ 
System. out .print1n( 
"\"Backslash\"->\\\nUnderstand") ; 
}//end doEscape() 
}// end class 


Table 7.93 


Answer and Explanation (p. 3074) 


7.6.3.2 Question 2 
What output is produced by the program shown in Listing 2 (p. 3048) ? 


e A. Compiler Error 

B. Runtime Error 

C. St@273d3c St@256a7c St@720eeb 
D. Tom Dick Harry 

E. None of the above 
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Listing 2 . Listing for Question 2. 


public class Ap050{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
St[] myArray = {new St("'Tom"), 
new St("Dick"), 
new St ("Harry")}; 
for(int cnt = 0; 
cnt < myArray.length;cnt++){ 
System. out. print ( 
myArray[cnt] + " "); 


}//end for loop 
System.out.printin("") ; 
}//end doArrays() 

}// end class 


class St{ 
private String name; 


public St(String name) { 
this.name = name; 
}//end constructor 


public String toString(){ 
return name; 
}//end toString() 
}//end class 


Table 7.94 


Answer and Explanation (p. 3072) 


7.6.3.3 Question 3 


What output is produced by the program shown in Listing 3 (p. 3049) ? 


A. Compiler Error 


B. Runtime Error 
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D. None of the above 


Listing 3 . Listing for Question 3. 


public class Ap051{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
3//end class definition 


class Worker{ 
public void doArrays(){ 
int myArray [3] [5]; 


for(int i=0;i<myArray.length;it++){ 
for(int j=0; 
j<myArray [0] . length; j++) { 
myArray[i] [j] = i*j; 
}//end inner for loop 
}//end outer for loop 


for(int i=0;i<myArray.length;i++){ 
for(int j=0; 
j<myArray [0] . length; j++){ 
System. out.print ( 
myArray[i] [j] + " "); 
}//end inner for loop 
System.out.printin(""); 
}//end outer for loop 


}//end doArrays() 
}// end class 


Table 7.95 


Answer and Explanation (p. 3070) 


7.6.3.4 Question 4 


What output is produced by the program shown in Listing 4 (p. 3050) ? 


A. Compiler Error 
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B. Runtime Error 


D. None of the above 


Listing 4 . Listing for Question 4. 


public class Ap052{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
int myArray [0] []; 
myArray = new int [3] [5]; 


for(int i=0;i<myArray.length;i++){ 
for(int j=0; 
j<myArray [0] . length; j++) { 
myArray[i] [j] = i*j + 1; 
}//end inner for loop 
}//end outer for loop 


for(int i=0;i<myArray.length;i++){ 
for(int j=0; 
j<myArray [0] . length; j++) { 
System. out.print ( 
myArray[i] [j] + " "); 
}//end inner for loop 
System.out.printin("") ; 
}//end outer for loop 


}//end doArrays() 
}// end class 


Table 7.96 


Answer and Explanation (p. 3069) 


7.6.3.5 Question 5 


What output is produced by program shown in Listing 5 (p. 3051) ? 
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A. Compiler Error 


B. Runtime Error 


C. -1 -1 -1 -1 -1 
-1 -2 -3 -4 -5 
-1 -3 -5 -7 -9 


D. None of the above 


Listing 5 . Listing for Question 5. 


public class Ap053{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
int myArray 0 []; 
myArray = new int [3] [5]; 


for(int i = 0;i < 3;i++){ 
for(int j = 0;j < 5;j++){ 
myArray[i] [j] = (i*j+1)*(-1); 
}//end inner for loop 
}//end outer for loop 


for(int i = 0;i < 3;i++){ 
for(int j = 0;j < 6;j++){ 
System. out.print ( 
myArray[i] [j] + " "); 
}//end inner for loop 
System.out.println(""); 
}//end outer for loop 


}//end doArrays() 
}// end class 


Table 7.97 


Answer and Explanation (p. 3068) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3046 CHAPTER 7. OOP SELF-ASSESSMENT 


7.6.3.6 Question 6 


What output is produced by program shown in Listing 6 (p. 3052) ? 


A. Compiler Error 
B. Runtime Error 

C. 3 

D. None of the above 


Listing 6 . Listing for Question 6. 


public class Ap054{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void dodrrays(){ 
int] A = new int[2]; 
ALO] = 1; 
A[1] = 2; 
System.out.printin(A[0] + A[1]); 


}//end doArrays() 
}// end class 


Table 7.98 


Answer and Explanation (p. 3068) 


7.6.3.7 Question 7 
What output is produced by program shown in Listing 7 (p. 3053) ? 


A. Compiler Error 
B. Runtime Error 

C. OK 

D. None of the above 


Listing 7 . Listing for Question 7. 


continued on next page 
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import java.awt.Label; 
public class ApO55{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void dodrrays(){ 
Label[] A = new Label[2]; 
A(O] = new Label("0"); 
ALi] new Label("K"); 
System.out.printin(A[0] + A[1]); 
}//end doArrays() 
}// end class 


Table 7.99 


Answer and Explanation (p. 3066) 


7.6.3.8 Question 8 
What output is produced by program shown in Listing 8 (p. 3054) ? 


A. Compiler Error 
B. Runtime Error 

C. OK 

D. None of the above 


Listing 8 . Listing for Question 8. 


import java.awt.Label; 
public class ApO56{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
Label[] A = new Label[2]; 
ACO] = new Label("0"); 
A[1] new Label ("K"); 
System.out.println(A[0].getText() + A[1].getText()); 
}//end doArrays() 
}// end class 
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Table 7.100 


Answer and Explanation (p. 3065) 


7.6.3.9 Question 9 
What output is produced by program shown in Listing 9 (p. 3055) ? 


A. Compiler Error 
B. Runtime Error 
C.1 

D. None of the above 


Listing 9 . Listing for Question 9. 


public class Ap057{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
Integer[] A = new Integer[2]; 
ALO] = new Integer(1); 
System. out.print1n( 
A[1].intValue(Q)); 
}//end doArrays() 
}// end class 


Table 7.101 


Answer and Explanation (p. 3065) 


7.6.3.10 Question 10 


What output is produced by program shown in Listing 10 (p. 3056) ? 


A. Compiler Error 


B. Runtime Error 


oon 


D. None of the above 
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Listing 10 . Listing for Question 10. 


public class Ap058{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
int AQ O = new int(310; 
ALO] = new int[1]; 
A[1] = new int[2]; 
A[2] = new int[3]; 


for(int i = 0;i < A.length;i++){ 
for(int j=0;j < Ali] .length;j++){ 
ATi] [j] = i+j; 
}//end inner for loop 
}//end outer for loop 


for(int i=0;i<A.length;it++){ 
for(int j=0;j < ALi].length;j++){ 
System. out. print ( 
ALi] [j] şt wys 
}//end inner for loop 
System.out.printin("") ; 
}//end outer for loop 


}//end doArrays() 
}// end class 


Table 7.102 


Answer and Explanation (p. 3064) 


7.6.3.11 Question 11 


What output is produced by the program shown in Listing 11 (p. 3057) ? 


A. Compiler Error 
B. Runtime Error 

C. Zero One Two 

D. None of the above 
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Listing 11 . Listing for Question 11. 


public class Ap059{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 

Object[] A = new Object[3]; 
//Note that there is a simpler and 
// better way to do the following 
// but it won’t illustrate my point 
// as well as doing it this way. 
ALO] = new String("Zero") ; 
A[1] = new String("One") ; 


A[2] = new String("Two") ; 

System.out.printin(A[O] +" " + 
AC1] +n yg 
A[2]); 


}//end doArrays() 
}// end class 


Table 7.103 


Answer and Explanation (p. 3064) 


7.6.3.12 Question 12 


What output is produced by program shown in Listing 12 (p. 3058) ? 


A. Compiler Error 

B. Runtime Error 

C. Zero 1 2.0 

D. None of the above. 
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Listing 12 . Listing for Question 12. 


public class Ap060{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 

Object[] A = new Object[3]; 
//Note that there is a simpler and 
// better way to do the following 
// but it won’t illustrate my point 
// as well as doing it this way. 
ALO] = new String("Zero") ; 


A[1] = new Integer(1); 

A[2] = new Double(2.0); 

System.out.printin(A[O] +" "+ 
ADJ +" "+ 
A[2]); 


}//end doArrays() 
}// end class 


Table 7.104 


Answer and Explanation (p. 3063) 


7.6.3.13 Question 13 


What output is produced by program shown in Listing 13 (p. 3059) ? 


A. Compiler Error 

B. Runtime Error 

C. Zero 1 2.0 

D. None of the above. 
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Listing 13 . Listing for Question 13. 


public class Ap061{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 

Object[] A = new Object[3]; 
//Note that there is a simpler and 
// better way to do the following 
// but it won’t illustrate my point 
// as well as doing it this way. 
ALO] = new String("Zero") ; 


A[1] = new Integer(1); 

A[2] = new MyClass(2.0); 

System.out.printin(A[O] +" "+ 
Ata] +" "+ 
A[2]); 


}//end doArrays() 
}// end class 


class MyClass{ 
private double data; 


public MyClass(double data) { 
this.data = data; 
}//end constructor 
}// end MyClass 


Table 7.105 


Answer and Explanation (p. 3063) 


7.6.3.14 Question 14 


What output is produced by program shown in Listing 14 (p. 3060) ? 


A. Compiler Error 

B. Runtime Error 

C. 1.0 2.0 

D. None of the above. 
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Listing 14 . Listing for Question 14. 


public class Ap062f{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
Object[] A = new Object[2]; 
ALO] = new MyClass(1.0); 
A[1] = new MyClass(2.0); 


System. out .print1n( 
A[O] .getData() +" "+ 
A[1] .getData()); 
}//end doArrays() 
}// end class 


class MyClass{ 
private double data; 


public MyClass(double data) { 
this.data = data; 
}//end constructor 


public double getData(){ 
return data; 
}//end getData() 
}// end MyClass 


Table 7.106 


Answer and Explanation (p. 3063) 


7.6.3.15 Question 15 


What output is produced by program shown in Listing 15 (p. 3061) ? 


A. Compiler Error 

B. Runtime Error 

C. 1.0 2.0 

D. None of the above. 
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Listing 15 . Listing for Question 15. 


public class Ap063{ 
public static void main( 


new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
Object[] A = new Object[2]; 
ALO] = new MyClass(1.0); 
A[1] = new MyClass(2.0); 


System. out. print1n( 
((MyClass) A[0]).getData() + " 
+ ((MyClass)A[1]).getData()); 
}//end doArrays() 
}// end class 


class MyClass{ 
private double data; 


public MyClass(double data) { 
this.data = data; 
}//end constructor 


public double getData(){ 
return data; 
}//end getData() 
}// end MyClass 


String args[]){ 


Answer and Explanation (p. 3062) 


7.6.4 Listings 


Table 7.107 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


e Listing 1 (p. 3047) . Listing for Question 1. 
e Listing 2 (p. 3048) . Listing for Question 2. 
e Listing 3 (p. 3049) . Listing for Question 3. 
e Listing 4 (p. 3050) . Listing for Question 4. 
e Listing 5 (p. 3051) . Listing for Question 5. 
e Listing 6 (p. 3052) . Listing for Question 6. 
e Listing 7 (p. 3053) . Listing for Question 7. 
e Listing 8 (p. 3054) . Listing for Question 8. 
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e Listing 9 (p. 3055) . Listing for Question 9. 

e Listing 10 (p. 3056) . Listing for Question 10. 
e Listing 11 (p. 3057) . Listing for Question 11. 
e Listing 12 (p. 3058) . Listing for Question 12. 
e Listing 13 (p. 3059) . Listing for Question 13. 
e Listing 14 (p. 3060) . Listing for Question 14. 
e Listing 15 (p. 3061) . Listing for Question 15. 


7.6.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Ap0050: Self-assessment, Escape Character Sequences and Arrays 
e File: Ap0050.htm 

e Originally published: 2002 

e Published at cnx.org: 12/03/12 

e Revised: 08/17/15 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 

I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 

In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.6.6 Answers 
7.6.6.1 Answer 15 
C. 1.0 2.0 


7.6.6.1.1 Explanation 15 


This is an upgrade of the program from Question 14 (p. 3059) . This program applies the proper downcast 
operator to the references extracted from the array of type Object before attempting to call the method 
named getData on those references. (For more information, see the discussion of Question 14 (p. 
3059) .) 

As a result of applying a proper downcast, the program compiles and runs successfully. 

Back to Question 15 (p. 3060) 
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7.6.6.2 Answer 14 


A. Compiler Error 


7.6.6.2.1 Explanation 14 


Storing references in a generic array of type Object 

This program stores references to two objects instantiated from a new class named MyClass in the 
elements of an array object of declared type Object . That is OK. 

Calling a method on the references 

Then the program extracts the references to the two objects and attempts to call the method named 
getData on each of the references. That is not OK. 

Downcast is required 

Because the method named getData is not defined in the class named Object ,in order to call this 
method on references extracted from an array of type Object , it is necessary to downcast the references 
to the class in which the method is defined. In this case, the method is defined in the new class named 
MyClass (but it could be defined in an intermediate class in the class hierarchy if the new class extended 
some class further down the hierarchy) . 

Here is a partial listing of the compiler error produced by this program: 


Ap062.java:15: error: cannot find symbol 
ALO].getDataQ() +" "+ 
symbol: method getData() 
location: class Object 


Back to Question 14 (p. 3059) 


7.6.6.3 Answer 13 
D. None of the above. 


7.6.6.3.1 Explanation 13 


The array object of type Object in this program is capable of storing a reference to a new object instantiated 
from the new class named MyClass . However, because the new class does not override the toString 
method, when a string representation of the new object is displayed, the string representation is created 
using the version of the toString method that is inherited from the Object class. That causes this 
program to produce an output similar to the following: 

Zero 1 MyClass@273d3c 

Back to Question 13 (p. 3058) 


7.6.6.4 Answer 12 
C. Zero 1 2.0 


7.6.6.4.1 Explanation 12 


A type-generic array object 

As explained in Question 11 (p. 3056) , an array object of the type Object is a generic array that can 
be used to store references to objects instantiated from any class. 

Storing mixed reference types 
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This program instantiates objects from the classes String , Integer ,and Double , and stores those 
objects’ references in the elements of an array of type Object . Then the program accesses the references 
and uses them to display string representations of each of the objects. 

Polymorphic behavior applies 

Once again, polymorphic behavior involving overridden versions of the toString method were involved 
and it was not necessary to downcast the references to their true type to display string representations of 
the objects. 

Back to Question 12 (p. 3057) 


7.6.6.5 Answer 11 
C. Zero One Two 


7.6.6.5.1 Explanation 11 


Storing references to subclass types 

When you create an array object for a type defined by a class definition, the elements of the array can 

be used to store references to objects of that class or any subclass of that class. 
A type-generic array object 

All classes in Java are subclasses of the class named Object . This program creates an array object 
with the declared type being type Object . An array of type Object can be used to store references to 
objects instantiated from any class. 

After creating the array object, this program instantiates three objects of the class String and stores 
those object’s references in the elements of the array. (As I pointed out in the comments, there is a simpler 
and better way to instantiate String objects, but it wouldn’t illustrate my point as well as doing the 
way that I did.) 

Sometimes you need to downcast 

Although an array of type Object can be used to store references to objects of any type (including 
mixed types and references to other array objects) , you will sometimes need to downcast those references 
back to their true type once you extract them from the array and attempt to use them for some purpose. 

Polymorphic behavior applies here 

For this case, however, because the toString method is defined in the Object class and overridden 
in the String class, polymorphic behavior applies and it is not necessary to downcast the references to 
type String in order to be able to convert them to strings and display them. 

Back to Question 11 (p. 3056) 


7.6.6.6 Answer 10 


7.6.6.6.1 Explanation 10 


Defer size specification for secondary arrays 
It is not necessary to specify the sizes of the secondary arrays when you create a multi-dimensional array 
in Java. Rather, since the elements in the primary array simply contain references to other array objects 
(or null by default) , you can defer the creation of those secondary array objects until later. 
Independent array objects 
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When you do finally create the secondary arrays, they are essentially independent array objects (except 
for the requirement for type commonality among them) . 

Ragged arrays 

Each individual secondary array can be of any size, and this leads to the concept of a ragged array 

(On a two-dimensional basis, a ragged array might be thought of as a two-dimensional array where each 
row can have a different number of columns.) 

This program creates, populates, and displays the contents of such a two-dimensional ragged array. 
Although this program creates a two-dimensional array that is triangular in shape, even that is not a 
requirement. The number of elements in each of the secondary arrays need have no relationship to the 
number of elements in any of the other secondary arrays. 

Back to Question 10 (p. 3055) 


7.6.6.7 Answer 9 


B. Runtime Error 


7.6.6.7.1 Explanation 9 


NullPointerException 
The following code fragment shows that this program attempts to perform an illegal operation on the 
value accessed from the array object at index 1. 


Integer[] A = new Integer[2]; 
ALO] = new Integer(1); 
System. out .print1n( 
A[1].intValue(Q); 


You can’t call methods on null references 

The reference value that was returned by accessing AJ[1] is the default value of null. This is the value 
that was deposited in the element when the array object was created (no other value was ever stored there) 
. When an attempt was made to call the intValue method on that reference value, the following runtime 
error occurred 


java.lang.NullPointerException 
at Worker.doArrays(Ap057. java:14) 
at Ap057.main(Ap057.java:6) 


This is a common programming error, and most Java programmers have seen an error message involving a 
NullPointerException several (perhaps many) times during their programming careers. 


Back to Question 9 (p. 3054) 


7.6.6.8 Answer 8 
C. OK 
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7.6.6.8.1 Explanation 8 


Success at last 

This program finally gets it all together and works properly. In particular, after accessing the reference 
values stored in each of the elements, the program does something legal with those values. 

Call methods on the object’s references 

In this case, the code calls one of the public methods belonging to the objects referred to by the reference 
values stored in the array elements. 


System.out.println(A[0].getText() + A[1].getText()); 


The getText method that is called, returns the contents of the Label object as type String . This 
makes it possible to perform String concatenation on the values returned by the method, so the program 
compiles and executes properly. 

Back to Question 8 (p. 3053) 


7.6.6.9 Answer 7 


A. Compiler Error 


7.6.6.9.1 Explanation 7 


Java arrays may seem different to you 

For all types other than the primitive types, you may find the use of arrays in Java to be considerably 
different from what you are accustomed to in other programming languages. There are a few things that 
you should remember. 

Array elements may contain default values 

If the declared type of an array is one of the primitive types, the elements of the array contain values 
of the declared type. If you have not initialized those elements or have not assigned specific values to the 
elements, they will contain default values. 

The default values 

You need to know that: 


The default for numeric primitive types is the zero value for that type 
The default for the boolean type is false 
The default for the char type is a 16-bit unsigned integer, all of whose bits have a zero value 
(sometimes called a null character) 

e The default value for reference types is null , not to be confused with the null character above. 
(An array element that contains null doesn’t refer to an object.) 


Arrays of references 

If the declared type for the array is not one of the primitive types, the elements in the array are actually 
reference variables. Objects are never stored directly in a Java array. Only references to objects are stored 
in a Java array. 

If the array type is the name of a class ... 

If the declared type is the name of a class, references to objects of that class or any subclass of that class 
can be stored in the elements of the array. 

If the array type is the name of an interface ... 

If the declared type is the name of an interface, references to objects of any class that implements the 
interface, or references to objects of any subclass of a class that implements the interface can be stored in 
the elements of the array. 
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Why did this program fail to compile? 

Now back to the program at hand. Why did this program fail to compile? To begin with, this array 
was not designed to store any of the primitive types. Rather, this array was designed to store references to 
objects instantiated from the class named Label , as indicated in the following fragment. 


Label[] A = new Label[2]; 


Elements initialized to null 

This is a two-element array. When first created, it contains two elements, each having a default value of 
null . What this really means is that the reference values stored in each of the two elements don’t initially 
refer to any object. 

Populate the array elements 

The next fragment creates two instances (objects) of the Label class and assigns those object’s 
references to the two elements in the array object. This is perfectly valid. 


A[O] = new Label("0"); 
A[1] = new Label("K"); 


You cannot add reference values 

The problem arises in the next fragment. Rather than dealing with the object’s references in an appropri- 
ate manner, this fragment attempts to access the text values of the two reference variables and concatenate 
those values. 


System.out.printiln(A[0] + A[1]); 


The compiler produces the following error message: 


Ap0O55.java:14: error: bad operand types for binary operator ’+? 
System.out.printin(A[0] + A[1]); 
first type: Label 
second type: Label 
1 error 


This error message is simply telling us that it is not legal to add the values of reference variables. 

Not peculiar to arrays 

This problem is not peculiar to arrays. You would get a similar error if you attempted to add two 
reference variables even when they aren’t stored in an array. In this case, the code to access the values of 
the elements is good. The problem arises when we attempt to do something illegal with those values after 
we access them. 

Usually two steps are required 

Therefore, except in some special cases such as certain operations involving the wrapper classes, to use 
Java arrays with types other than the primitive types, when you access the value stored in an element of 
the array (a reference variable) you must perform only those operations on that reference variable that are 
legal for an object of that type. That usually involves two steps. The first step accesses the reference to an 
object. The second step performs some operation on the object. 

Back to Question 7 (p. 3052) 
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7.6.6.10 Answer 6 
C. 3 


7.6.6.10.1 Explanation 6 


Once you create an array object for a primitive type in Java, you can treat the elements of the array pretty 
much as you would treat the elements of an array in other programming languages. In particular, a statement 
such the following can be used to assign a value to an indexed element in an array referred to by a reference 
variable named A 


A[1] = 2; 


Similarly, when you reference an indexed element in an expression such as the following, the value stored in 
the element is used to evaluate the expression. 


System.out.printin(A[0] + A[1]); 


For all Java arrays, you must remember to create the new array object and to store the array object’s 
reference in a reference variable of the correct type. Then you can use the reference variable to gain access 
to the elements in the array. 

Back to Question 6 (p. 3052) 


7.6.6.11 Answer 5 


B. Runtime Error 


7.6.6.11.1 Explanation 5 


Good fences make good neighbors 

One of the great things about an array object in Java is that it knows how to protect its boundaries. 

Unlike some other currently popular programming languages, if your program code attempts to access a 
Java array element outside its boundaries, an exception will be thrown. If your program doesn’t catch and 
handle the exception, the program will be terminated. 

Abnormal termination 

While experiencing abnormal program termination isn’t all that great, it is better than the alternative 
of using arrays whose boundaries aren’t protected. Programming languages that don’t protect the array 
boundaries simply overwrite other data in memory whenever the array boundaries are exceeded. 

Attempt to access out of bounds element 

The code in the for loop in the following fragment attempts to access the array element at the index 
value 5. That index value is out of bounds of the array. 


for(int j = 0;j < 6;j++){ 
System.out.print( 
myArray[i] [j] +" "); 
}//end inner for loop 
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Because that index value is outside the boundaries of the array, an ArrayIndexOutOfBoundsException 
is thrown. The exception isn’t caught and handled by program code, so the program terminates abnormally 
at runtime. 

This program also illustrates that it is usually better to use the length property of an array to control 
iterative loops than to use hard-coded limit values, which may be coded erroneously. 

Back to Question 5 (p. 3050) 


7.6.6.12 Answer 4 


7.6.6.12.1 Explanation 4 


A two-dimensional array 
This program illustrates how to create, populate, and process a two-dimensional array with three rows 
and five columns. 

(As mentioned earlier, a Java programmer who understands the fine points of the language probably 
wouldn’t call this a two-dimensional array. Rather, this is a one-dimensional array containing three elements. 
Each of those elements is a reference to a one-dimensional array containing five elements. That is the more 
general way to think of Java arrays.) 

The following code fragment creates the array, using one of the acceptable formats discussed in Question 
3 (p. 3048) . 


int myArray[] (1; 
myArray = new int[3][5]; 


Populating the array 
The next code fragment uses a pair of nested for loops to populate the elements in the array with 
values of type int 


for(int i=0;i<myArray.length;i++){ 
for(int j=0; 
j<myArray[0].length;j++){ 
myArray[i] [j] = i*j + 1; 
}//end inner for loop 
}//end outer for loop 


This is where the analogy of a two-dimensional array falls apart. It is much easier at this point to think in 
terms of a three-element primary array, each of whose elements contains a reference to a secondary array 
containing five elements. (Note that in Java, the secondary arrays don’t all have to be of the same size. 
Hence, it is possible to create odd-shaped multi-dimensional arrays in Java.) 

Using the length property 

Pay special attention to the two chunks of code that use the length properties of the arrays to determine 
the number of iterations for each of the for loops. 
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The first chunk determines the number of elements in the primary array. In this case, the length property 
contains the value 3. 

The second chunk determines the number of elements in the secondary array that is referred to by the 
contents of the element at index 0 in the primary array. (Think carefully about what I just said.) 

In this case, the length property of the secondary array contains the value 5. 

Putting data into the secondary array elements 

The code interior to the inner loop simply calculates some numeric values and stores those values in the 
elements of the three secondary array objects. 

Let’s look at a picture 

Here is a picture that attempts to illustrate what is really going on here. I don’t know if it will make 
sense to you or not, but hopefully, it won’t make the situation any more confusing than it might already be. 


[->] [110414101101] 


[->] [41] [2] [3] [4] [5] 


[->] [41] [3] [5] [7] [9] 


The primary array 

The three large boxes on the left represent the individual elements of the three-element primary array. 
The length property for this array has a value of 3. The arrows in the boxes indicate that the content of 
each of these three elements is a reference to one of the five-element arrays on the right. 

The secondary arrays 

Each of the three rows of five boxes on the right represents a separate five-element array object. Each 
element in each of those array objects contains the int value shown. The length property for each of those 
arrays has a value of 5. 

Access and display the array data 

The code in the following fragment is another pair of nested for loops. 


for(int i=0;i<myArray.length;i++){ 
for(int j=0; 
j<myArray[0].length;j++){ 
System.out.print( 
myArray[i] [j] +" "); 
}//end inner for loop 
System.out.println("") ; 
}//end outer for loop 


In this case, the code in the inner loop accesses the contents of the individual elements in the three five- 
element arrays and displays those contents. If you understand the earlier code in this program, you shouldn’t 
have any difficulty understanding the code in this fragment. 

Back to Question 4 (p. 3049) 
7.6.6.13 Answer 3 


A. Compiler Error 
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7.6.6.13.1 Explanation 3 


An incorrect statement 
The following statement is not the proper way to create an array object in Java. 


int myArray[3] [5]; 


This statement caused the program to fail to compile, producing several error messages. 

What is the correct syntax? 

There are several different formats that can be used to create an array object in Java. One of the 
acceptable ways was illustrated by the code used in Question 2 (p. 3047) . Three more acceptable formats 
are shown below. 


int[][] myArrayA = new int[3] [5]; 
int myArrayB[][] = new int[3][5]; 


int myArrayc 0 [0]; 
myArrayC = new int [3] [5]; 


Two steps are required 

The key thing to remember is that an array is an object in Java. Just like all other (non-anonymous) 

objects in Java, there are two steps involved in creating and preparing an object for use. 
Declare a reference variable 
The first step is to declare a reference variable capable of holding a reference to the object. 
The second step 

The second step is to create the object and to assign the object’s reference to the reference variable. 
From that point on, the reference variable can be used to gain access to the object. 

Two steps can often be combined 

Although there are two steps involved, they can often be combined into a single statement, as indicated 
by the first two acceptable formats shown above. 

In both of these formats, the code on the left of the assignment operator declares a reference variable. 
The code on the right of the assignment operator creates a new array object and returns the array object’s 
reference. The reference is assigned to the new reference variable declared on the left. 

A two-dimensional array object 

In the code fragments shown above, the array object is a two-dimensional array object that can be 
thought of as consisting of three rows and five columns. 

(Actually, multi-dimensional array objects in Java can be much more complex than this. In fact, although 
I have referred to this as a two-dimensional array object, there is no such thing as a multi-dimensional array 
object in Java. The concept of a multi-dimensional array in Java is achieved by creating a tree structure of 
single-dimensional array objects that contain references to other single-dimensional array objects.) 

The square brackets in the declaration 

What about the placement and the number of matching pairs of empty square brackets? As indicated 
in the first two acceptable formats shown above, the empty square brackets can be next to the name of the 
type or next to the name of the reference variable. The end result is the same, so you can use whichever 
format you prefer. 

How many pairs of square brackets are required? 

Also, as implied by the acceptable formats shown above, the number of matching pairs of empty square 

brackets must match the number of so-called dimensions of the array. (This tells the compiler to create 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3065 


a reference variable capable of holding a reference to a one-dimensional array object, whose elements are 
capable of holding references to other array objects.) 
Making the two steps obvious 

A third acceptable format, also shown above, separates the process into two steps. 

One statement in the third format declares a reference variable capable of holding a reference to a two- 
dimensional array object containing data of type int . When that statement finishes executing, the reference 
variable exists, but it doesn’t refer to an actual array object. The next statement creates an array object 
and assigns that object’s reference to the reference variable. 

Back to Question 3 (p. 3048) 


7.6.6.14 Answer 2 
D. Tom Dick Harry 


7.6.6.14.1 Explanation 2 


An array is an object in Java 

An array is a special kind of object in Java. Stated differently, all array structures are encapsulated in 
objects in Java. Further. all array structures are one-dimensional. I often refer to this special kind of object 
as an array object 

An array object always has a property named length . The value of the length property is always 
equal to the number of elements in the array. Thus, a program can always determine the size of an array be 
examining its length property. 

Instantiating an array object 

An array object can be instantiated in at least two different ways: 


1. By using the new operator in conjunction with the type of data to be stored in the array. 
2. By specifying an initial value for every element in the array, in which case the new operator is not 
used. 


This program uses the second of the two ways listed above. 
Declaring a reference variable for an array object 
The following code fragment was extracted from the method named doArrays(). 


St[] myArray = {new St("Tom"), 
new St("Dick"), 
new St ("Harry")}; 


The code to the left of the assignment operator declares a reference variable named myArray . This 
reference variable is capable of holding a reference to an array object that contains an unspecified number 
of references to objects instantiated from the class named St (or any subclass of the class named St) . 
Note the square brackets 
You should note the square brackets in the declaration of the reference variable in the above code (the 
declaration of a reference variable to hold a reference to an ordinary object doesn’t include square brackets) 


Create the array object 

The code to the right of the assignment operator in the above fragment causes the new array object to 
come into being. Note that the new operator is not used to create the array object in this case. (This 
is one of the few cases in Java, along with a literal String object, where it is possible to create a new 
object without using either the new operator or the newInstance method of the class whose name is 
Class .) 
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Populate the array object 

This syntax not only creates the new array object, it also populates it. The new array object created 
by the above code contains three elements, because three initial values were provided. The initial values are 
separated by commas in the initialization syntax. 

Also instantiates three objects of the St class 

The code in the above fragment also instantiates three objects of the class named St . Once the array 
object has come into being, each of the three elements in the array contains a reference to a new object of 
the class St . Each of those objects is initialized to contain the name of a student by using a parameterized 
constructor that is defined in the class. 

The length property value is 3 

Following execution of the above code, the length property of the array object will contain a value of 
3, because the array contains three elements, one for each initial value that was provided. 

Using the length property 

The code in the following fragment uses the length property of the array object in the conditional 
clause of a for loop to display a String representation of each of the objects. 


for(int cnt = 0; 
cnt < myArray.length; 
cnt++) { 
System. out.print ( 
myArray[cnt] +" "); 


Overridden toString method 

The class named St ,from which each of the objects was instantiated, defines an overridden toString 
method that causes the string representation of an object of that class to consist of the String stored in 
an instance variable of the object. 

Thus, the for loop shown above displays the student names that were originally encapsulated in the 
objects when they were instantiated. 

The class named St 

The code in the following fragment shows the beginning of the class named St including one instance 
variable and a parameterized constructor. 


class St{ 
private String name; 


public St(String name){ 
this.name = name; 
}//end constructor 


A very common syntax 

This constructor makes use of a very common syntax involving the reference named this . Basically, 
this syntax says to get the value of the incoming parameter whose name is name and to assign that value 
to the instance variable belonging to this object whose name is also name 

Initializing the object of type St 

Each time a new object of the St class is instantiated, that object contains an instance variable of type 
String whose value matches the String value passed as a parameter to the constructor. 

Overridden toString method 

The overridden toString method for the class named St is shown in the following code fragment. 
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public String toString(){ 
return name; 
}//end toString () 


This version causes the value in the String object, referred to by the instance variable named name , 
to be returned when it is necessary to produce a String representation of the object. 
Back to Question 2 (p. 3047) 


7.6.6.15 Answer 1 


The answer is item D, which reads as follows: 


"Backslash"->\ 
Understand 


7.6.6.15.1 Explanation 1 


Don’t confuse the compiler 
If you include certain characters inside a literal String , you will confuse the compiler. For example, if 
you simply include a quotation mark (") inside a literal String , the compiler will interpret that as the end 
of the string. From that point on, everything will be out of synchronization. Therefore, in order to include 
a quotation mark inside a literal string, you must precede it with a backslash character like this: 
\" 
Multiple lines 
If you want your string to comprise two or more physical lines, you can include a newline code inside a 
String by including the following in the string: 
\n 
Escape character sequences 
These character sequences are often referred to as escape character sequences . Since the backslash is 
used as the first character in such a sequence, if you want to include a backslash in a literal string, you must 
do it like this: 
\\ 
There are some other escape sequences used in Java as well. You would do well to learn how to use them 
before going to an interview for a job as a Java programmer. 
Back to Question 1 (p. 3046) 
-end- 
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e Listings (p. 3090) 
e Miscellaneous (p. 3091) 
e Answers (p. 3091) 


7.7.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

The test consists of a series of questions with answers and explanations of the answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 3090) to easily find and view the listings while you are reading about them. 


7.7.3 Questions 
7.7.3.1 Question 1 


What output is produced by the program shown in Listing 1 (p. 3075) ? 


A. Compiler Error 
B. Runtime Error 

C. Pm OK 

D. None of the above 


Listing 1 . Listing for Question 1. 


public class Ap064{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
double[] A = new double[2]; 


ALO] = 1.0; 
A[1] = 2.0; 
Object B = A; 


System.out.printin("I’m OK"); 
}//end doArrays() 
}// end class 


Table 7.108 


Answer and Explanation (p. 3099) 
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7.7.3.2 Question 2 


What output is produced by the program shown in Listing 2 (p. 3076) ? 


A. Compiler Error 

B. Runtime Error 

C. 1.0 2.0 

D. None of the above. 


Listing 2 . Listing for Question 2. 


public class Ap065{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
double[] A = new double[2]; 
ALO] = 1. 
A[1] = 2. 
Object B 


3 
> 


loo 


A; 


System. out .print1n( 
Bo] +" " + B[1]); 
}//end doArrays() 
}// end class 


Table 7.109 


Answer and Explanation (p. 3098) 


7.7.3.3 Question 3 


What output is produced by the program shown in Listing 3 (p. 3077) ? 


A. Compiler Error 

B. Runtime Error 

C. 1.0 2.0 

D. None of the above. 


Listing 3 . Listing for Question 3. 


continued on next page 
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public class Ap066{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
double[] A = new double[2]; 


ALO] = 1.0; 
A[1] = 2.0; 
Object B = A; 


double C = (double)B; 
System. out. print1n( 
clo] +" " + C[1]); 
}//end doArrays() 
}// end class 


Table 7.110 


Answer and Explanation (p. 3098) 


7.7.3.4 Question 4 


What output is produced by the program shown in Listing 4 (p. 3078) ? 


A. Compiler Error 

B. Runtime Error 

C. 1.0 2.0 

D. None of the above. 
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Listing 4 . Listing for Question 4. 


public class Ap067{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
double[] A = new double[2]; 


ALO] = 1.0; 
A[1] = 2.0; 
Object B = A; 


double[] C = (double[])B; 
System. out. print1n( 
clo] +" " + C[1]); 
}//end doArrays() 
}// end class 


Table 7.111 


Answer and Explanation (p. 3098) 


7.7.3.5 Question 5 


What output is produced by the program shown in Listing 5 (p. 3079) ? 


A. Compiler Error 

B. Runtime Error 

C. 1.0 2.0 

D. None of the above. 
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Listing 5 . Listing for Question 5. 


public class Ap068{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
double[] A = new double[2]; 


ALO] = 1.0; 
A[1] = 2.0; 
Object B = A; 


String[] C = (String[])B; 
System. out. print1n( 
cio] +" " + C[1]); 
}//end doArrays() 
}// end class 


Table 7.112 


Answer and Explanation (p. 3097) 


7.7.3.6 Question 6 


What output is produced by the program shown in Listing 6 (p. 3080) ? 


A. Compiler Error 
B. Runtime Error 
C.12 

D. None of the above 
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Listing 6 . Listing for Question 6. 


public class Ap069{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
Subclass[] A = new Subclass[2]; 
ALO] = new Subclass(1); 
A[1] new Subclass(2); 


System. out .print1n( 
Ato] +" " + A[1]); 
}//end doArrays() 
}// end class 


class Superclass{ 
private int data; 
public Superclass(int data){ 
this.data = data; 
}//end constructor 


public int getData(){ 
return data; 
}//end getData() 


public String toString(){ 
return "" + data; 
}//end toString() 
}//end class SuperClass 


class Subclass extends Superclass{ 
public Subclass(int data){ 
super (data) ; 
}//end constructor 
}//end class Subclass 


Table 7.113 


Answer and Explanation (p. 3097) 


7.7.3.7 Question 7 
What output is produced by the program shown in Listing 7 (p. 3081) ? 


e A. Compiler Error 
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e B. Runtime Error 
e €.12 
e D. None of the above 


CHAPTER 7. OOP SELF-ASSESSMENT 


Listing 7 . Listing for Question 7. 


public class Ap070{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
Subclass[] A = new Subclass[2]; 
ALO] = new Subclass(1); 
A[1] new Subclass(2); 


Superclass[] B = A; 
System. out .print1n( 
B[0] +" " + B[1]); 
}//end doArrays() 
}// end class 


class Superclass{ 
private int data; 
public Superclass(int data){ 
this.data = data; 
}//end constructor 


public int getData()f{ 
return data; 
}//end getData() 


public String toString(){ 
return "" + data; 
}//end toString() 
}//end class SuperClass 


class Subclass extends Superclass{ 
public Subclass(int data){ 
super (data) ; 
}//end constructor 
}//end class Subclass 


Table 7.114 


Answer and Explanation (p. 3096) 
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7.7.3.8 Question 8 
What output is produced by the program shown in Listing 8 (p. 3082) ? 


A. Compiler Error 
B. Runtime Error 
C.12 

D. None of the above 


Listing 8 . Listing for Question 8. 


public class Ap071{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
Superclass[] A = new Superclass[2]; 
ALO] = new Superclass(1); 
A[1] = new Superclass(2); 


Subclass[] B = (Subclass[])A; 
System. out .print1n( 
BLO] +" " + B[1]); 
}//end doArrays() 
}// end class 


class Superclass{ 
private int data; 
public Superclass(int data){ 
this.data = data; 
}//end constructor 


public int getData(){ 
return data; 
}//end getData() 


public String toString(){ 
return "" + data; 
}//end toString() 
}//end class SuperClass 


class Subclass extends Superclass{ 
public Subclass(int data){ 
super (data) ; 
}//end constructor 
}//end class Subclass 
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Table 7.115 


Answer and Explanation (p. 3096) 


7.7.3.9 Question 9 


What output is produced by the program shown in Listing 9 (p. 3084) ? 


A. Compiler Error 
B. Runtime Error 
C.12 

D. None of the above 
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Listing 9 . Listing for Question 9. 


public class Ap0724{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
Subclass[] A = new Subclass[2]; 
ACO] = new Subclass(1); 
A(1] = new Subclass(2); 


Superclass[] B = A; 
Subclass[] C = (Subclass[])B; 
System. out. print1n( 
cio] +" " + C[1]); 
}//end doArrays() 
}// end class 


class Superclass{ 
private int data; 
public Superclass(int data){ 
this.data = data; 
}//end constructor 


public int getData(){ 
return data; 
}//end getData() 


public String toString(){ 
return "" + data; 
}//end toString() 
}//end class SuperClass 


class Subclass extends Superclass{ 
public Subclass(int data){ 
super (data) ; 
}//end constructor 
}//end class Subclass 


Table 7.116 


Answer and Explanation (p. 3095) 


7.7.3.10 Question 10 


What output is produced by the program shown in Listing 10 (p. 3085) ? 
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A. Compiler Error 

B. Runtime Error 

C. 1.0 2.0 

D. D. None of the above 


Listing 10 . Listing for Question 10. 


public class Ap073{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
double[] A = new double[2]; 
A[O] = 1. 
A[1] = 2. 
Object B 


> 
3 


loo 


A; 


System. out. print1n( 
((double[])B)[0] +" " + 
((double[])B)[1]); 

}//end doArrays() 
}// end class 


Table 7.117 


Answer and Explanation (p. 3095) 


7.7.3.11 Question 11 


What output is produced by the program shown in Listing 11 (p. 3086) ? 


A. Compiler Error 
B. Runtime Error 
C.12 

D. None of the above 


Listing 11 . Listing for Question 11. 


continued on next page 
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public class ApO74{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
int[] A = new int[2]; 

ALO] = 1; 

A[1] = 2; 


double[] B = (double[])A; 


System. out. print1n( 
B[o] +" " + B[1]); 
}//end doArrays() 
}// end class 


Table 7.118 


Answer and Explanation (p. 3094) 


7.7.3.12 Question 12 


What output is produced by the program shown in Listing 12 (p. 3087) ? 


A. Compiler Error 
B. Runtime Error 
C.12 

D. None of the above 
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Listing 12 . Listing for Question 12. 


public class ApO75{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 

public void doArrays(){ 
int[] B = returnArray(); 
for(int i = 0; i < B.length;i++){ 

System.out.print(B[i] +" "); 

}//end for loop 
System. out.println() ; 

}//end doArrays() 


public int[] returnArray(){ 
int[] A = new int[2]; 


ALO] = 1; 
A[1] = 2; 
return A; 


}//end returnArray() 
}// end class 


Table 7.119 


Answer and Explanation (p. 3094) 


7.7.3.13 Question 13 


What output is produced by the program shown in Listing 13 (p. 3088) ? 


A. Compiler Error 


B. Runtime Error 


Oo AQ 
NO Oo 


D. None of the above 
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Listing 13 . Listing for Question 13. 


public class ApO76{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
int] AQ; 
A = new int[2][3]; 


for(int i=0; i<A.length;i++){ 
for(int j=0;j<A[0].length;j++){ 
ATi] [j] = i+j; 
}//end inner loop 
}//end outer loop 


for(int i=0; i<A.length;i++){ 
for(int j=0;j<A[0].length;jt++){ 
System. out.print ( 
ATi] [j] +" "); 
}//end inner loop 
System.out.println(); 
}//end outer loop 


}//end doArrays() 
}// end class 


Table 7.120 


Answer and Explanation (p. 3093) 


7.7.3.14 Question 14 


What output is produced by the program shown in Listing 14 (p. 3089) ? 


A. Compiler Error 
B. Runtime Error 
C.12 

D. None of the above 
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CHAPTER 7. OOP SELF-ASSESSMENT 


Listing 14 . Listing for Question 14. 


public class Ap077{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
Subclass[] A = new Subclass[2]; 
ACO] = new Subclass(1); 
A(1] = new Subclass(2); 


Object X = A; 
Superclass B = A; 
Subclass[] C = (Subclass[])B; 
Subclass[] Y = (Subclass[])X; 
System. out. print1n( 

cio] +" " + Y[1]); 


}//end doArrays() 
}// end class 


class Superclass{ 
private int data; 
public Superclass(int data){ 
this.data = data; 
}//end constructor 


public int getData()f{ 
return data; 
}//end getData() 


public String toString(){ 
return "" + data; 
}//end toString() 
}//end class SuperClass 


class Subclass extends Superclass{ 
public Subclass(int data){ 
super (data) ; 
}//end constructor 
}//end class Subclass 


Table 7.121 


Answer and Explanation (p. 3092) 
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7.7.3.15 Question 15 


What output is produced by the program shown in Listing 15 (p. 3090) ? 


A. Compiler Error 
B. Runtime Error 

C. 0 0.0 false 0 

D. None of the above 


Listing 15 . Listing for Question 15. 


public class ApO78{ 
public static void main( 
String args[]){ 
new Worker () .doArrays(); 
}//end main() 
}//end class definition 


class Worker{ 
public void doArrays(){ 
int[] A = new int[1]; 
double[] B = new double[1i]; 
pboolean[] C = new boolean[1i]; 
int[] D = new int[0]; 


System.out.printin(A[O] +" " + 
B[O] ee es Le 
co] +n yg 
D.length); 


}//end doArrays() 
}// end class 


Table 7.122 


Answer and Explanation (p. 3091) 


7.7.4 Listings 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 

Listing 1 (p. 3075) . Listing for Question 1. 
Listing 2 (p. 3076) . Listing for Question 2. 
Listing 3 (p. 3077) . Listing for Question 3. 
Listing 4 (p. 3078) . Listing for Question 4. 
Listing 5 (p. 3079) . Listing for Question 5. 
Listing 6 (p. 3080) . Listing for Question 6. 
Listing 7 (p. 3081) . Listing for Question 7. 
Listing 8 (p. 3082) . Listing for Question 8. 
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e Listing 9 (p. 3084) . Listing for Question 9. 

e Listing 10 (p. 3085) . Listing for Question 10. 
e Listing 11 (p. 3086) . Listing for Question 11. 
e Listing 12 (p. 3087) . Listing for Question 12. 
e Listing 13 (p. 3088) . Listing for Question 13. 
e Listing 14 (p. 3089) . Listing for Question 14. 
e Listing 15 (p. 3090) . Listing for Question 15. 


7.7.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Ap0060: Self-assessment, More on Arrays 
e File: Ap0060.htm 

e Originally published: 2002 

e Published at cnx.org: 12/03/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.7.6 Answers 
7.7.6.1 Answer 15 
C. 0 0.0 false 0 


7.7.6.1.1 Explanation 15 


You can initialize array elements 
You can create a new array object and initialize its elements using statements similar to the following: 


int[] A = {22, 43, 69}; 
XO] B = {new X(32), new X(21)}; 
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What if you don’t initialize array elements? 

If you create a new array object without initializing its elements, the value of each element in the array 
is automatically initialized to a default value. 

Illustrating array element default initialization 

This program illustrates default initialization of int , double , and boolean arrays. 

The default values are as follows: 


zero for all numeric values 
false for all boolean values 
all zero bits for char values 
null for object references 


An array with no elements ... 

This program also illustrates that it is possible to have an array object in Java that has no elements. In 
this case, the value of the length property for the array object is 0. 

Give me an example 

For example, when the user doesn’t enter any arguments on the command line for a Java application, 
the incoming String array parameter to the main method has a length value of 0. 

Another example 

It is also possible that methods that return a reference to an array object may sometimes return a 
reference to an array whose length is 0. The method must satisfy the return type requirement by returning 
a reference to an array object. Sometimes, there is no data to be used to populate the array, so the method 
will simply return a reference to an array object with a length property value of 0. 

Back to Question 15 (p. 3090) 


7.7.6.2 Answer 14 


A. Compiler Error 


7.7.6.2.1 Explanation 14 


Assigning array reference to type Object 

As you learned in an earlier module, you can assign an array object’s reference to an ordinary reference 
variable of the type Object . It is not necessary to indicate that the reference variable is a reference to an 
array by appending square brackets to the type name or the variable name. 

Only works with type Object 

However, you cannot assign an array object’s reference to an ordinary reference variable of any other 
type. For any type other than Object , the reference variable must be declared to hold a reference to an 
array object by appending empty square brackets onto the type name or the variable name. 

The first statement in the following fragment compiles successfully. 


Object X 
Superclass B 


A; 
A; 


However, the second statement in the above fragment produces a compiler error under JDK 1.3, which is 
partially reproduced below. 


ApO77.java:22: incompatible types 
found : Subclass[] 
required: Superclass 

Superclass B = A; 
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Both Superclass and Object are superclasses of the array type referred to by the reference variable 
named A . However, because of the above rule, in order to cause this program to compile successfully, you 
would need to modify it as shown below by adding the requisite empty square brackets to the Superclass 
type name. 


Object X = A; 
Superclass[] B = A; 


Back to Question 14 (p. 3088) 


7.7.6.3 Answer 13 


7.7.6.3.1 Explanation 13 


Syntactical ugliness 

As I indicated in an earlier module, when declaring a reference variable that will refer to an array object, 
you can place the empty square brackets next to the name of the type or next to the name of the reference 
variable. In other words, either of the following formats will work. 


int[][] A; 
int BOO; 


What I may not have told you at that time is that you can place some of the empty square brackets in one 
location and the remainder in the other location. 

Really ugly syntax 

This is indicated by the following fragment, which declares a reference variable for a two-dimensional 
array of type int . Then it creates the two-dimensional array object and assigns the array object’s reference 
to the reference variable. 


int[] AC]; 
A = new int[2][3]; 


While it doesn’t matter which location you use for the square brackets in the declaration, it does matter 
how many pairs of square brackets you place in the two locations combined. The number of dimensions 
on the array (if you want to think of a Java array as having dimensions) will equal the total number of 
pairs of empty square brackets in the declaration of the reference variable. Thus, in this case, the array is a 
two-dimensional array because there is one pair of square brackets next to the type and another pair next 
to the variable name. 

This program goes on to use nested for loops to populate the array and then to display the contents of 
the elements. 

I personally don’t use this syntax, and I hope that you don’t either. However, even if you don’t use it, 
you need to be able to recognize it when used by others. 

Back to Question 13 (p. 3087) 
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7.7.6.4 Answer 12 
C.12 


7.7.6.4.1 Explanation 12 


The length property 

This program illustrates the use of the array property named length , whose value always matches the 
number of elements in the array. 

As a Java programmer, you will frequently call methods that will return a reference to an array object of a 
specified type, but of an unknown length. (See, for example, the method named getEventSet Descriptors 
that is declared in the interface named BeanInfo .) This program simulates that situation. 

Returning a reference to an array 

The method named returnArray returns a reference to an array of type int having two elements. 
Although I fixed the size of the array in this example, I could just as easily have used a random number to 
set a different size for the array each time the method is called. Therefore, the doArrays method making 
the call to the method named returnArray has no way of knowing the size of the array referred to by the 
reference that it receives as a return value. 

All array objects have a length property 

This could be a problem, but Java provides the solution to the problem in the length property belonging 
to all array objects. 

The for loop in the method named doArrays uses the length property of the array to determine 
how many elements it needs to display. This is a very common scenario in Java. 

Back to Question 12 (p. 3086) 


7.7.6.5 Answer 11 


A. Compiler Error 


7.7.6.5.1 Explanation 11 


You cannot cast primitive array references 

You cannot cast an array reference from one primitive type to another primitive type, even if the individual 
elements in the array are of a type that can normally be converted to the new type. 

This program attempts to cast a reference to an array of type int[] and assign it to a reference variable of 
type double ||. Normally, a value of type int will be automatically converted to type double whenever 
there is a need for such a conversion. However, this attempted cast produces the following compiler error 
under JDK 1.3. 


ApO74.java:19: inconvertible types 
found : int[] 
required: double[] 

double[] B = (double[])A; 


Why is this cast not allowed? 

I can’t give you a firm reason why such a cast is not allowed, but I believe that I have a good idea why. 
I speculate that this is due to the fact that the actual primitive values are physically stored in the array 
object, and primitive values of different types require different amounts of storage. For example, the type 
int requires 32 bits of storage while the type double requires 64 bits of storage. 

Would require reconstructing the array object 
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Therefore, to convert an array object containing int values to an array object containing double 
values would require reconstructing the array object and allocating twice as much storage space for each 
element in the array. 

Restriction doesn’t apply to arrays of references 

As you have seen from previous questions, such a casting restriction does not apply to arrays containing 
references to objects. This may be because the amount of storage required to store a reference to an object 
is the same, regardless of the type of the object. Therefore, the allowable casts that you have seen in 
the previous questions did not require any change to the size of the array. All that changed was some 
supplemental information regarding the type of objects to which the elements in the array refer. 

Back to Question 11 (p. 3085) 


7.7.6.6 Answer 10 
C. 1.0 2.0 


7.7.6.6.1 Explanation 10 


Assigning array reference to variable of type Object 
A reference to an array can be assigned to a non-array reference of the class named Object , as in the 
following statement extracted from the program, where A is a reference to an array object of type double 


Object B = A; 


Note that there are no square brackets anywhere in the above statement. Thus, the reference to the array 
object is not being assigned to an array reference of the type Object|] . Rather, it is being assigned to an 
ordinary reference variable of the type Object 

Downcasting to an array type 

Once the array reference has been assigned to the ordinary reference variable of the type Object , that 
reference variable can be downcast and used to access the individual elements in the array as illustrated in 
the following fragment. Note the empty square brackets in the syntax of the cast operator (doublef]) . 


System.out.print1n( 
((double[])B)[0] +" " + 
((double[])B) [1]); 


Placement of parentheses is critical 

Note also that due to precedence issues, the placement of both sets of parentheses is critical in the above 
code fragment. You must downcast the reference variable before applying the index to that variable. 

Back to Question 10 (p. 3084) 
7.7.6.7 Answer 9 


C. 12 
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7.7.6.7.1 Explanation 9 


General array casting rule 

The general rule for casting array references (for arrays whose declared type is the name of a class or an 
interface) is: 

A reference to an array object can be cast to another array type if the elements of the referenced array 
are of a type that can be cast to the type of the elements of the specified array type. 

Old rules apply here also 

Thus, the general rules covering conversion and casting up and down the inheritance hierarchy and among 
classes that implement the same interfaces also apply to the casting of references to array objects. 

A reference to an object can be cast down the inheritance hierarchy to the actual class of the object. 
Therefore, an array reference can also be cast down the inheritance hierarchy to the declared class for the 
array object. 

This program declares a reference to, creates, and populates an array of the class type Subclass . This 
reference is assigned to an array reference of a type that is a superclass of the actual class type of the array. 
Then the superclass reference is downcast to the actual class type of the array and assigned to a different 
reference variable. This third reference variable is used to successfully access and display the contents of the 
elements in the array. 

Back to Question 9 (p. 3083) 


7.7.6.8 Answer 8 


B. Runtime Error 


7.7.6.8.1 Explanation 8 


Another ClassCastException 

While it is allowable to assign an array reference to an array reference variable declared for a class that 
is further up the inheritance hierarchy (as illustrated earlier) , it is not allowable to cast an array reference 
down the inheritance hierarchy to a subclass of the original declared class for the array. 

This program declares a reference for, creates, and populates a two-element array for a class named 
Superclass . Then it downcasts that reference to a subclass of the class named Superclass . The 
compiler is unable to determine that this is a problem. However, the runtime system throws the following 
exception, which terminates the program at runtime. 


java.lang.ClassCastException: [LSuperclass; 
at Worker.doArrays(Ap071.java:19) 
at ApO71.main(Ap071.java:9) 


Back to Question 8 (p. 3082) 


7.7.6.9 Answer 7 
C.12 


7.7.6.9.1 Explanation 7 


Assignment to superclass array reference variable 
This program illustrates that, if you have a reference to an array object containing references to other 
objects, you can assign the array object’s reference to an array reference variable whose type is a superclass 
of the declared class of the array object. (As we will see later, this doesn’t work for array objects containing 
primitive values.) 
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What can you do then? 

Having made the assignment to the superclass reference variable, whether or not you can do anything 
useful with the elements in the array (without downcasting) depends on many factors. 

No downcast required in this case 

In this case, the ability to display the contents of the objects referred to in the array was inherited from 
the class named Superclass . Therefore, it is possible to access and display a String representation 
of the objects without downcasting the array object reference from Superclass to the actual type of the 
objects. 

Probably need to downcast in most cases 

However, that will often not be the case. In most cases, when using a reference of a superclass type, you 
will probably need to downcast in order to make effective use of the elements in the array object. 

Back to Question 7 (p. 3080) 


7.7.6.10 Answer 6 
C.12 


7.7.6.10.1 Explanation 6 


Straightforward array application 

This is a straightforward application of Java array technology for the storage and retrieval of references 
to objects. 

The program declares a reference to, creates, and populates a two-element array of a class named 
Subclass . The class named Subclass extends the class named Superclass , which in turn, extends 
the class named Object by default. 

The super keyword 

The class named Subclass doesn’t do anything particularly useful other than to illustrate extending a 
class. 

However, it also provides a preview of the use of the super keyword for the purpose of causing a 
constructor in a subclass to call a parameterized constructor in its superclass. 

Setting the stage for follow-on questions 

The main purpose for showing you this program is to set the stage for several programs that will be using 
this class structure in follow-on questions. 

Back to Question 6 (p. 3079) 


7.7.6.11 Answer 5 


B. Runtime Error 


7.7.6.11.1 Explanation 5 


ClassCastException 
There are some situations involving casting where the compiler cannot identify an erroneous condition 
that is later identified by the runtime system. This is one of those cases. 
This program begins with an array of type double []. The reference to that array is converted to type 
Object . Then it is cast to type String ||. All of these operations are allowed by the compiler. 
However, at runtime, the runtime system expects to find references to objects of type String in the 
elements of the array. What it finds instead is values of type double stored in the elements of the array. 
As a result, a ClassCastException is thrown. Since it isn’t caught and handled by the program, the 
program terminates with the following error message showing on the screen. 
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java.lang.ClassCastException: [D 
at Worker.doArrays(Ap068. java:17) 
at Ap068.main(Ap068. java:6) 


Back to Question 5 (p. 3078) 


7.7.6.12 Answer 4 
C. 1.0 2.0 


7.7.6.12.1 Explanation 4 


Finally, we got it right 

Finally, we managed to get it all together. The program compiles and executes correctly. This program 
illustrates the assignment of an array object’s reference to a reference variable of type Object , and the 
casting of that reference of type Object back to the correct array type in order to gain access to the 
elements in the array. 

But don’t go away, there is a lot more that you need to know about arrays in Java. We will look at some 
of those things in the questions that follow. 

Back to Question 4 (p. 3077) 


7.7.6.13 Answer 3 


A. Compiler Error 


7.7.6.13.1 Explanation 3 


Must use the correct cast syntax 

While it is possible to store an array object’s reference in a reference variable of type Object , and later 
cast it back to an array type to gain access to the elements in the array, you must use the correct syntax in 
performing the cast. This is not the correct syntax for performing that cast. It is missing the empty square 
brackets required to indicate a reference to an array object. 

A portion of the compiler error produced by JDK 1.3 is shown below: 


Ap066.java:17: inconvertible types 
found : java.lang.Object 
required: double 

double C = (double)B; 


Back to Question 3 (p. 3076) 


7.7.6.14 Answer 2 


A. Compiler Error 


7.7.6.14.1 Explanation 2 


Must cast back to an array type 

This program illustrates another very important point. Although you can assign an array object’s ref- 
erence to a reference variable of type Object , you cannot gain access to the elements in the array while 
treating it as type Object . Instead, you must cast it back to an array type before you can gain access to 
the elements in the array object. 

A portion of the compiler error produced by JDK 1.3 is shown below: 
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Ap065.java:18: array required, but java.lang.Object found 
BLOW) + " " + B[1]); 


Back to Question 2 (p. 3076) 


7.7.6.15 Answer 1 
C. Pm OK 


7.7.6.15.1 Explanation 1 


Assigning array reference to type Object 

This program illustrates a very important point. You can assign an array object’s reference to an ordinary 
reference variable of type Object . Note that I didn’t say Object[| . The empty square brackets are not 
required when the type is Object 

Standard containers or collections 

Later on, when we study the various containers in the Java class libraries (see the Java Collections 
Framework) , we will see that they store references to all objects, including array objects, as type Object 
. Thus, if it were not possible to store a reference to an array object in a reference variable of type Object 
, it would not be possible to use the standard containers to store references to array objects. 

Because it is possible to assign an array object’s reference to a variable of type Object , it is also 
possible to store array object references in containers of type Object 

Back to Question 1 (p. 3075) 

-end- 


7.8 Ap0070: Self-assessment, Method Overloading” 


7.8.1 Table of Contents 


Preface (p. 3099) 
Questions (p. 3100) 


1 (p. 3100) , 2 (p. 3100) , 3 (p. 3101) , 4 (p. 3102) , 5 (p. 3103) , 6 (p. 3105) , 7 (p. 3106) , 8 
(p. 3107) 


Listings (p. 3108) 
Miscellaneous (p. 3109) 
Answers (p. 3109) 


7.8.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

The test consists of a series of questions with answers and explanations of the answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 3108) to easily find and view the listings while you are reading about them. 


!2This content is available online at <http://cnx.org/content /m45276/1.5/>. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3093 


7.8.3 Questions 
7.8.3.1 Question 1 


What output is produced by the program shown in Listing 1 (p. 3100) ? 


A. Compiler Error 
B. Runtime Error 

C. 9 17.64 

D. None of the above 


Listing 1 . Listing for Question 1. 


public class ApO79{ 
public static void main( 
String args[]){ 
new Worker () .doOverLoad() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doOverLoad(){ 
int x = 8; 
double y = 4.2; 
System.out.println(square(x) +" " 
+ square(y)); 
}//end doOverLoad () 


public int square(int y){ 
return y*y; 
}//end square () 


public double square(double y){ 
return y*y; 
}//end square() 
}// end class 


Table 7.123 


Answer and Explanation (p. 3115) 


7.8.3.2 Question 2 


What output is produced by the program shown in Listing 2 (p. 3101) ? 


A. Compiler Error 

B. Runtime Error 

C. float 9.0 double 17.64 
D. None of the above 
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Listing 2 . Listing for Question 2. 


public class Ap080{ 
public static void main( 
String args[]){ 
new Worker () .doOverLoad() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doOverLoad(){ 
int x = 3; 
double y = 4.2; 


System.out.print(square(x) + " "); 
System. out . print (square(y)); 
System. out .println(); 

}//end doOverLoad() 


public float square(float y){ 
System. out.print ("float "); 
return y*y; 

}//end square () 


public double square(double y){ 
System. out.print ("double "); 
return y*y; 

}//end square () 

}// end class 


Table 7.124 


Answer and Explanation (p. 3114) 


7.8.3.3 Question 3 


What output is produced by the program shown in Listing 3 (p. 3102) ? 


A. Compiler Error 
B. Runtime Error 

C. 10 17.64 

D. None of the above 


Listing 3 . Listing for Question 3. 


continued on next page 
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public class Ap081{ 
public static void main( 
String args[]){ 
new Worker () .doOverLoad() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doOverLoad(){ 
double w = 3.2; 
double x = 4.2; 


int y = square(w); 
double z = square(x); 


System.out.println(y + " " + z); 
}//end doOverLoad () 


public int square(double y){ 
return (int) (y*y) ; 
}//end square() 


public double square(double y){ 
return y*y; 


}//end square() 


}// end class 


Table 7.125 


Answer and Explanation (p. 3114) 


7.8.3.4 Question 4 


What output is produced by the program shown in Listing 4 (p. 3103) ? 


A. Compiler Error 
B. Runtime Error 

C. 9 17.64 

D. None of the above 


Listing 4 . Listing for Question 4. 


continued on next page 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3096 


CHAPTER 7. OOP SELF-ASSESSMENT 


public class Ap083{ 
public static void main( 
String args[]){ 
new Worker () .doOverLoad() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doOverLoad(){ 
int w = 3; 
double x = 4.2; 


System. out .print1n( 
new Subclass().square(w) +" " 
+ new Subclass().square(x)); 
}//end doOverLoad () 
}// end class 


class Superclass{ 
public double square(double y){ 
return y*y; 
}//end square() 
}//end class Superclass 


class Subclass extends Superclass{ 
public int square(int y){ 
return y*y; 
}//end square() 
}//end class Subclass 


Table 7.126 


Answer and Explanation (p. 3113) 


7.8.3.5 Question 5 


Which of the following is produced by the program shown in Listing 5 (p. 3105) ? 


A. Compiler Error 
B. Runtime Error 
C. float 2.14748365EF9 
float 9.223372E18 
double 4.2 


D. None of the above 
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Listing 5 . Listing for Question 5. 


public class Ap084{ 
public static void main( 
String args[]){ 
new Worker () .doOverLoad() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doOverLoad(){ 

int x = 2147483647; 
square (x); 
long y = 9223372036854775807L; 
square (y); 
double z = 4.2; 
square (z); 


System. out.println() ; 
}//end doOverLoad () 


public void square(float y){ 
System.out.printin("float" +" " + 
y + " wY: 
}//end square () 


public void square (double y){ 
System. out .println("double" +" " + 
y + " "); 
}//end square() 
}// end class 


Table 7.127 


Answer and Explanation (p. 3111) 


7.8.3.6 Question 6 


What output is produced by the program shown in Listing 6 (p. 3106) ? 


A. Compiler Error 
B. Runtime Error 
C. Test DumIntfc 
D. None of the above 
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Listing 6 . Listing for Question 6. 


public class Ap085{ 
public static void main( 
String args[]){ 
new Worker () .doOverLoad() ; 
}//end main() 
}//end class definition 


class Worker{ 

public void doOverLoad(){ 
Test a = new Test(); 
DumIntfc b = new Test(); 
overLoadMthd (a) ; 
overLoadMthd (b) ; 
System. out.println() ; 

}//end doOverLoad() 


public void overLoadMthd(Test x){ 
System.out.print("Test "); 
3//end overLoadMthd 


public void overLoadMthd(DumIntfc x){ 
System.out.print("DumIntfc "); 

3//end overLoadMthd 

}// end class 


interface DumIntfc{ 
3//end DumIntfc 


class Test implements DumIntfc{ 
3//end class Test 


Table 7.128 


Answer and Explanation (p. 3110) 


7.8.3.7 Question 7 


What output is produced by the program shown in Listing 7 (p. 3107) ? 


A. Compiler Error 
B. Runtime Error 

C. Test Object 

D. None of the above 
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Listing 7 . Listing for Question 7. 


public class Ap086{ 
public static void main( 
String args[]){ 
new Worker () .doOverLoad() ; 
}//end main() 
}//end class definition 


class Worker{ 

public void doOverLoad(){ 
Test a = new Test(); 
Object b = new Test(); 
overLoadMthd (a) ; 
overLoadMthd (b) ; 
System. out.println() ; 

}//end doOverLoad() 


public void overLoadMthd(Test x){ 
System.out.print("Test "); 
3//end overLoadMthd 


public void overLoadMthd (Object x){ 
System.out.print ("Object "); 
3//end overLoadMthd 


}// end class 


class Test{ 
}//end class Test 


Table 7.129 


Answer and Explanation (p. 3110) 


7.8.3.8 Question 8 


What output is produced by the program shown in Listing 8 (p. 3108) ? 


A. Compiler Error 
B. Runtime Error 

C. SubC SuperC 

D. None of the above 
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Listing 8 . Listing for Question 8. 


public class Ap087{ 
public static void main( 
String args[]){ 
new Worker () .doOverLoad() ; 
}//end main() 
}//end class definition 


class Worker{ 
public void doOverLoad(){ 
SubC a = new SubC(); 
SuperC b = new SubC(); 


SubC obj = new SubC(); 
obj .overLoadMthd (a) ; 
obj .overLoadMthd (b) ; 


System. out.println() ; 
}//end doQverLoad () 


}// end class 


class SuperCf{ 
public void overLoadMthd(SuperC x){ 
System.out.print("SuperC "); 
3//end overLoadMthd 
}//end SuperC 


class SubC extends SuperCf{ 
public void overLoadMthd(SubC x){ 
System.out.print("SubC "); 
3//end overLoadMthd 
3//end class SubC 


Table 7.130 


Answer and Explanation (p. 3109) 


7.8.4 Listings 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


e Listing 1 (p. 3100) . Listing for Question 1. 
e Listing 2 (p. 3101) . Listing for Question 2. 
e Listing 3 (p. 3102) . Listing for Question 3. 
e Listing 4 (p. 3103) . Listing for Question 4. 
e Listing 5 (p. 3105) . Listing for Question 5. 
e Listing 6 (p. 3106) . Listing for Question 6. 
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e Listing 7 (p. 3107) . Listing for Question 7. 
e Listing 8 (p. 3108) . Listing for Question 8. 


7.8.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Ap0070: Self-assessment, Method Overloading 
e File: Ap0070.htm 

e Originally published: 2002 

e Published at cnx.org: 12/04/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.8.6 Answers 
7.8.6.1 Answer 8 
C. SubC SuperC 


7.8.6.1.1 Explanation 8 


While admittedly a little convoluted, this is another relatively straightforward application of method over- 
loading using types from the class hierarchy. 

Type SubC , SuperC , or Object? 

This method defines a class named SuperC , which extends Object , and a class named SubC , 
which extends SuperC . Therefore, an object instantiated from the class named SubC can be treated 
as any of the following types: SubC , SuperC , or Object 

Two overloaded methods in different classes 

Two overloaded methods named overLoadMthd are defined in two classes in the inheritance hierarchy. 
The class named SuperC defines a version that requires an incoming parameter of type SuperC . The 
class named SubC defines a version that requires an incoming parameter of type SubC . When called, 
each of these overloaded methods prints the type of its formal argument. 

Two objects of type SubC 
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The program instantiates two objects of the SubC class, storing the reference to one of them in a 
reference variable of type SubC _, and storing the reference to the other in a reference variable of type 
SuperC 

Call the overloaded method twice 

The next step is to call the overloaded method named overLoadMthd twice in succession, passing 
each of the reference variables of type SubC and SuperC to the method. 

Instance methods require an object 

Because the two versions of the overloaded method are instance methods, it is necessary to have an object 
on which to call the methods. This is accomplished by instantiating a new object of the SubC class, storing 
the reference to that object in a reference variable named obj , and calling the overloaded method on that 
reference. 

Overloaded methods not in same class 

The important point here is that the two versions of the overloaded method were not defined in the 
same class. Rather, they were defined in two different classes in the inheritance hierarchy. However, they 
were defined in such a way that both overloaded versions were contained as instance methods in an object 
instantiated from the class named SubC 

No surprises 

There were no surprises. When the overloaded method was called twice in succession, passing the two 
different reference variables as parameters, the output shows that the version that was called in each case 
had a formal argument type that matched the type of the parameter that was passed to the method. 

Back to Question 8 (p. 3107) 


7.8.6.2 Answer 7 
C. Test Object 


7.8.6.2.1 Explanation 7 


Another straightforward application 

This is another straightforward application of method overloading, which produces no surprises. 

This program defines a new class named Test , which extends the Object class by default. This 
means that an object instantiated from the class named Test can be treated either as type Test , or as 
type Object 

The program defines two overloaded methods named overLoadMthd . One requires an incoming 
parameter of type Test . The other requires an incoming parameter of type Object . When called, each 
of these methods prints the type of its incoming parameter. 

The program instantiates two different objects of the class Test , storing a reference to one of them 
in a reference variable of type Test , and storing a reference to the other in a reference variable of type 
Object 

No surprises here 
Then it calls the overloaded overLoadMthd method twice in succession, passing the reference of type 
Test during the first call, and passing the reference of type Object during the second call. 

As mentioned above, the output produces no surprises. The output indicates that the method selected for 
execution during each call is the method with the formal argument type that matches the type of parameter 
passed to the method. 

Back to Question 7 (p. 3106) 


7.8.6.3 Answer 6 
C. Test DumIntfc 
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7.8.6.3.1 Explanation 6 


Overloaded methods with reference parameters 

This is a fairly straightforward application of method overloading. However, rather than requiring method 
parameters of primitive types as in the previous questions in this module, the overloaded methods in this 
program require incoming parameters of class and interface types respectively. 

Type Test or type DumIntfc? 

The program defines an interface named DumlIntfc and defines a class named Test that implements 
that interface. The result is that an object instantiated from the Test class can be treated either as type 
Test or as type DumIntfc (it could also be treated as type Object as well) . 

Two overloaded methods 

The program defines two overloaded methods named overLoadMthd . One requires an incoming 
parameter of type Test , and the other requires an incoming parameter of type DumlIntfe . When 
called, each of the overloaded methods prints a message indicating the type of its argument. 

Two objects of the class Test 

The program instantiates two objects of the class Test . It assigns one of the object’s references to a 
reference variable named a , which is declared to be of type Test 

The program assigns the other object’s reference to a reference variable named b , which is declared to 
be of type DumIntfe . (Remember, both objects were instantiated from the class Test .) 

No surprises here 

Then it calls the overloaded method named overLoadMthd _ twice in succession, passing first the 
reference variable of type Test and then the reference variable of type DumIntfc 

The program output doesn’t produce any surprises. When the reference variable of type Test is passed 
as a parameter, the overloaded method requiring that type of parameter is selected for execution. When the 
reference variable of type DumIntfe is passed as a parameter, the overloaded method requiring that type 
of parameter is selected for execution. 

Back to Question 6 (p. 3105) 


7.8.6.4 Answer 5 


C. float 2.14748365EF9 
float 9.223372E18 
double 4.2 


7.8.6.4.1 Explanation 5 


Another subtle method selection issue 

This program illustrates a subtle issue in the automatic selection of an overloaded method based on 
assignment compatibility. 

This program defines two overloaded methods named square . One requires an incoming parameter of 
type float , and the other requires an incoming parameter of type double 

When called, each of these methods prints the type of its formal argument along with the value of the 
incoming parameter as represented by its formal argument type. In other words, the value of the incoming 
parameter is printed after it has been automatically converted to the formal argument type. 

Printout identifies the selected method 

This printout makes it possible to determine which version is called for different types of parameters. It 
also makes it possible to determine the effect of the automatic conversion on the incoming parameter. What 
we are going to see is that the conversion process can introduce serious accuracy problems. 

Call the method three times 
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The square method is called three times in succession, passing values of type int , long , and 
double during successive calls. 

(Type long is a 64-bit integer type capable of storing integer values that are much larger than can 
be stored in type int  . The use of this type here is important for illustration of data corruption that 
occurs through automatic type conversion.) 

The third invocation of the square method, passing a double as a parameter, is not particularly 
interesting. There is a version of square with a matching argument type, and everything behaves as would 
be expected for this invocation. The interesting behavior occurs when the int and long values are passed 
as parameters. 

Passing an int parameter 

The first thing to note is the behavior of the program produced by the following code fragment. 


int x = 2147483647; 
square (x); 


The above fragment assigns a large integer value (2147483647)to the int variable and passes that variable 
to the square method. This fragment produces the following output on the screen: 


float 2.14748365E9 


As you can see, the system selected the overloaded method that requires an incoming parameter of type 
float for execution in this case (rather than the version that requires type double ). 

Conversion from int to float loses accuracy 

Correspondingly, it converted the incoming int value to type float , losing one decimal digit of accuracy 
in the process. (The original int value contained ten digits of accuracy. This was approximated by a 
nine-digit float value with an exponent value of 9.) 

This seems like an unfortunate choice of overloaded method. Selecting the other version that requires a 
double parameter as input would not have resulted in any loss of accuracy. 

A more dramatic case 

Now, consider an even more dramatic case, as illustrated in the following fragment where a very large 
long integer value(9223372036854775807) is passed to the square method. 


long y = 9223372036854775807L; 
square (y); 


The above code fragment produced the following output: 


float 9.223372E18 


A very serious loss of accuracy 

Again, unfortunately, the system selected the version of the square method that requires a float 
parameter for execution. This caused the long integer to be converted toa float . As a result, the long 
value containing 19 digits of accuracy was converted to an estimate consisting of only seven digits plus an 
exponent. (Even if the overloaded square method requiring a double parameter had been 
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selected, the conversion process would have lost about three digits of accuracy, but that would have been 
much better than losing twelve digits of accuracy.) 

The moral to the story is ... 

Don’t assume that just because the system knows how to automatically convert your integer data to 
floating data, it will protect the integrity of your data. Oftentimes it won’t. 

To be really safe ... 

To be really safe, whenever you need to convert either int or long types to floating format, you should 
write your code in such a way as to ensure that it will be converted to type double instead of type float 


For example, the following modification would solve the problem for the int data and would greatly 
reduce the magnitude of the problem for the long data. Note the use of the (double) cast to force the 
double version of the square method to be selected for execution. 


int x = 2147483647; 
square ((double)x) ; 
long y = 9223372036854775807L; 
square ((double)y) ; 


The above modification would cause the program to produce the following output: 


double 2.147483647E9 
double 9.223372036854776E18 
double 4.2 


This output shows no loss of accuracy for the int value, and the loss of three digits of accuracy for the 
long value. 

(Becausea long anda double both store their data in 64 bits, it is not possible to convert 
avery large long valuetoa double value without some loss in accuracy, but even that is much 
better than converting a 64-bit long value to a 32-bit float value.) 

Back to Question 5 (p. 3103) 


7.8.6.5 Answer 4 
C. 9 17.64 


7.8.6.5.1 Explanation 4 


When the square method is called on an object of the Subclass type passing an int as a parameter, 
there is an exact match to the required parameter type of the square method defined in that class. Thus, 
the method is properly selected and executed. 

When the square method is called on an object of the Subclass type passing a double asa 
parameter, the version of the square method defined in the Subclass type is not selected. The double 
value is not assignment compatible with the required type of the parameter (an int is narrower than 
a double ). 

Having made that determination, the system continues searching for an overloaded method with a required 
parameter that is either type double or assignment compatible with double . It finds the version inherited 
from Superclass that requires a double parameter and calls it. 

The bottom line is, overloaded methods can occur up and down the inheritance hierarchy. 

Back to Question 4 (p. 3102) 
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7.8.6.6 Answer 3 


A. Compiler Error 


7.8.6.6.1 Explanation 3 


Return type is not a differentiating feature 

This is not a subtle issue. This program illustrates the important fact that the return type does not 
differentiate between overloaded methods having the same name and formal argument list. 

For a method to be overloaded, two or more versions of the method must have the same name and 
different formal arguments lists. 

The return type can be the same, or it can be different (it can even be void) . It doesn’t matter. 

These two methods are not a valid overload 

This program attempts to define two methods named square , each of which requires a single incoming 
parameter of type double . One of the methods casts its return value to type int and returns type int 
. The other method returns type double 

The JDK 1.3 compiler produced the following error: 


Ap081.java:28: square(double) is already defined 
in Worker 


public double square(double y){ 


Back to Question 3 (p. 3101) 


7.8.6.7 Answer 2 
C. float 9.0 double 17.64 


7.8.6.7.1 Explanation 2 


This program is a little more subtle 

Once again, the program defines two overloaded methods named square . However, in this case, one 
of the methods requires a single incoming parameter of type float and the other requires a single incoming 
parameter of type double . (Suffice it to say that the float type is similar tothe double type, 
but with less precision. It is a floating type, not an integer type. The double type is a 64-bit floating 
type and the float type is a 32-bit floating type.) 

Passing a type int as a parameter 

This program does not define a method named square that requires an incoming parameter of type 

int . However, the program calls the square method passing a value of type int as a parameter. 
What happens to the int parameter? 

The first question to ask is, will this cause one of the two overloaded methods to be called, or will it 
cause a compiler error? The answer is that it will cause one of the overloaded methods to be called because 
a value of type int is assignment compatible with both type float and type double 

Which overloaded method will be called? 

Since the type int is assignment compatible with type float and also with type double , the next 
question is, which of the two overloaded methods will be called when a value of type int is passed as a 
parameter? 

Learn through experimentation 

I placed a print statement in each of the overloaded methods to display the type of that method’s 

argument on the screen when the method is called. By examining the output, we can see that the method 
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with the float parameter was called first (corresponding to the parameter of type int  ). Then the 
method with the double parameter was called (corresponding to the parameter of type double ). 
Converted int to float 

Thus, the system selected the overloaded method requiring an incoming parameter of type float when 
the method was called passing an int as a parameter. The value of type int was automatically converted 
to type float 

In this case, it wasn’t too important which method was called to process the parameter of type int , 
because the two methods do essentially the same thing — compute and return the square of the incoming 
value. 

However, if the behavior of the two methods were different from one another, it could make a lot of 
difference, which one gets called on an assignment compatible basis. (Even in this case, it makes some 
difference. As we will see later, when a very large int value is converted toa float , there is some 
loss in accuracy. However, when the same very large int value is converted toa double _ , there is 
no loss in accuracy.) 

Avoiding the problem 

One way to avoid this kind of subtle issue is to avoid passing assignment-compatible values to overloaded 
methods. 

Passing assignment-compatible values to overloaded methods allows the system to resolve the issue 
through automatic type conversion. Automatic type conversion doesn’t always provide the best choice. 

Using a cast to force your choice of method 

Usually, you can cast the parameter values to a specific type before calling the method and force the 
system to select your overloaded method of choice. 

For example, in this problem, you could force the method with the double parameter to handle the 
parameter of type int by using the following cast when the method named square is called: 

square((double)x) 

However, as we will see later, casting may not be the solution in every case. 

Back to Question 2 (p. 3100) 


7.8.6.8 Answer 1 
C. 9 17.64 


7.8.6.8.1 Explanation 1 


What is method overloading? 

A rigorous definition of method overloading is very involved and won’t be presented here. However, from 
a practical viewpoint, a method is overloaded when two or more methods having the same name and different 
formal argument lists are defined in the class from which an object is instantiated, or are inherited into an 
object by way of superclasses of that class. 

How does the compiler select among overloaded methods? 

The exact manner in which the system determines which method to call in each particular case is also 
very involved. Basically, the system determines which of the overloaded methods to execute by matching 
the types of parameters passed to the method to the types of arguments defined in the formal argument list. 

Assignment compatible matching 

However, there are a number of subtle issues that arise, particularly when there isn’t an exact match. In 

selecting the version of the method to call, Java supports the concept of an "assignment compatible" match 
(or possibly more than one assignment compatible match) . 

Briefly, assignment compatibility means that it would be allowable to assign a value of the type that is 

passed as a parameter to a variable whose type matches the specified argument in the formal argument list. 
Selecting the best match 
According to Java Language Reference by Mark Grand, 
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"If more than one method is compatible with the given arguments, the method that most closely matches 
the given parameters is selected. If the compiler cannot select one of the methods as a better match than 
the others, the method selection process fails and the compiler issues an error message." 

Understanding subtleties 

If you plan to be a Java programmer, you must have some understanding of the subtle issues involving 
overloaded methods, and the relationship between overloaded methods and overridden methods. Therefore, 
the programs in this module will provide some of that information and discuss some of the subtle issues that 
arise. 

Even if you don’t care about the subtle issues regarding method overloading, many of those issues really 
involve automatic type conversion. You should study these questions to learn about the problems associated 
with automatic type conversion. 

This program is straightforward 

However, there isn’t anything subtle about the program for Question 1 (p. 3100) . This program defines 
two overloaded methods named square . One requires a single incoming parameter of type int . The 
other requires a single incoming parameter of type double . Each method calculates and returns the 
square of the incoming parameter. 

The program calls a method named square twice in succession, and displays the values returned by 
those two invocations. In the first case, an int value is passed as a parameter. This causes the method 
with the formal argument list of type imt to be called. 

In the second case, a double value is passed as a parameter. This causes the method with the formal 
argument list of type double to be called. 

Overloaded methods may have different return types 

Note in particular that the overloaded methods have different return types. One method returns its value 
as type int and the other returns its value as type double . This is reflected in the output format for 
the two return vales as shown below: 

9 17.64 

Back to Question 1 (p. 3100) 

-end- 


7.9 Ap0080: Self-assessment, Classes, Constructors, and Accessor 
Methods” 


7.9.1 Table of Contents 


Preface (p. 3116) 
Questions (p. 3117) 


1 (p. 3117) , 2 (p. 3117) , 3 (p. 3118) , 4 (p. 3119) , 5 (p. 3120) , 6 (p. 3121) , 7 (p. 3122) , 8 
(p. 3123) , 9 (p. 3124) , 10 (p. 3125) 


Listings (p. 3126) 


Miscellaneous (p. 3127) 
Answers (p. 3127) 


7.9.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 
The test consists of a series of questions with answers and explanations of the answers. 


13This content is available online at <http://cnx.org/content /m45279/1.5/>. 
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The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 3126) to easily find and view the listings while you are reading about them. 


7.9.3 Questions 
7.9.3.1 Question 1 


What output is produced by the program shown in Listing 1 (p. 3117) ? 


A. Compiler Error 
B. Runtime Error 

C. An Object 

D. None of the above 


Listing 1 . Listing for Question 1. 


public class Apogof 
public static void main( 
String args[]){ 
new Worker () .make0bj () ; 
}//end main() 
}//end class definition 


class Worker{ 
public void make0bj Qf 
NewClass obj = NewClass(); 
System. out.println(obj); 


}//end makeObj () 


}// end class 


class NewClass{ 
public String toString(){ 
return "An Object"; 
}//end toString() 
}//end NewClass 


Table 7.131 


Answer and Explanation (p. 3135) 


7.9.3.2 Question 2 


What output is produced by the program shown in Listing 2 (p. 3118) ? 


e A. Compiler Error 
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e B. Runtime Error 
e C. An Object 
e D. None of the above 


Listing 2 . Listing for Question 2. 


public class Ap091{ 
public static void main( 
String args[]){ 
new Worker () .make0bj (); 
}//end main() 
}//end class definition 


class Worker{ 
public void make0bj Of 
NewClass obj = new NewClass(); 
System. out .println(obj); 


}//end makeObj () 
}// end class 


Class NewClass{ 
public String toString(){ 
return "An Object"; 
}//end toString() 
}//end NewClass 


Table 7.132 


Answer and Explanation (p. 3134) 


7.9.3.3 Question 3 


What output is produced by the program shown in Listing 3 (p. 3119) ? 


A. Compiler Error 
B. Runtime Error 

C. An Object 

D. None of the above 


Listing 3 . Listing for Question 3. 


continued on next page 
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public class Ap092{ 
public static void main( 
String args[]){ 
new Worker () .make0bj (); 
}//end main() 
}//end class definition 


class Worker{ 
public void makeObj Qf 
NewClass obj = new NewClass(); 
System. out.println(obj); 


}//end makeObj () 
}// end class 


class NewClass{ 
public String toString(){ 
return "An Object"; 
}//end toString() 
}//end NewClass 


Table 7.133 


Answer and Explanation (p. 3133) 


7.9.3.4 Question 4 


What output is produced by the program shown in Listing 4 (p. 3120) ? 


A. Compiler Error 

B. Runtime Error 

C. Object containing 2 
D. None of the above 
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Listing 4 . Listing for Question 4. 


public class Ap093{ 
public static void main( 
String args[]){ 
new Worker () .make0bj (); 
}//end main() 
}//end class definition 


class Worker{ 
public void makeObj Qf 
NewClass obj = new NewClass(); 
System. out.println(obj); 
}//end makeObj () 
}// end class 


class NewClass{ 
private int x = 2; 


public NewClass(int x){ 
this.x = x; 
}//end constructor 


public String toString(){ 
return "Object containing " + x; 
}//end toString() 
3//end NewClass 


Table 7.134 


Answer and Explanation (p. 3131) 


7.9.3.5 Question 5 


What output is produced by the program shown in Listing 5 (p. 3120) ? 


A. Compiler Error 

B. Runtime Error 

C. Object containing 2 
D. None of the above 


Listing 5 . Listing for Question 5. 


continued on next page 
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public class Ap094{ 
public static void main( 
String args[]){ 
new Worker () .make0bj (); 
}//end main() 
}//end class definition 


class Worker{ 
public void make0bj Qf 
Subclass obj = new Subclass(); 
System. out.println(obj); 
}//end makeObj () 
}// end class 


class Superclass{ 
private int x; 


public Superclass(int x){ 
this.x = x; 
}//end constructor 


public String toString(){ 
return "Object containing " + x; 
}//end toString() 


public void setX(int x)f{ 
this.x = x; 
}//end setX() 
}//end Superclass 


class Subclass extends Superclass{ 
public Subclass() { 
setX(2); 
}//end noarg constructor 
3//end Subclass 


Table 7.135 


Answer and Explanation (p. 3131) 


7.9.3.6 Question 6 


What output is produced by the program shown in Listing 6 (p. 3122) ? 


A. Compiler Error 

B. Runtime Error 

C. Object containing 5 
D. Object containing 2 
E. None of the above 
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Listing 6 . Listing for Question 6. 


public class Ap095{ 
public static void main( 
String args[]){ 
new Worker () .make0bj (); 
}//end main() 
}//end class definition 


class Worker{ 
public void makeObj Qf 
NewClass obj = new NewClass(5); 
System. out .println(obj); 
}//end makeObj () 
}// end class 


class NewClass{ 
private int x = 2; 


public NewClass() { 
}//end constructor 


public NewClass(int x){ 
this.x = x; 
}//end constructor 


public String toString(){ 
return "Object containing " + x; 
}//end toString() 
3//end NewClass 


Table 7.136 


Answer and Explanation (p. 3130) 


7.9.3.7 Question 7 
What output is produced by the program shown in Listing 7 (p. 3123) ? 


A. Compiler Error 

B. Runtime Error 

C. Object containing 0, 0.0, false 
D. Object containing 0.0, 0, true 
E. None of the above 
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Listing 7 . Listing for Question 7. 


public class Apogéf{ 
public static void main( 
String args[]){ 
new Worker () .make0bj (); 
}//end main() 
}//end class definition 


class Worker{ 
public void makeObj Qf 
NewClass obj = new NewClass(); 
System. out.println(obj); 
}//end makeObj () 
}// end class 


class NewClass{ 
private int x; 
private double y; 
private boolean Zz; 


public String toString(){ 
return "Object containing " + 
x + ue " + 
y + An " + Z; 
}//end toString() 
}//end NewClass 


Table 7.137 


Answer and Explanation (p. 3130) 


7.9.3.8 Question 8 
What output is produced by the program shown in Listing 8 (p. 3124) ? 


A. Compiler Error 
B. Runtime Error 
C. 2 

D.5 

E. None of the above 


Listing 8 . Listing for Question 8. 


continued on next page 
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public class Apog7{ 
public static void main( 
String args[]){ 
new Worker () .make0bj (); 
}//end main() 
}//end class definition 


class Worker{ 
public void make0bj Qf 
NewClass obj = new NewClass(5); 
System. out.println(obj.getX()); 
}//end makeObj () 
}// end class 


class NewClass{ 
private int x = 2; 


public NewClass() { 
}//end constructor 


public NewClass(int x){ 
this.x = x; 
}//end constructor 


public int getX(){ 
return x; 
}//end getX() 
}//end NewClass 


Table 7.138 


Answer and Explanation (p. 3128) 


7.9.3.9 Question 9 


What output is produced by the program shown in Listing 9 (p. 3125) ? 


A. Compiler Error 
B. Runtime Error 

C. 10 

D. None of the above 
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Listing 9 . Listing for Question 9. 


public class Ap098{ 
public static void main( 
String args[]){ 
new Worker () .make0bj (); 
}//end main() 
}//end class definition 


class Worker{ 
public void make0bj(){ 


NewClass obj = new NewClass(); 
obj .setX(10) ; 
System. out.println(obj.getX()); 


}//end makeObj () 
}// end class 


class NewClass{ 
private int y; 


public void setX(int y){ 
this.y = y; 
}//end setX() 


public int getX(){ 
return y; 
}//end getX() 
3//end NewClass 


Table 7.139 


Answer and Explanation (p. 3128) 


7.9.3.10 Question 10 
What output is produced by the program shown in Listing 10 (p. 3126) ? 


A. Compiler Error 
B. Runtime Error 
C. 2 

D.5 

E. 10 

F. None of the above 
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Listing 10 . Listing for Question 10. 


public class Ap099{ 
public static void main( 
String args[]){ 
new Worker () .make0bj () ; 
}//end main() 
}//end class definition 


class Worker{ 
public void make0bj Qf 
NewClass obj = new NewClass(5); 
obj.x = 10; 
System. out.println(obj.x); 
}//end makeObj () 
}// end class 


class NewClass{ 
private int x = 2; 


public NewClass() { 
}//end constructor 


public NewClass(int x){ 
this.x = x; 
}//end constructor 


public void setX(int x)f{ 
this.x = x; 
}//end setX() 


public int getX(){ 
return x; 
}//end getX() 
}//end NewClass 


Table 7.140 


Answer and Explanation (p. 3127) 


7.9.4 Listings 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


e Listing 1 (p ) . Listing for Question 1. 
e Listing 2 (p ) . Listing for Question 2. 
e Listing 3 (p. 3119) . Listing for Question 3. 
e Listing 4 (p ) . Listing for Question 4. 
e Listing 5 (p ) . Listing for Question 5. 
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e Listing 6 (p. 3122) . Listing for Question 6. 
e Listing 7 (p. 3123) . Listing for Question 7. 
e Listing 8 (p. 3124) . Listing for Question 8. 
e Listing 9 (p. 3125) . Listing for Question 9. 
e Listing 10 (p. 3126) . Listing for Question 10. 


7.9.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Ap0080: Self-assessment, Classes, Constructors, and Accessor Methods 
e File: Ap0080.htm 

e Originally published: 2002 

e Published at cnx.org: 12/05/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.9.6 Answers 
7.9.6.1 Answer 10 


A. Compiler Error 


7.9.6.1.1 Explanation 10 


Variables declared private really are private 
The code in the following fragment attempts to ignore the setter and getter methods and directly access 
the private instance variable named x in the object referred to by the reference variable named obj 


obj.x = 10; 
System. out.println(obj.x); 


This produces a compiler error. The compiler error produced by JDK 1.3 is reproduced below. 
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ApO99.java:19: x has private access in 
NewClass 

obj.x = 10; 
ApO99.java:20: x has private access in 
NewClass 

System. out.println(obj.x); 


Back to Question 10 (p. 3125) 


7.9.6.2 Answer 9 
C. 10 


7.9.6.2.1 Explanation 9 


A setter and a getter 

This is a very simple program that uses a setter (modifier or mutator) method named setX to set the 
value 10 in a property named x that is stored in an instance variable named y in an object instantiated 
from the class named NewClass 

The program also uses a getter (accessor) method named getX to get and display the value of the 
property named x . (Note that according to JavaBeans design patterns, the name of the property is 
unrelated to the name of variable in which the property value is stored.) 

Back to Question 9 (p. 3124) 


7.9.6.3 Answer 8 
D.5 


7.9.6.3.1 Explanation 8 


Hide your data and expose your methods 

For reasons that I won’t go into here, good object-oriented design principles state that in almost all cases 
where an instance variable is not declared to be final , it should be declared private . (A final variable 
behaves like a constant.) 

What is private access? 

When an instance variable is declared private , it is accessible only by methods of the class in which it 
is defined. Therefore, the only way that the "outside world" can gain access to a private instance variable 
is by going through an (usually public ) instance method of the object. 

Accessor, modifier, mutator, setter, and getter methods 

Historically, methods that have been defined for the purpose of exposing private instance variables to 
the outside world have been referred to as accessor and modifier methods. (Modifier methods are also 
sometimes called mutator methods.) 

(Note that since the advent of Sun’s JavaBeans Component design patterns, these methods have also come 
to be known as getter methods and setter methods in deference to the design-pattern naming conventions 
for the methods.) 

A private instance variable with an initializer 

The class named NewClass declares a private instance variable named x and initializes its value 
to 2, as shown in the following code fragment: 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3121 


private int x = 2; 


Two constructors 
The class contains both a noarg constructor and a parameterized constructor as shown in the following 
fragment: 


public NewClass() { 
}//end constructor 


public NewClass(int x){ 
this.x = x; 
}//end constructor 


Calling the noarg constructor 

If an object of the class is instantiated by calling the noarg constructor, the initial value of 2 remains 
intact, and that object contains an instance variable with an initial value of 2. 

Calling the parameterized constructor 

If an object of the class is instantiated by calling the parameterized constructor, the initial value of 2 
is overwritten by the value of the incoming parameter to the parameterized constructor. In this case, that 
value is 5, because the object is instantiated by the following code fragment that passes the literal value 5 
to the parameterized constructor. Thus, the initial value of the instance variable in that object is 5. 


NewClass obj = new NewClass(5); 


A getter method 

Because the instance variable named x is private , it cannot be accessed directly for display by 
the code in the makeObj method of the Worker class. However, the NewClass_ class provides 
the following public getter or accessor method that can be used to get the value stored in the instance 
variable. 

(The name of this method complies with JavaBeans design patterns. If you examine the name carefully, 
you will see why Java programmers often refer to methods like this as getter methods.) 


public int getX(){ 
return x; 
}//end getx() 


Calling the getter method 
Finally, the second statement in the following code fragment calls the getter method on the NewClass 
object to get and display the value of the instance variable named x 


NewClass obj = new NewClass(5); 
System. out .println(obj.getX()); 


Back to Question 8 (p. 3123) 
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7.9.6.4 Answer 7 
C. Object containing 0, 0.0, false 


7.9.6.4.1 Explanation 7 


Default initialization values 

The purpose of this question is to confirm that you understand the default initialization of instance 
variables in an object when you don’t write code to cause the initialization of the instance variable to differ 
from the default. 

By default, all instance variables in a new object are initialized with default values if you don’t provide 
a constructor (or other mechanism) that causes them to be initialized differently from the default. 


e Allinstance variables of the numeric types are initialized to the value of zero for the type. This program 
illustrates default initialization to zero for int and double types. 
Instance variables of type boolean are initialized to false. 
Instance variables of type char are initialized to a 16-bit Unicode character for which all sixteen bits 
have been set to zero. I didn’t include initialization of the char type in the output of this program 
because the default char value is not printable. 

e Instance variables of reference types are initialized to null. 


Back to Question 7 (p. 3122) 


7.9.6.5 Answer 6 


C. Object containing 5 


7.9.6.5.1 Explanation 6 


A parameterized constructor 
This program illustrates the straightforward use of a parameterized constructor. 
The class named NewClass defines a parameterized constructor that requires an incoming parameter 
of type int 
(For good design practice, the class also defines a noarg constructor, even though it isn’t actually used 
in this program. This makes it available if needed later when someone extends the class.) 
Both constructors are shown in the following code fragment. 


public NewClass() { 
}//end constructor 


public NewClass(int x){ 
this.x = x; 
}//end constructor 


The parameterized constructor stores its incoming parameter named x in an instance variable of the class, 
also named x 
(The use of the keyword this is required in this case to eliminate the ambiguity of having a local 

parameter with the same name as an instance variable. This is very common Java programming style that 
you should recognize and understand.) 

Call the parameterized constructor 

The following code fragment calls the parameterized constructor, passing the literal int value of 5 as a 
parameter. 
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NewClass obj = new NewClass(5); 


Hopefully you will have no difficulty understanding the remaining code in the program that causes the value 
stored in the instance variable named x to be displayed on the computer screen. 
Back to Question 6 (p. 3121) 


7.9.6.6 Answer 5 


A. Compiler Error 


7.9.6.6.1 Explanation 5 


If you define any constructors, ... 

The discussion for Question 4 (p. 3119) explained that if you define any constructor in a new class, 
you must define all constructors that will ever be needed for that class. When you define one or more 
constructors, the default noarg constructor is no longer provided by the system on your behalf. 

Question 4 (p. 3119) illustrated a simple manifestation of a problem arising from the failure to define a 
noarg constructor that would be needed later. The reason that it was needed later was that the programmer 
attempted to explicitly use the non-existent noarg constructor to create an instance of the class. 

A more subtle problem 

The problem in this program is more subtle. Unless you (or the programmer of the superclasses) 
specifically write code to cause the system to behave otherwise, each time you instantiate an object of a 
class, the system automatically calls the noarg constructor on superclasses of that class up to and including 
the class named Object . If one or more of those superclasses don’t have a noarg constructor, unless the 
author of the subclass constructor has taken this into account, the program will fail to compile. 

Calling a non-existing noarg constructor 

This program attempts to instantiate an object of a class named Subclass , which extends a class 
named Superclass . By default, when attempting to instantiate the object, the system will attempt to 
call a noarg constructor defined in Superclass 

Superclass has no noarg constructor 

The Superclass class defines a parameterized constructor that requires a single incoming parameter of 
type int . However, it does not also define a noarg constructor. Because the parameterized constructor is 
defined, the default noarg constructor does not exist. As a result, JDK 1.3 produces the following compiler 
error: 


Ap094.java:40: cannot resolve symbol 
symbol : constructor Superclass () 
location: class Superclass 


public Subclass(){ 


Back to Question 5 (p. 3120) 


7.9.6.7 Answer 4 


A. Compiler Error 
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7.9.6.7.1 Explanation 4 


Constructors 
Java uses the following kinds of constructors: 


e Those that take arguments, often referred to as parameterized constructors , which typically perform 
initialization on the new object using parameter values. 

e Those that don’t take arguments, often referred to as default or noarg constructors, which perform 
default initialization on the new object. 

e Those that don’t take arguments but perform initialization on the new object in ways that differ from 
the default initialization. 


Constructor definition is optional 

You are not required to define a constructor when you define a new class. If you don’t define a constructor 
for your new class, a default constructor will be provided on your behalf. This constructor requires no 
argument, and it is typically used in conjunction with the new operator to create an instance of the class 
using statements such as the following: 


NewClass obj = new NewClass(); 


The default constructor 
The default constructor typically does the following: 


e Calls the noarg constructor of the superclass 
e Assists in the process of allocating and organizing memory for the new object 
e Initializes all instance variables of the new object with the following four default values: 


numeric = 0, 
boolean = false, 
char = all zero bits 
reference = null 


Are you satisfied with default values? 

As long as you are satisfied with the default initialization of all instance variables belonging to the object, 
there is no need for you to define a constructor of your own. 

However, in the event that you have initialization needs that are not satisfied by the default constructor, 
you can define your own constructor. Your new constructor may or may not require arguments. (In case 
you have forgotten, the name of the constructor is always the same of the name of the class in which it is 
defined.) 

A non-default noarg constructor 

If your new constructor doesn’t require arguments, you may need to write code that performs initialization 
in ways that differ from the default initialization. For example, you might decide that a particular double 
instance variable needs to be initialized with a random number each time a new object is instantiated. You 
could do that with a constructor of your own design that doesn’t take arguments by defining the constructor 
to get initialization values from an object of the Random lass. 

A parameterized constructor 

If your new constructor does take arguments, (a parameterized constructor) you can define as many 
overloaded versions as you need. Each overloaded version must have a formal argument list that differs from 
the formal argument list of all of the other overloaded constructors for that class. 

(The rules governing the argument list for overloaded constructors are similar to the rules governing the 
argument list for overloaded methods, which were discussed in a previous module.) 
Use parameter values for initialization 
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In this case, you will typically define your parameterized constructors to initialize some or all of the 

instance variables of the new object using values passed to the constructor as parameters. 
What else can a constructor do? 

You can also cause your new constructor to do other things if you so choose. For example, if you know 
how to do so, you could cause your constructor (with or without parameters) to play an audio clip each 
time a new object is instantiated. You could use a parameter to determine which audio clip to play in each 
particular instance. 

The punch line 

So far, everything that I have said is background information for this program. Here is the punch line 
insofar as this program is concerned. 

If you define any constructor in your new class, you must define all constructors that your new class will 
ever need. 

If you define any constructor, the default constructor is no longer provided on your behalf. If your new 
class needs a noarg constructor (and it probably does, but that may not become apparent until later 
when you or someone else extends your class) you must define the noarg version in addition to the other 
overloaded versions that you define. 

A violation of the rule 

This program violated the rule given above. It defined the parameterized constructor for the class named 

NewClass shown below 


public NewClass(int x){ 
this.x = x; 
}//end constructor 


However, the program did not also define a noarg constructor for the NewClass class. 

Calling the noarg constructor 

The code in the makeObj method of the Worker class attempted to instantiate a new object using 
the following code: 


NewClass obj = new NewClass(); 


Since the class definition didn’t contain a definition for a noarg constructor, the following compiler error 
was produced by JDK 1.3. 


Ap0O93.java:18: cannot resolve symbol 
symbol : constructor NewClass 


O 
location: class NewClass 
NewClass obj = new NewClass(); 


Back to Question 4 (p. 3119) 


7.9.6.8 Answer 3 
C. An Object 
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7.9.6.8.1 Explanation 3 


We finally got it right! 

Did you identify the errors in the previous two programs before looking at the answers? 

This program declares the class named NewClass correctly and uses the new operator correctly in 
conjunction with the default noarg constructor for the NewClass class to create a new instance of the 
class (an object) . 

Making the class public 

One of the things that I could do differently would be to make the declaration for the NewClass class 

public (as shown in the following code fragment) . 


public class NewClass{ 
public String toString(){ 
return "An Object"; 
}//end toString () 
3//end NewClass 


I am a little lazy 

The reason that I didn’t declare this class public (and haven’t done so throughout this series of 
modules) is because the source code for all public classes and interfaces must be in separate files. While 
that is probably a good requirement for large programming projects, it is overkill for simple little programs 
like I am presenting in this group of self-assessment modules. 

Dealing with multiple files 

Therefore, in order to avoid the hassle of having to deal with multiple source code files for every program, 
I have been using package-private access for class definitions other than the controlling class (the controlling 
class is declared public) . Although I won’t get into the details at this point, when a class is not declared 
public, it is common to say that it has package-private access instead of public access. 

Back to Question 3 (p. 3118) 


7.9.6.9 Answer 2 


A. Compiler Error 


7.9.6.9.1 Explanation 2 


Java is a case-sensitive language 

Java keywords must be written exactly as specified. The keyword class cannot be written as Class , 
which is the problem with this program. 

The inappropriate use of the upper-case C in the word Class caused the following compiler error. 


ApO91.java:25: ’class’ or ’interface’ expected 


Class NewClass{ 
The solution to the problem 


This problem can be resolved by causing the first character in the keyword class to be a lower-case 
character as shown in the following code fragment. 
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class NewClass{ 
public String toString(){ 
return "An Object"; 
}//end toString () 
}//end NewClass 


Back to Question 2 (p. 3117) 


7.9.6.10 Answer 1 


A. Compiler Error 


7.9.6.10.1 Explanation 1 


Instantiating an object 
There are several ways to instantiate an object in Java: 


Use the newlInstance method of the class named Class 
Reconstruct a serialized object using an I/O readObject method. 
Create an initialized array object such as {1,2,3}. 

Create a String object from a literal string such as "A String". 
Use the new operator. 


Of all of these, the last two are by far the most common. 

What you cannot do! 

You cannot instantiate a new object using code like the following code fragment that was extracted from 
this program. 


NewClass obj = NewClass(); 


This program produces the following compiler error: 


ApO90.java:18: cannot resolve symbol 
symbol : method NewClass () 
location: class Worker 

NewClass obj = NewClass(); 


The solution to the problem 


This problem can be solved by inserting the new operator to the left of the constructor as shown in 
the following code fragment. 


NewClass obj = new NewClass(); 


Back to Question 1 (p. 3117) 
-end- 
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7.10 Ap0090: Self-assessment, the super keyword, final keyword, and 
static methods” 


7.10.1 Table of Contents 


e Preface (p. 3136) 
e Questions (p. 3136) 


1 (p. 3136) , 2 (p. 3137) , 3 (p. 3140) , 4 (p. 3140) , 5 (p. 3141) , 6 (p. 3142) , 7 (p. 3142) , 8 
(p. 3143) , 9 (p. 3144) , 10 (p. 3144) 


e Listings (p. 3145) 
Miscellaneous (p. 3145) 
e Answers (p. 3146) 


7.10.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

The test consists of a series of questions with answers and explanations of the answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 3145) to easily find and view the listings while you are reading about them. 


7.10.3 Questions 
7.10.3.1 Question 1 


What output is produced by the program shown in Listing 1 (p. 3137) ? 


A. Compiler Error 
B. Runtime Error 

C. 1, 2 

D. 5, 10 

E. None of the above 


14This content is available online at <http://cnx.org/content/m45270/1.5/>. 
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Listing 1 . Listing for Question 1. 


public class Ap100{ 
public static void main( 
String args[]){ 
new Worker () .make0bj () ; 
}//end main() 
}//end class definition 


class Worker{ 
public void makeObj Qf 
Subclass obj = new Subclass(); 
System.out.println(obj.getX() + 
") " + obj.getY()); 
}//end makeObj () 
}// end class 


class Superclass{ 
private int x = 1; 


public Superclass(){ 
x =. 5s 
}//end constructor 


public int getX(){ 
return x; 
}//end getX() 
}//end Superclass 


class Subclass extends Superclass{ 
private int y = 2; 


public Subclass() { 
super (); 
y = 10; 

}//end constructor 


public int getY(){ 
return y; 
}//end getY() 
3//end Subclass 


Table 7.141 


Answer and Explanation (p. 3153) 


7.10.3.2 Question 2 
What output is produced by the program shown in Listing 2 (p. 3139) ? 


e A. Compiler Error 
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. Runtime Error 

1, 2 

5, 2 

5, 10 

20, 10 

. None of the above 


QAmMmOAD 
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Listing 2 . Listing for Question 2. 


public class Ap10if{ 
public static void main( 
String args[]){ 
new Worker () .make0bj () ; 
}//end main() 
}//end class definition 


class Worker{ 
public void makeObj Qf 
Subclass obj = new Subclass(); 
System.out.println(obj.getX() + 
") " + obj.getY()); 
}//end makeObj () 
}// end class 


class Superclass{ 
private int x = 1; 


public Superclass(){ 
x =. 5s 
}//end constructor 


public Superclass(int x){ 
this.x = x; 
}//end constructor 


public int getX(){ 
return x; 
}//end getX() 
}//end Superclass 


class Subclass extends Superclass{ 
private int y = 2; 


public Subclass() { 
super (20); 
y = 10; 

}//end constructor 


public int getY(){ 
return y; 
}//end getY() 
3//end Subclass 


Table 7.142 


Answer and Explanation (p. 3152) 
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7.10.3.3 Question 3 


What output is produced by the program shown in Listing 3 (p. 3140) ? 


A. Compiler Error 
B. Runtime Error 
C.5 

D. None of the above 


Listing 3 . Listing for Question 3. 


public class Ap102{ 
public static void main( 
String args[]){ 
new Worker () .finalStuff(); 
}//end main() 
}//end class definition 


class Worker{ 
public void finalStuffQf{ 
final int x = 5; 
x = 10; 
System. out.println(x) ; 
}//end finalStuff () 
}// end class 


Table 7.143 


Answer and Explanation (p. 3151) 


7.10.3.4 Question 4 


What output is produced by the program shown in Listing 4 (p. 3141) ? 


A. Compiler Error 
B. Runtime Error 
C.5 

D. None of the above 
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Listing 4 . Listing for Question 4. 


public class Ap103{ 
public static void main( 
String args[]){ 
new Worker () .finalStuff(); 
}//end main() 
}//end class definition 


class Worker{ 
public void finalStuff(){ 
public final int x = 5; 
System. out.println(x) ; 
}//end finalStuff( 
}// end class 


Table 7.144 


Answer and Explanation (p. 3149) 


7.10.3.5 Question 5 


What output is produced by the program shown in Listing 5 (p. 3141) ? 


A. Compiler Error 
B. Runtime Error 
C.5 

D. None of the above 


Listing 5 . Listing for Question 5. 


public class Ap104{ 
public static void main( 
String args[]){ 
new Worker () .finalStuff(); 
}//end main() 
}//end class definition 


class Worker{ 
void finalStuffQ{ 
final int x = 5; 
System. out.println(x) ; 
}//end finalStuff() 
}// end class 


Table 7.145 


Answer and Explanation (p. 3149) 
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7.10.3.6 Question 6 
What output is produced by the program shown in Listing 6 (p. 3142) ? 


A. Compiler Error 

B. Runtime Error 

C. 3.141592653589793 
D. 3.1415927 

E. None of the above 


Listing 6 . Listing for Question 6. 


public class Ap105{ 
public static void main( 
String args[]){ 
System. out.println(Worker.fPi) ; 
}//end main() 
}//end class definition 


class Worker{ 
public static final float fPi = 
(float)Math.PI; 
}// end class 


Table 7.146 


Answer and Explanation (p. 3149) 


7.10.3.7 Question 7 
What output is produced by the program shown in Listing 7 (p. 3143) ? 


A. Compiler Error 
B. Runtime Error 

C. A static method 
D. None of the above 
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Listing 7 . Listing for Question 7. 


public class Ap106{ 
public static void main( 
String args[]){ 
Worker. staticMethod() ; 
}//end main() 
}//end class definition 


class Worker{ 
public static void staticMethod(){ 
System. out. print1n( 
"A static method"); 
}//end staticMethod() 


}// end class 


Table 7.147 


Answer and Explanation (p. 3148) 


7.10.3.8 Question 8 


What output is produced by the program shown in Listing 8 (p. 3143) ? 


A. Compiler Error 
B. Runtime Error 
C.5 

D. None of the above 


Listing 8 . Listing for Question 8. 


public class Ap107{ 
public static void main( 
String args[]){ 
Worker. staticMethod() ; 
}//end main() 
}//end class Ap107 


class Worker{ 
private int x = 5; 
public static void staticMethod(){ 
System. out.println(x) ; 
3//end staticMethod() 


}// end class 


Table 7.148 
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Answer and Explanation (p. 3148) 


7.10.3.9 Question 9 


What output is produced by the program shown in Listing 9 (p. 3144) ? 


A. Compiler Error 
B. Runtime Error 
C.5 

D. None of the above 


Listing 9 . Listing for Question 9. 


public class Ap108f{ 
public static void main( 
String args[]){ 
Worker. staticMethod() ; 
}//end main() 
}//end class Ap108 


class Worker{ 
private int x = 5; 
public static void staticMethod() { 
System. out .print1n( 
new Worker ().getX()); 
}//end staticMethod() 


public int getX(){ 
return x; 


}//end getX() 


}// end class 


Table 7.149 


Answer and Explanation (p. 3147) 


7.10.3.10 Question 10 


Which output shown below is produced by the program shown in Listing 10 (p. 3145) ? 


A. Compiler Error 


w 


Runtime Error 

C. 38.48451000647496 
12.566370614359172 

D. None of the above 
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Listing 10 . Listing for Question 10. 


public class Ap109f{ 
public static void main(String args[]){ 
System. out.println(Worker.area(3.5)); 
System. out.println(Worker.area(2.0)); 
System. out.println() ; 
}//end main() 
}//end class Ap109 


class Worker{ 
public static double area(double r){ 
return r*r*Math.PI; 
}//end area() 


}// end class 


Table 7.150 
Answer and Explanation (p. 3146) 


7.10.4 Listings 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


e Listing 1 (p. 3137) . Listing for Question 1. 
e Listing 2 (p. 3139) . Listing for Question 2. 
e Listing 3 (p. 3140) . Listing for Question 3. 
e Listing 4 (p. 3141) . Listing for Question 4. 
e Listing 5 (p. 3141) . Listing for Question 5. 
e Listing 6 (p. 3142) . Listing for Question 6. 
e Listing 7 (p. 3143) . Listing for Question 7. 
e Listing 8 (p. 3143) . Listing for Question 8. 
e Listing 9 (p. 3144) . Listing for Question 9. 
e Listing 10 (p. 3145) . Listing for Question 10. 


7.10.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 
e Module name: Ap0090: Self-assessment, the super keyword, final keyword, and static methods 
e File: Ap0090.htm 
e Originally published: 2002 


e Published at cnx.org: 12/05/12 
e Revised: 12/03/14 
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Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.10.6 Answers 
7.10.6.1 Answer 10 


C. 38.48451000647496 
12.566370614359172 


7.10.6.1.1 Explanation 10 


Use static methods sparingly 

Good object-oriented design dictates that static methods be used sparingly, and only in those situations 
where they are appropriate. As you might guess, not all authors will agree on the issue of appropriateness 
in all cases. 

Is this an appropriate use of a static method? 

However, I believe that most authors will agree that this program illustrates an appropriate use of a 
static method. 

No persistence requirement 

This static method computes and returns a result on a non-persistent basis. That is to say, there is no 
attempt by the static method to save any historical information from one call of the method to the next. 

(Of course, the method that calls the static method can save whatever it chooses to save.) 

Avoiding wasted computer resources 

In situations such as this, it would often be a waste of computer resources to require a program to 
instantiate an object and call an instance method on that object just to be able to delegate a non-persistent 
computation to that method. (This is just about as close to a global method as you can get in Java.) 

Computing the area of a circle 

In this program, the Worker class provides a static method named area that receives a double 
parameter representing the radius of a circle. It computes and returns the area of the circle as a double 
value. The static method named area is shown in the following code fragment. 


class Worker{ 
public static double area(double r){ 
return r*r*Math.PI; 
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}//end area() 
}// end class 


As a driver, the main method of the controlling class calls the area method twice in succession, passing 
different values for the radius of a circle. In each case, the main method receives and displays the value 
that is returned by the area method representing the area of a circle. 
Static methods in the class libraries 

If you examine the Java API documentation carefully, you will find numerous examples of static methods 
that produce and return something on a non-persistent basis. (Again, non-persistent in this context means 
that no attempt is made by the static method to store any historical information. It does a job, forgets 
it, and goes on to the next job when it is called again.) 

Factory methods 

For example, the alphabetical index of the JDK 1.3 API lists several dozen static methods named 
getInstance , which are defined in different classes. These methods, which usually produce and return a 
reference to an object, are often called factory methods 

Here is the text from the API documentation describing one of them: 


getInstance(int) 


Static method in class java.awt.AlphaComposite 


Creates an AlphaComposite object with the specified rule. 


Back to Question 10 (p. 3144) 


7.10.6.2 Answer 9 
C. 5 


7.10.6.2.1 Explanation 9 


Going through a reference to ... 
This program illustrates a rather convoluted methodology by which a static method can gain access 
to an instance member of an object. 


class Worker{ 
private int x = 5; 
public static void staticMethod(){ 
System. out .print1n( 
new Worker() .getX()); 
}//end staticMethod() 


public int getx(){ 
return x; 
}//end getx() 


}// end class 
In this example, the static method calls a getter method on a reference to an object to gain access to an 
instance variable belonging to that object. This is what I meant in the discussion in the previous question 


when I said "going through a reference to an object of the class." 
Back to Question 9 (p. 3144) 
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7.10.6.3 Answer 8 


A. Compiler Error 


7.10.6.3.1 Explanation 8 


A static method cannot access ... 

A static method cannot access non-static or instance members of its class without going through a 
reference to an object of the class. 

In this program, the static method attempts to directly access the instance variable named x . Asa 
result, JDK 1.3 produces the following compiler error: 


Ap107.java:17: non-static variable x 
cannot be referenced from a static context 


System. out.println(x) ; 


Back to Question 8 (p. 3143) 


7.10.6.4 Answer 7 
C. A static method 


7.10.6.4.1 Explanation 7 


Using a static method 

This is a very straightforward example of the use of a static method. 

When a method is declared static , it is not necessary to instantiate an object of the class containing 
the method in order to access the method (although it is possible to do so unless the class is declared 
abstract) . All that is necessary to access a public static method is to refer to the name of the class in 
which it is defined and the name of the method joined by a period. 

(A method that is declared static is commonly referred to as a class method. If the method is not 
declared public „it may not be accessible from your code.) 
Accessing the static method 
This is illustrated by the following fragment from the program, with much of the code deleted for brevity. 


Pfr sa 
Worker.staticMethod() ; 
//... 


class Worker{ 
public static void staticMethod(){ 
Nhe 
}//end staticMethod() 


}// end class 
The class named Worker defines a public static method named staticMethod . A statement in 
the main method of the controlling class calls the method by referring to the name of the class and the 


name of the method joined by a period. 
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When should you use static methods? 
Static methods are very useful as utility methods (getting the absolute value of a number, for example) 


In my opinion, you should almost never use a static method in any circumstance that requires the 
storage and use of data from one call of the method to the next. In other words, a static method may 
be appropriate for use when it performs a specific task that is completed each time it is called without the 
requirement for data to persist between calls. 

The Math class contains many good examples of the use of static methods, such as abs , acos , 
asin , etc. 

Back to Question 7 (p. 3142) 


7.10.6.5 Answer 6 
D. 3.1415927 


7.10.6.5.1 Explanation 6 


Using a public static final member variable 

The class named Worker declares and initializes a member variable named fPi 

final 

Because it is declared final , it is not possible to write code that will change its value after it has been 
initialized. 

static 

Because it is declared static , it can be accessed without a requirement to instantiate an object of the 
Worker class. All that is necessary to access the variable is to refer to the name of the class and the name 
of the variable joined by a period. 

Because it is static , it can also be accessed by static methods. 

public 

Because it is declared public , it can be accessed by any code in any method in any object that can 
locate the class. 

Type float is less precise than type double 

Because the initialized value is cast from the type double that is returned by Math.PI to type 
float , an 8-digit approximation is stored in the variable named fPi 

The double value returned by Math.PI is 3.141592653589793 

The cast to type float reduces the precision down to 3.1415927 

Back to Question 6 (p. 3142) 


7.10.6.6 Answer 5 
C.5 


7.10.6.6.1 Explanation 5 


Using a final local variable 

Well, I finally got rid of all the bugs. This program uses a final local variable properly. The program 
compiles and executes without any problems. 

Back to Question 5 (p. 3141) 


7.10.6.7 Answer 4 


A. Compiler Error 
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7.10.6.7.1 Explanation 4 


The purpose of this question is to see if you are still awake. 

What caused the compiler error? 

The statement that caused the compiler error in this program is shown below. Now that you know that 
there was a compiler error, and you know which statement caused it, do you know what caused it? 


public final int x = 5; 


Using public static final member variables 

As I mentioned in an earlier question, the final keyword can be applied either to local variables or to 
member variables. When applying the final keyword to member variables, it is common practice to declare 
them to be both public and static in order to make them as accessible as possible. For example, the 
math class has a final variable that is described as follows: 


public static final double PI 


The double value that is closer than any other to pi, the ratio of the circumference of a circle to its 
diameter. 


The constant named PI 

You may recognize the constant named PI from your high school geometry class. 

Whenever you need the value for the constant PI , you shouldn’t have to instantiate an object just 
to get access to it. Furthermore, your class should not be required to have any special package relationship 
with the Math class just to get access to PI 

The good news ... 
Because PI is declared to be both public and static in the Math class, it is readily available to 
any code in any method in any Java program that has access to the standard Java class library. 

How is PI accessed? 

PI can be accessed by using an expression as simple as that shown below, which consists simply of the 
name of the class and the name of the variable joined by a period (Math.PI) . 


double piRSquare = Math.PI * R * R; 


No notion of public local variables 

As a result of the above, many of you may have become accustomed to associating the keyword public 
with the keyword final . However, if you missed this question and you have read the explanation to this 
point, you must also remember that there is no notion of public or private for local variables. Therefore, 
when this program was compiled under JDK 1.3, a compiler error was produced. That compiler error is 
partially reproduced below: 


Ap103.java:16: illegal start of 
expression 
public final int x = 5; 


Back to Question 4 (p. 3140) 
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7.10.6.8 Answer 3 
A. Compiler Error 


7.10.6.8.1 Explanation 3 


The final keyword 
The final keyword can be applied in a variety of ways in Java. This includes: 


final parameters 

final methods 

final classes 

final variables (constants) 


Behaves like a constant 

When the final keyword is applied to a variable in Java, that causes the variable to behave like a 
constant. In other words, the value of the variable must be initialized when it is declared, and it cannot be 
changed thereafter (see the exception discussed below) . 

Apply to local or member variables 

The final keyword can be applied to either local variables or member variables. (In case you have 
forgotten, local variables are declared inside a method or constructor, while member variables are declared 
inside a class, but outside a method.) 

So, what is the problem? 

The problem with this program is straightforward. As shown in the following code fragment, after 
declaring a final local variable and initializing its value to 5, the program attempts to change the value 
stored in that variable to 10. This is not allowed. 


final int x = 5; 
x = 10; 


A compiler error 
JDK 1.3 produces the following error message: 


Ap102.java:17: cannot assign a value to 
final 
variable x 


x = 10; 


An interesting twist - blank finals 

An interesting twist of the use of the final keyword with local variables is discussed below. 

Background information 

Regardless of whether or not the local variable is declared final , the compiler will not allow you to 
access the value in a local variable if that variable doesn’t contain a value. This means that you must always 
either initialize a local variable or assign a value to it before you can access it. 

So, what is the twist? 

Unlike final member variables of a class, the Java compiler and runtime system do not require you to 
initialize a final local variable when you declare it. Rather, you can wait and assign a value to it later. 
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(Some authors refer to this as a blank final.) However, once you have assigned a value to a final local 
variable, you cannot change that value later. 

The bottom line 

Whether you initialize the final local variable when you declare it, or assign a value to it later, the 
result is the same. It behaves as a constant. The difference is that if you don’t initialize it when you declare 
it, you cannot access it until after you assign a value to it. 

Back to Question 3 (p. 3140) 


7.10.6.9 Answer 2 
F. 20, 10 


7.10.6.9.1 Explanation 2 


Calling a parameterized constructor 

This is a relatively straightforward implementation of the use of the super keyword in a subclass 
constructor to call a parameterized constructor in the superclass. 

The interesting code in the program is highlighted in the following fragment. Note that quite a lot of 
code was deleted from the fragment for brevity. 


class Superclass{ 


Phas 


public Superclass(int x){ 
ae 


}//end constructor 


thes 
}//end Superclass 


class Subclass extends Superclass{ 


EV eine 


public Subclass(){ 
super (20) ; 
Th isc 


}//end constructor 


I fies 
}//end Subclass 


Using the super keyword 

The code that is of interest is the use of super(20) as the first executable statement in the Subclass 
constructor to call the parameterized constructor in the superclass, passing a value of 20 as a parameter to 
the parameterized constructor. 

Note that when the super keyword is used in this fashion in a constructor, it must be the first 
executable statement in the constructor. 

As before, the program plays around a little with initial values for instance variables to see if you are 
alert, but the code that is really of interest is highlighted in the above fragment. 

Back to Question 2 (p. 3137) 
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7.10.6.10 Answer 1 
D. 5, 10 


7.10.6.10.1 Explanation 1 


The execution of constructors 

The purpose of this question and the associated answer is to illustrate explicitly what happens automat- 
ically by default regarding the execution of constructors. 

The Subclass constructor 

This program defines a class named Subclass , which extends a class named Superclass . A portion 
of the Subclass definition, including its noarg constructor is shown in the following code fragment. 
(The class also defines a getter method, which was omitted here for brevity.) 


class Subclass extends Superclass{ 
private int y = 2; 


public Subclass() { 
super () ; 
y = 10; 

}//end constructor 


//... 
}//end Subclass 


The super keyword 

The important thing to note in the above fragment is the statement containing the keyword super 

The super keyword has several uses in Java. As you might guess from the word, all of those uses have 
something to do with the superclass of the class in which the keyword is used. 

Invoke the superclass constructor 

When the super keyword (followed by a pair of matching parentheses) appears as the first executable 
statement in a constructor, this is an instruction to the runtime system to first call the constructor for the 
superclass, and then come back and finish executing the code in the constructor for the class to which the 
constructor belongs. 

Call the noarg superclass constructor 

If the parentheses following the super keyword are empty, this is an instruction to call the noarg 
constructor for the superclass. 

Invoke a parameterized superclass constructor 

If the parentheses are not empty, this is an instruction to find and call a parameterized constructor in 
the superclass whose formal arguments match the parameters in the parentheses. 

Invoke the noarg superclass constructor by default 

Here is an important point that is not illustrated above. If the first executable statement in your 
constructor is not an instruction to call the constructor for the superclass, an instruction to call the noarg 
constructor for the superclass will effectively be inserted into your constructor code before it is compiled. 

Therefore, a constructor for the superclass is always called before the code in the constructor for 
your new class is executed. 

You can choose the superclass constructor 

The superclass constructor that is called may be the noarg constructor for the superclass, or you can 
force it to be a parameterized constructor by inserting something like 

super(3,x,4.5); 

as the first instruction in your constructor definition. 
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Always havea noarg constructor ... 

Now you should understand why I told you in an earlier module that the classes you define should almost 
always havea noarg constructor, either the default noarg version, ora noarg version of your own design. 

If your classes don’t have a noarg constructor, then anyone who extends your classes will be required 
to put code in the constructor for their new class to call a parameterized constructor in your class. 

In this program, the super(); statement in the Subclass constructor causes the noarg constructor 
for the Superclass to be called. That noarg constructor is shown in the following code fragment. 


class Superclass{ 
private int x = 1; 


public Superclass(){ 
s by 
}//end constructor 


Ths 
}//end Superclass 


Additional code 

Beyond an exposure and explanation of the use of the super keyword to call the superclass constructor, 
this program plays a few games with initial values of instance variables just to see if you are alert to that 
sort of thing. However, none of that should be new to you, so I won’t discuss it further here. 

Back to Question 1 (p. 3136) 

-end- 


7.11 Ap0100: Self-assessment, The this keyword, static final vari- 
ables, and initialization of instance variables” 


7.11.1 Table of Contents 


e Preface (p. 3154) 
e Questions (p. 3155) 


1 (p. 3155) , 2 (p. 3156) , 3 (p. 3156) , 4 (p. 3157) , 5 (p. 3159) , 6 (p. 3160) , 7 (p. 3160) , 8 
(p. 3161) , 9 (p. 3162) , 10 (p. 3163) 


Listings (p. 3164) 
Miscellaneous (p. 3165) 
Answers (p. 3165) 


7.11.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

The test consists of a series of questions with answers and explanations of the answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 3164) to easily find and view the listings while you are reading about them. 


15This content is available online at <http://cnx.org/content /m45296/1.4/>. 
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7.11.3 Questions 
7.11.3.1 Question 1 
What output is produced by the program shown in Listing 1 (p. 3155) ? 


A. Compiler Error 
B. Runtime Error 

C. 33 

D. None of the above 


Listing 1 . Listing for Question 1. 


public class Ap110f{ 
public static void main( 
String args[]){ 
new Worker ().doThis() ; 
}//end main() 
}//end class Ap110 


class Worker{ 
private int data = 33; 


public void doThis(){ 
new Helper() .helpMe (this); 
}//end area() 


public String getData(){ 
return data; 
}//end getData() 
}// end class Worker 


class Helper{ 
public void helpMe(Worker param) { 
System. out. print1n( 
param. getData()); 
}//end helpMe() 
}//end class Helper 


Table 7.151 


Answer and Explanation (p. 3177) 


7.11.3.2 Question 2 
What output is produced by the program shown in Listing 2 (p. 3156) ? 


A. Compiler Error 

B. Runtime Error 

C. 33 

D. None of the above. 
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Listing 2 . Listing for Question 2. 


public class Ap111{ 
public static void main( 
String args[]){ 
new Worker ().doThis() ; 
}//end main() 
}//end class Ap111 


class Worker{ 
private int data = 33; 


public void doThis()f{ 
new Helper () .helpMe (this); 
}//end area() 


public String getData(){ 
return "" + data; 
}//end getData() 
}// end class Worker 


class Helper{ 
public void helpMe(Worker param) { 
System. out. print1n( 
param. getData()); 
}//end helpMe() 
}//end class Helper 


Table 7.152 


Answer and Explanation (p. 3175) 


7.11.3.3 Question 3 
What output is produced by the program shown in Listing 3 (p. 3157) ? 


. Compiler Error 
. Runtime Error 
. 11 
. 22 
33 
44 
. None of the above. 


eoeeeeeeee 
ANH UOW> 
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Listing 3 . Listing for Question 3. 


public class Ap112{ 

public static void main( 

String args[]){ 

Worker obji = new Worker(11); 
Worker obj2 = new Worker (22); 
Worker obj3 = new Worker (33); 
Worker obj4 = new Worker (44); 
obj2.doThis(); 

}//end main() 

}//end class Ap112 


class Worker{ 
private int data; 


public Worker(int data) { 
this.data = data; 
}//end constructor 


public void doThis()f{ 
System. out.println(this) ; 
}//end area() 


public String toString(){ 
return "" + data; 
}//end toString() 
}// end class Worker 


Table 7.153 


Answer and Explanation (p. 3173) 


7.11.3.4 Question 4 


What output is produced by the program shown in Listing 4 (p 
Note that 6.283185307179586 is a correct numeric value. 


A. Compiler Error 
B. Runtime Error 
C. 6.283185307179586 
D. None of the above. 
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Listing 4 . Listing for Question 4. 


public class Ap113{ 
public static void main( 
String args[]){ 
System. out. print1n( 
new Worker ().twoPI) ; 
}//end main() 
}//end class Ap113 


class Worker{ 
public static final double twoPI; 


public Worker (){ 
twoPI = 2 * Math.PI; 
}//end constructor 
}// end class Worker 


Table 7.154 


Answer and Explanation (p. 3173) 


7.11.3.5 Question 5 


What output is produced by the program shown in Listing 5 (p. 3159) ? 
Note that 6.283185307179586 is a correct numeric value. 


A. Compiler Error 
B. Runtime Error 
C. 6.283185307179586 
D. None of the above. 


Listing 5 . Listing for Question 5. 


public class Ap114{ 
public static void main( 
String args[]){ 
System. out .print1n( 
new Worker ().twoPI) ; 
}//end main() 
}//end class Ap114 


class Worker{ 
public static final double twoPI 
= 2 * Math.PI; 
}// end class Worker 


Table 7.155 
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Answer and Explanation (p. 3172) 


7.11.3.6 Question 6 


What output is produced by the program shown in Listing 6 (p. 3160) ? 
Note that 6.283185307179586 is a correct numeric value. 


A. Compiler Error 
B. Runtime Error 
C. 6.283185307179586 
D. None of the above. 


Listing 6 . Listing for Question 6. 


public class Ap115{ 
public static void main( 
String args[]){ 
System. out .println (Worker .twoPI); 
}//end main() 
}//end class Ap115 


class Worker{ 
public static final double twoPI 
= 2 * Math.PI; 
}// end class Worker 


Table 7.156 


Answer and Explanation (p. 3171) 


7.11.3.7 Question 7 


What output is produced by the program shown in Listing 7 (p. 3161) ? 
Note that 6.283185307179586 is a correct numeric value. 


A. Compiler Error 

B. Runtime Error 

C. C. 6.283185307179586 
D. None of the above. 
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Listing 7 . Listing for Question 7. 


public class Ap116{ 
public static void main( 
String args[]){ 
System. out.println(Worker.twoPI); 
}//end main() 
}//end class Ap116 


class Worker{ 
public static final double twoPI 


= 2 * myPI; 
public static final double myPI 
= Math.PI; 
}// end class Worker 
Table 7.157 


Answer and Explanation (p. 3170) 


7.11.3.8 Question 8 
What output is produced by the program shown in Listing 8 (p. 3162) ? 


e A. Compiler Error 

B. Runtime Error 

C. 0 0.0 false 

D. null null null 

E. None of the above. 
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Listing 8 . Listing for Question 8. 


public class Ap117{ 
public static void main( 
String args[]){ 
new Worker () .display(); 
}//end main() 
}//end class Ap117 


class Worker{ 
private int myInt; 
private double myDouble; 
private boolean myBoolean; 


public void display(){ 
System. out.print (myInt) ; 
System.out.print(" " + myDouble) ; 
System. out .print1n( 
" " + myBoolean) ; 
}//end displayQ 


}// end class Worker 


Table 7.158 


Answer and Explanation (p. 3169) 


7.11.3.9 Question 9 


What output is produced by the program shown in Listing 9 (p. 3163) ? 


A. Compiler Error 

B. Runtime Error 

C. 0 false 5 true 

D. None of the above. 
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Listing 9 . Listing for Question 9. 


public class Ap118f{ 

public static void main( 

String args[]){ 

new Worker () .display(); 
new Worker(5,true) .display(Q; 
System. out.println() ; 

}//end main() 

}//end class Ap118 


class Worker{ 
private int myInt; 
private boolean myBoolean; 


public Worker(int x, boolean y){ 
myInt = x; 
myBoolean = y; 

}//end parameterized constructor 


public void displayQ{ 
System. out.print (myInt) ; 
System. out. print ( 
nng myBoolean +" "); 
}//end display (Q 


}// end class Worker 


Table 7.159 


Answer and Explanation (p. 3168) 


7.11.3.10 Question 10 


What output is produced by the program shown in Listing 10 (p. 3164) ? 


A. Compiler Error 

B. Runtime Error 

C. 20 222.0 false — 5 222.0 true 
D. None of the above. 


Listing 10 . Listing for Question 10. 


continued on next page 
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public class Ap119f{ 
public static void main( 

String args[]){ 
new Worker () .display(); 
System.out.print("--- "); 
new Worker (5,true) .display(; 
System. out.println() ; 

}//end main() 
}//end class Ap119 


class Worker{ 
private int myInt = 100; 
private double myDouble = 222.0; 
private boolean myBoolean; 


public Worker (){ 
myInt = 20; 
}//end noarg constructor 


public Worker(int x, boolean y){ 
myInt = x; 
myBoolean = y; 

}//end parameterized constructor 


public void displayQf{ 
System.out.print(myInt + " "); 
System.out.print(myDouble + " "); 
System.out.print(myBoolean + " "); 
}//end display () 


}// end class Worker 


Table 7.160 


Answer and Explanation (p. 3165) 


7.11.4 Listings 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


Listing 1 
Listing 2 


e (p ) . Listing for Question 1. 
e (p ) . Listing for Question 2. 
e Listing 3 (p ) . Listing for Question 3. 
e Listing 4 (p ) . Listing for Question 4. 
e Listing 5 (p. 3159) . Listing for Question 5. 
e Listing 6 (p ) . Listing for Question 6. 
e Listing 7 (p ) . Listing for Question 7. 
e Listing 8 (p ) . Listing for Question 8. 
e Listing 9 (p ) . Listing for Question 9. 
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e Listing 10 (p. 3164) . Listing for Question 10. 


7.11.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Ap0100: Self-assessment, The this keyword, static final variables, and initial- 
ization of instance variables 

e File: Ap0100.htm 

e Originally published: 2004 

e Published at cnx.org: 12/08/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.11.6 Answers 
7.11.6.1 Answer 10 
C. 20 222.0 false — 5 222.0 true 


7.11.6.1.1 Explanation 10 


Four ways to initialize instance variables 
There are at least four ways to establish initial values for instance variables (you may be able to think 
of others) : 


1. Allow them to take on their default values. 

2. Establish their values using initialization expressions. 

3. Establish their values using hard-coded values within a constructor. 

4. Establish their values using parameter values passed to parameterized constructors. 


Using the first two ways 
The following fragment illustrates the first two of those four ways. 
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class Worker{ 
private int myInt = 100; 
private double myDouble = 222.0; 
private boolean myBoolean; 


Theos 


In the above fragment, the instance variables named myInt and myDouble receive their initial values 
from initialization expressions. In these two cases, the initialization expressions are very simple. They are 
simply literal expressions. However, they could be much more complex if needed. 

The variable named myBoolean in the above fragment is allowed to take on its default value of false. 

Replacing the default noarg constructor 

The next fragment shows one of the two overloaded constructors in the class named Worker . This 
constructor is a replacement for the default noarg constructor. 


class Worker{ 
private int myInt = 100; 
private double myDouble = 222.0; 
private boolean myBoolean; 


public Worker(){ 
myInt = 20; 
}//end noarg constructor 


ee 


Using hard-coded values for initialization 

This fragment illustrates the third of the four ways listed earlier to establish the initial value of the 
instance variables of an object of the class named Worker . In particular, this fragment assigns the 
hard-coded value 20 to the instance variable named mylInt_ , thus overwriting the value of 100 previously 
established for that variable by an initialization expression. 

(All objects instantiated from the Worker class using this noarg constructor would have the same 
initial value for the variable named myInt _ .) 

Note, that this constructor does not disturb the initial values of the other two instance variables that were 
earlier established by an initialization expression, or by taking on the default value. Thus, the initial values 
of these two instance variables remain as they were immediately following the declaration of the variables. 

Initial values using this noarg constructor 

When an object of the Worker class is instantiated using this constructor and the values of the three 

instance variables are displayed, the results are as shown below: 
20 222.0 false 

The value of myInt is 20 as established by the constructor. The value of myDouble is 222.0 as 

established by the initialization expression, and the value of myBoolean is false as established by default. 
Using constructor parameters for initialization 

The next fragment shows the last of the four ways listed earlier for establishing the initial value of an 

instance variable. 


public class Ap119{ 
public static void main( 
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String args[]){ 
Lhe 
new Worker (5,true) .display(); 
ae 
}//end main() 
}//end class Ap119 


class Worker{ 
private int myInt = 100; 
private double myDouble = 222.0; 
private boolean myBoolean; 


Theos 


public Worker(int x, boolean y){ 
myInt = x; 
myBoolean = y; 

}//end parameterized constructor 


II... 


A parameterized constructor 

The above fragment shows the second of two overloaded constructors for the class named Worker 
This constructor uses two incoming parameter values to establish the values of two of the instance variables, 
overwriting whatever values may earlier have been established for those variables. 

The above fragment uses this constructor to instantiate an object of the Worker class, assigning 
incoming parameter values of 5 and true to the instance variables named myInt and myBoolean 
respectively. This overwrites the value previously placed in the variable named myInt by the initialization 
expression. It also overwrites the default value previously placed in the instance variable named my Boolean 


(Note that this constructor doesn’t disturb the value for the instance variable named myDouble 
that was previously established through the use of an initialization expression.) 

Initial values using parameterized constructor 

After instantiating the new object, this fragment causes the values of all three instance variables to be 
displayed. The result is: 

5 222.0 true 

As you can see, the values contained in the instance variables named myInt and myBoolean are 
the values of 5 and true placed there by the constructor, based on incoming parameter values. The value in 
the instance variable named myDouble is the value placed there by the initialization expression when the 
variable was declared. 

Default initialization 

If you don’t take any steps to initialize instance variables, they will be automatically initialized. Numeric 
instance variables will be initialized with zero value for the type of variable involved. Instance variables of 
type boolean will be initialized to false. Instance variables of type char will be initialized to a Unicode 
value with all 16 bits set to zero. Reference variables will be initialized to null. 

Initialization expression 

If you provide an initialization expression for an instance variable, the value of the expression will overwrite 
the default value, and the value of the initialization expression will become the initial value for the instance 
variable. 

Assignment in constructor code 

If you use an assignment statement in a constructor to assign a value to an instance variable, that 
value will overwrite the value previously placed in the instance variable either by default, or by use of an 
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initialization expression. The constructor has the "last word" on the matter of initialization of instance 
variables. 
Back to Question 10 (p. 3163) 


7.11.6.2 Answer 9 


A. Compiler Error 


7.11.6.2.1 Explanation 9 


The default constructor 
When you define a class, you are not required to define a constructor for the class. If you do not define a 
constructor for the class, a default constructor that takes no arguments will be provided on your behalf. You 
can instantiate new objects of the class by applying the new operator to the default constructor as shown in 
the following code fragment from Question 8 (p. 3161) . 


new Worker ().display(); 


Behavior of the default constructor 

As illustrated in Question 8 (p. 3161) , when you don’t provide a constructor that purposely initializes 
the values of instance variables, or initialize them in some other manner, they will automatically be initialized 
to the default values described in Question 8 (p. 3161) . 

Defining overloaded constructors 

You can also define one or more overloaded constructors having different formal argument lists. The 
typical intended purpose of such constructors is to use incoming parameter values to initialize the values of 
instance variables in the new object. 

A parameterized constructor 

This is illustrated in the following code fragment. This fragment receives two incoming parameters and 
uses the values of those two parameters to initialize the values of two instance variables belonging to the 
new object. 


class Worker{ 
private int myInt; 
private boolean myBoolean; 


public Worker(int x, boolean y){ 
myInt = x; 
myBoolean = y; 

}//end parameterized constructor 


//display() omitted for brevity 
}// end class Worker 
If you define any constructors ... 
However, there is a pitfall that you must never forget. 


If you define any constructors in your new class, you must define all constructors that will ever be required 
for your new class. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3160 CHAPTER 7. OOP SELF-ASSESSMENT 


If you define any constructors, the default constructor will no longer be provided automatically. Therefore, 
if a constructor that takes no arguments will ever be needed for your new class, and you define one or more 
parameterized constructors, you must define the noarg constructor when you define your class. 

A parameterized constructor for Worker 

The class named Worker in this program defines a constructor that receives two incoming parameters, 
one of type int and the other of type boolean . It uses those two incoming parameters to initialize two 
instance variables of the new object. 

Oops! 

However, it does not define a constructor with no arguments in the formal argument list (commonly 
called a noarg constructor) . 

Calling the missing noarg constructor 

The following code in the main method of the controlling class attempts to instantiate two objects 
of the Worker class. The first call of the constructor passes no parameters to the constructor. Thus, it 
requires a noarg constructor in order to instantiate the object. 


public class Ap118{ 

public static void main( 

String args[]){ 

new Worker() .display(); 
new Worker (5,true) .display(); 
System.out.println(); 

}//end main() 

}//end class Ap118 


A compiler error 
Since there is no constructor defined in the Worker class with an empty formal argument list (and 
the default version is not provided) , the program produces the following compiler error. 


Ap118.java:11: cannot resolve symbol 
symbol : constructor Worker 
O 
location: class Worker 

new Worker () .display(); 


Back to Question 9 (p. 3162) 


7.11.6.3 Answer 8 
C. 0 0.0 false 


7.11.6.3.1 Explanation 8 


All instance variables are initialized to default values 

All instance variables are automatically initialized to default values if the author of the class doesn’t take 
explicit steps to cause them to initialized to other values. 

The default values 

Numeric variables are automatically initialized to zero, while boolean variables are automatically 
initialized to false. Instance variables of type char are initialized to a Unicode value with all 16 bits set to 
zero. Reference variables are initialized to null. 

Back to Question 8 (p. 3161) 
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7.11.6.4 Answer 7 


A. Compiler Error 


7.11.6.4.1 Explanation 7 


Pushing the compiler beyond its limits 

Compared to many programming environments, the Java compiler is very forgiving. However, there is a 
limit to how far even the Java compiler is willing to go to keep us out of trouble. 

Initializing the value of a static variable 

We can initialize the value of a static variable using an initialization expression as follows: 


public static final MY_CONSTANT 
= initialization expression; 


Important point 

It is necessary for the compiler to be able to evaluate the initialization expression when it is encountered. 

Illegal forward reference 

This program attempts to use an initialization expression that makes use of the value of another static 
variable (myPI) that has not yet been established at that point in the compilation process. As a result, 
the program produces the following compiler error under JDK 1.3. 


Ap116.java:18: illegal forward reference 
= 2 * myPI; 


Reverse the order of the variable declarations 
The problem can be resolved by reversing the order of the two static variable declarations in the 
following revised version of the program. 


public class Ap11i6{ 
public static void main( 
String args[]){ 
System. out.println(Worker.twoPI) ; 
}//end main() 
}//end class Ap116 


class Worker{ 
public static final double myPI 
= Math.PI; 
public static final double twoPI 
= 2 * myPI; 


}// end class Worker 


This revised version of the program compiles and executes successfully. 
Back to Question 7 (p. 3160) 
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7.11.6.5 Answer 6 
C. 6.283185307179586 


7.11.6.5.1 Explanation 6 


Access via an object 

Question 5 (p. 3159) illustrated the fact that a public static final member variable of a class can 
be accessed via a reference to an object instantiated from the class. 

Not the only way to access a static variable 

However, that is not the only way in which static member variables can be accessed. More importantly, 
public static member variables of a class can be accessed simply by referring to the name of the class and 
the name of the member variable joined by a period. 

(Depending on other factors, it may not be necessary for the static variable to also be declared 
public „ but that is the most general approach.) 

A public static final member variable 

In this program, the Worker class declares and initializes a public static final member variable 
named twoPI as shown in the following fragment. 


class Worker{ 
public static final double twoPI 
= 2 * Math.PI; 
}// end class Worker 


Accessing the static variable 
The single statement in the main method of the controlling class accesses and displays the value of the 
public static final member variable named twoPI as shown in the following fragment. 


public class Ap11i5{ 
public static void main( 
String args[]){ 
System. out .println(Worker.twoPI) ; 
}//end main() 
}//end class Ap115 


Objects share one copy of static variables 
Basically, when a member variable is declared static , no matter how many objects are instantiated 
from a class (including no objects at all) , they all share a single copy of the variable. 
Sharing can be dangerous 
This sharing of a common variable leads to the same kind of problems that have plagued programs that 
use global variables for years. If the code in any object changes the value of the static variable, it is 
changed insofar as all objects are concerned. 
Should you use non-final static variables? 
Most authors will probably agree that in most cases, you probably should not use static variables 
unless you also make them final 
(There are some cases, such as counting the number of objects instantiated from a class, where a non-final 
static variable may be appropriate. However, the appropriate uses of non-final static variables 
are few and far between.) 
Should you also make static variables public ? 
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If you make your variables static and final , you will often also want to make them public so that 
they are easy to access. There are numerous examples in the standard Java class libraries where variables 
are declared as public , static , and final . This is the mechanism by which the class libraries create 
constants and make them available for easy access on a widespread basis. 

The Color class 

For example, the Color class defines a number of public static final variables containing 
the information that represents generic colors such as ORANGE, PINK, and MAGENTA. (By convention, 
constants in Java are written with all upper-case characters, but that is not a technical requirement.) 

If you need generic colors and not custom colors, you can easily access and use these color values without 
the requirement to mix red, green, and blue to produce the desired color values. 

Back to Question 6 (p. 3160) 


7.11.6.6 Answer 5 
C. 6.283185307179586 


7.11.6.6.1 Explanation 5 


A public static final variable 
This program declares a public static final member variable named twoPI in the class named 
Worker , and properly initializes it when it is declared as shown in the following code fragment. 


class Worker{ public static final double twoPI 
= 2 * Math.PI; 
3/}// end class Worker 


From that point forward in the program, this member variable named twoPI behaves like a constant, 
meaning that any code that attempts to change its value will cause a compiler error (as in the program in 
Question 4 (p. 3157) ) .. 

Accessing the static variable 

The following single statement that appears in the main method of the controlling class instantiates a 
new object of the Worker class, accesses, and displays the public static final member variable named 
twoPI 


public static void main( 
String args[]){ 
System. out .print1n( 
new Worker() .twoPI) ; 
} }//end main() 


(Note for future discussion that the variable named twoPI is accessed via a reference to an object 
instantiated from the class named Worker _.) 
This causes the double value 6.283185307179586 to be displayed on the standard output device. 
Back to Question 5 (p. 3159) 
7.11.6.7 Answer 4 


A. Compiler Error 
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7.11.6.7.1 Explanation 4 


A final variable 

When a member variable of a class (not a local variable) is declared final , its value must be established 
when the variable is declared. This program attempts to assign a value to a final member variable after 
it has been declared, producing the following compiler error under JDK 1.3. 


Ap113.java:20: cannot assign a value to 
final variable twoPI 
twoPI = 2 * Math.PI; 


Back to Question 4 (p. 3157) 


7.11.6.8 Answer 3 
D. 22 


7.11.6.8.1 Explanation 3 


Two uses of the this keyword 
This program illustrates two different uses of the this keyword. 
Disambiguating a reference to a variable 
Consider first the use of this that is shown in the following code fragment. 


class Worker{ 
private int data; 


public Worker(int data) f{ 
this.data = data; 
}//end constructor 


Very common usage 

The code in the above fragment is commonly used by many Java programmers. All aspiring Java 
programmers need to know how to read such code, even if they elect not to use it. In addition, understanding 
this code should enhance your overall understanding of the use and nature of the this keyword. 

A parameterized constructor 

The above fragment shows a parameterized constructor for the class named Worker . This constructor 
illustrates a situation where there is a local parameter named data that has the same name as an instance 
variable belonging to the object. 

Casting a shadow 

The existence of the local parameter named data casts a shadow on the instance variable having the 
same name, making it inaccessible by using its name alone. 

(A local variable having the same name as an instance variable casts a similar shadow on the instance 
variable.) 

In this shadowing circumstance, when the code in the constructor refers simply to the name data , it 
is referring to the local parameter having that name. In order for the code in the constructor to refer to the 
instance variable having the name data, it must refer to it as this.data 

In other words ... 

In other words, this.data is a reference to an instance variable named data belonging to the object 

being constructed by the constructor (this object) . 
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Not always necessary 

You could always use this syntax to refer to an instance variable of the object being constructed if you 
wanted to. However, the use of this syntax is necessary only when a local parameter or variable has the 
same name as the instance variable and casts a shadow on the instance variable. When this is not the case, 
you can refer to the instance variable simply by referring to its name without the keyword this 

Finally, the main point ... 

Now consider the main point of this program. The following fragment shows the main method of the 
controlling class for the application. 


public class Ap112{ 

public static void main( 

String args[]){ 

Worker obji = new Worker(11); 
Worker obj2 = new Worker (22); 
Worker obj3 = new Worker (33); 
Worker obj4 = new Worker (44); 
obj2.doThis(); 

}//end main() 

}//end class Ap112 


Four different objects of type Worker 

The code in the above fragment instantiates four different objects from the class named Worker , 
passing a different value to the constructor for each object. Thus, individual instance variable in each of the 
four objects contain the int values 11, 22, 33, and 44 respectively. 

Call an instance method on one object 

Then the code in the main method calls the instance method named doThis on only one of the 
objects, which is the one referred to by the reference variable named obj2 

An overridden toString method of the Worker class is eventually called to return a String 
representation of the value stored in the instance variable named data for the purpose of displaying that 
value on the standard output device. 

Overridden toString method 

The next fragment shows the overridden toString method for the Worker class. As you can see, 
this overridden method constructs and returns a reference to a String representation of the int value 
stored in the instance variable named data . Thus, depending on which object the toString method is 
called on, different string values will be returned by the overridden method. 


public String toStringQ{ 
return "" + data; 
}//end toString () 
}// end class Worker 


Passing reference to this object to println method 
The next fragment shows the doThis instance method belonging to each object instantiated from the 
Worker class. When this method is called on a specific object instantiated from the Worker class, 
it uses the this keyword to pass that specific object’s reference to the println method. The println 
method uses that reference to call the toString method on that specific object. This, in turn causes a 
String representation of the value of the instance variable named data belonging to that specific object 
to be displayed. 
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public void doThis()f{ 
System.out.println(this) ; 
}//end area() 


The bottom line 

In this program, the instance variable in the object referred to by obj2 contains the value 22. The 
instance variables in the other three objects instantiated from the same class contain different, values. 

The bottom line is that the following statement in the main method causes the value 22 to be displayed 
on the standard output device. Along the way, the this keyword is used to cause the printIn method to 
get and display the value stored in a specific object, and to ignore three other objects that were instantiated 
from the same class. 


obj2.doThis(); 


Back to Question 3 (p. 3156) 


7.11.6.9 Answer 2 
C. 33 


7.11.6.9.1 Explanation 2 


The this keyword 
The key to an understanding of this program lies in an understanding of the single statement that appears 
in the method named doThis_ , as shown in the following fragment. 


public void doThis()f{ 
new Helper () .helpMe (this); 
}//end area() 


The keyword named this has several uses in Java, some of which are explicit, and some of which take place 
behind the scenes. 

What do you need to know about the this keyword? 

One of the uses of the keyword this is passing the implicit parameter in its entirety to another method. 

That is exactly what this program does. But what is the implicit parameter named this anyway? 

Every object holds a reference to itself 

This implicit reference can be accessed using the keyword this in a non-static (instance) method 
belonging to the object. (The implicit reference named this cannot be accessed from withina static 
method for reasons that won’t be discussed here.) 

Calling an instance method 

An instance method can only be called by referring to a specific object and joining that object’s reference 
to the name of the instance method using a period as the joining operator. This is illustrated in the following 
statement, which calls the method named doThis on a reference to an object of the class named Worker 


new Worker ().doThis() ; 
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An anonymous object 

The above statement creates an anonymous object of the class named Worker . (An anonymous 
object is an object whose reference is not assigned to a named reference variable.) 

The code to the left of the period returns a reference to the new object. Then the code calls the instance 
method named doThis on the reference to the object. 

Which object is this object? 

When the code in the instance method named doThis refers to the keyword this , it is a reference 
to the specific object on which the doThis method was called. The statement in the following fragment 
passes a reference to that specific instance of the Worker class to a method named helpMe in a new 
object of the Helper class. 


public void doThis()f{ 
new Helper () .helpMe (this); 
}//end area() 


A little help here please 
The helpMe method is shown in the following fragment. 


class Helper{ 
public void helpMe(Worker param) { 
System. out .print1n( 
param. getData()); 
}//end helpMe() 
}//end class Helper 


Using the incoming reference 

The code in the helpMe method uses the incoming reference to the object of the Worker class to 
call the getData method on that object. 

Thus code in the helpMe method is able to call a method in the object containing the method that 
called the helpMe method in the first place. 

A callback scenario 

When a method in one object calls a method in another object, passing this as a parameter, that makes 
it possible for the method receiving the parameter to make a callback to the object containing the method 
that passed this as a parameter. 

The getData method returns a String representation of the int instance variable named data 
with a value of 33 that is contained in the object of the Worker class. 

Display the value 
The code in the helpMe method causes that string to be displayed on the computer screen. 
And the main point is ... 

Any number of objects can be instantiated from a given class. A given instance method can be called 
on any of those objects. When the code in such an instance method refers to this , it is referring to the 
specific object on which it was called, and is not referring to any of the many other objects that may have 
been instantiated from the same class. 

Back to Question 2 (p. 3156) 


7.11.6.10 Answer 1 


A. Compiler Error 
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7.11.6.10.1 Explanation 1 


A wakeup call 

The purpose of this question is simply to give you a wakeup call. The declaration for the method named 
getData indicates that the method returns a reference to an object of the class String . However, the 
code in the method attempts to return an int . The program produces the following compiler error under 
JDK 1.3. 


found : int 
required: java.lang.String 
return data; 


Back to Question 1 (p. 3155) 
-end- 


7.12 Ap0O110: Self-assessment, Extending classes, overriding meth- 
ods, and polymorphic behavior“ 


7.12.1 Table of Contents 


e Preface (p. 3177) 
e Questions (p. 3178) 


1 (p. 3178) , 2 (p. 3178) , 3 (p. 3179) , 4 (p. 3180) , 5 (p. 3181) , 6 (p. 3182) , 7 (p. 3183) , 8 
(p. 3184) , 9 (p. 3185) , 10 (p. 3186) 


e Listings (p. 3187) 
e Miscellaneous (p. 3188) 
e Answers (p. 3188) 


7.12.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

The test consists of a series of questions with answers and explanations of the answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 3187) to easily find and view the listings while you are reading about them. 


7.12.3 Questions 
7.12.3.1 Question 1 
What output is produced by the program shown in Listing 1 (p. 3178) ? 


A. Compiler Error 

B. Runtime Error 
C.A 

D. None of the above. 


16This content is available online at <http://cnx.org/content /m45308/1.5/>. 
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Listing 1 . Listing for Question 1. 


public class Ap120{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap120 


class Worker{ 
void doIt(){ 
Base myVar = new AQ); 
myVar.test(); 
System. out .println(""); 
}//end doIt() 
}// end class Worker 


class Base{ 
}//end class Base 


class A extends Base{ 
public void test(){ 
System.out.print("A "); 
}//end test() 
}//end class A 


Table 7.161 


Answer and Explanation (p. 3197) 


7.12.3.2 Question 2 


What output is produced by the program shown in Listing 2 (p. 3179) ? 


A. Compiler Error 

B. Runtime Error 
C. A 

D. None of the above. 
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Listing 2 . Listing for Question 2. 


public class Ap12if{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap121 


class Worker{ 
void doIt(){ 
Base myVar = new AQ); 
((A)myVar) .test() ; 
System.out.println(""); 
}//end doItQ 
}// end class Worker 


class Basef{ 
3//end class Base 


class A extends Base{ 
public void test(){ 
System.out.print("A "); 
}//end test () 
}//end class A 


Table 7.162 


Answer and Explanation (p. 3196) 


7.12.3.3 Question 3 


What output is produced by the program shown in Listing 3 (p. 3180) ? 


A. Compiler Error 

B. Runtime Error 
C. A 

D. None of the above. 
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Listing 3 . Listing for Question 3. 


public class Ap122{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap122 


class Worker{ 
void doIt(){ 
Base myVar = new AQ); 
myVar.test(); 
System. out .println(""); 
}//end doIt() 
}// end class Worker 


class Base{ 
abstract public void test(); 
}//end class Base 


class A extends Base{ 
public void test(){ 
System.out.print("A "); 
}//end test() 
}//end class A 


Table 7.163 


Answer and Explanation (p. 3195) 


7.12.3.4 Question 4 


What output is produced by the program shown in Listing 4 (p. 3181) ? 


A. Compiler Error 

B. Runtime Error 
C. A 

D. None of the above. 
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Listing 4 . Listing for Question 4. 


public class Ap123{ 
public static void main( 
String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Ap123 


class Worker{ 
void doIt(){ 
Base myVar = new AQ); 
myVar.test(); 
System. out .println(""); 
}//end doIt() 
}// end class Worker 


abstract class Base{ 
abstract public void test(); 
}//end class Base 


class A extends Base{ 
public void test(){ 
System.out.print("A "); 
}//end test() 
}//end class A 


Table 7.164 


Answer and Explanation (p. 3194) 


7.12.3.5 Question 5 


What output is produced by the program shown in Listing 5 (p. 3182) ? 


e A. Compiler Error 

B. Runtime Error 

C. Base 

D.A 

E. None of the above. 


Listing 5 . Listing for Question 5. 


continued on next page 
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public class Ap124{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap124 


class Worker{ 
void doIt(){ 
Base myVar = new Base(); 
myVar.test(); 
System. out.println(""); 
}//end dolt() 
}// end class Worker 


abstract class Base{ 
public void test(){ 
System. out.print ("Base ") ;}; 
}//end class Base 


class A extends Base{ 
public void test(){ 
System.out.print("A "); 
}//end test() 
}//end class A 


Table 7.165 


Answer and Explanation (p. 3194) 


7.12.3.6 Question 6 


What output is produced by the program shown in Listing 6 (p. 3183) ? 


A. Compiler Error 

B. Runtime Error 

C. Base 

D.A 

E. None of the above. 
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Listing 6 . Listing for Question 6. 


public class Ap125{ 
public static void main( 
String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Ap125 


class Worker{ 
void doIt(){ 
Base myVar = new Base(); 
myVar.test(); 
System.out.println(""); 
}//end doIt() 
}// end class Worker 


class Base{ 
public void test(){ 
System.out.print("Base ");}; 
}//end class Base 


class A extends Base{ 
public void test(){ 
System.out.print("A "); 
}//end test () 
}//end class A 


Table 7.166 


Answer and Explanation (p. 3193) 


7.12.3.7 Question 7 
What output is produced by the program shown in Listing 7 (p. 3184) ? 


A. Compiler Error 

B. Runtime Error 

C. Base 

D.A 

E. None of the above. 


Listing 7 . Listing for Question 7. 


continued on next page 
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public class Ap126{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap126 


class Worker{ 
void doItQ{ 
Base myVar = new Base(); 
((A)myVar) .test() ; 
System. out .println(""); 
}//end doIt() 
}// end class Worker 


class Base{ 
public void test(){ 
System. out.print ("Base ");}; 
}//end class Base 


class A extends Base{ 
public void test(){ 
System.out.print("A "); 
}//end test() 
}//end class A 


Table 7.167 


Answer and Explanation (p. 3191) 


7.12.3.8 Question 8 


What output is produced by the program shown in Listing 8 (p. 3185) ? 


A. Compiler Error 

B. Runtime Error 

C. Base 

D.A 

E. None of the above. 
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Listing 8 . Listing for Question 8. 


public class Ap127{ 
public static void main( 
String args[]){ 
new Worker().doItQ; 
}//end main() 
}//end class Ap127 


class Worker{ 
void doIt(){ 
Base myVar = new AQ); 
((A)myVar) .test() ; 
System.out.println(""); 
}//end doItQ 
}// end class Worker 


class Base{ 
public void test(){ 
System.out.print("Base ");}; 
}//end class Base 


class A extends Base{ 
public void test(){ 
System.out.print("A "); 
}//end test () 
}//end class A 


Table 7.168 


Answer and Explanation (p. 3190) 


7.12.3.9 Question 9 


What output is produced by the program shown in Listing 9 (p. 3186) ? 


A. Compiler Error 

B. Runtime Error 

C. Base 

D.A 

E. None of the above. 


Listing 9 . Listing for Question 9. 


continued on next page 
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public class Ap128{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap128 


class Worker{ 
void doIt(){ 
Base myVar = new AQ); 
myVar.test(); 
System. out.printin("") ; 
}//end dolt() 
}// end class Worker 


class Base{ 
public void test(){ 
System. out.print ("Base ");}; 
}//end class Base 


class A extends Base{ 
public void test(){ 
System.out.print("A "); 
}//end test() 
}//end class A 


Table 7.169 


Answer and Explanation (p. 3190) 


7.12.3.10 Question 10 


What output is produced by the program shown in Listing 10 (p. 3187) ? 


A. Compiler Error 

B. Runtime Error 

C. Base 

D.AB 

E. None of the above. 
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Listing 10 . Listing for Question 10. 


public class Ap129{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap129 


class Worker{ 
void doIt(){ 
Base myVar = new AQ); 
myVar.test(); 
myVar = new B(); 
myVar.test(); 
System.out.printlin("") ; 
}//end dolt() 
}// end class Worker 


class Base{ 
public void test(){ 
System.out.print("Base ");}; 
}//end class Base 


class A extends Base{ 
public void testQ{ 
System.out.print("A "); 
}//end test () 
}//end class A 


class B extends Base{ 
public void test(){ 
System.out.print("B "); 
}//end test () 
}//end class B 


Table 7.170 


Answer and Explanation (p. 3188) 


7.12.4 Listings 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


e Listing 1 (p ) . Listing for Question 1. 
e Listing 2 (p ) . Listing for Question 2. 
e Listing 3 (p. 3180) . Listing for Question 3. 
e Listing 4 (p ) . Listing for Question 4. 
e Listing 5 (p ) . Listing for Question 5. 
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e Listing 6 (p. 3183) . Listing for Question 6. 
e Listing 7 (p. 3184) . Listing for Question 7. 
e Listing 8 (p. 3185) . Listing for Question 8. 
e Listing 9 (p. 3186) . Listing for Question 9. 
e Listing 10 (p. 3187) . Listing for Question 10. 


7.12.5 Miscellaneous 


This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Ap0110: Self-assessment, Extending classes, overriding methods, and poly- 
morphic behavior 

e File: Ap0110.htm 

e Originally published: 2002 

e Published at cnx.org: 12/08/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.12.6 Answers 
7.12.6.1 Answer 10 
D.AB 


7.12.6.1.1 Explanation 10 


Another illustration of simple polymorphic behavior 

In this program, two classes named A and B extend the class named Base , each overriding the 
method named test to produce different behavior. (Typically, overridden methods in different classes will 
produce different behavior, even though they have the same names.) 

Behavior appropriate for object on which method is called 

In other words, the behavior of the method named test , when called on a reference to an object of 
type A „is different from the behavior of the method named test when called on a reference to an object 
of type B 

The method definitions 
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The definitions of the two classes named A and B , along with the two versions of the overridden 
method named test are shown in the following fragment. 


class A extends Base{ 
public void testQ{ 
System.out.print("A "); 
}//end test () 
}//end class A 


class B extends Base{ 
public void test(){ 
System.out.print("B "); 
}//end test () 
}//end class B 


Store a subclass object’s reference as a superclass type 

The program declares a reference variable of type Base _ , instantiates a new object of the class named 
A, and assigns that object’s reference to the reference variable of type Base . Then it calls the method 
named test on that reference as shown in the following fragment. 


Base myVar = new A(); 
myVar.test() ; 


Polymorphic behavior applies 

Simple polymorphic behavior causes the overridden version of the method named test , defined in the 
class named A , (as opposed to the versions defined in class Base or class B ) to be executed. This 
causes the letter A followed by a space character to be displayed on the standard output device. 

Store another subclass object’s reference as superclass type 

Then the program instantiates a new object from the class named B , and assigns that object’s reference 
to the same reference variable, overwriting the reference previously stored there. (This causes the object 
whose reference was previously stored in the reference variable to become eligible for garbage collection in 
this case.) 

Then the program calls the method named test on the reference as shown in the following fragment. 


myVar = new B(); 
myVar.test(); 


Polymorphic behavior applies again 

This time, simple polymorphic behavior causes the overridden version of the method named test , 
defined in the class named B , (as opposed to the versions defined in class Base or class A ) to be 
executed. This causes the letter B followed by a space character to be displayed on the standard output 
device. 

Once again, what is runtime polymorphic behavior? 

With runtime polymorphic behavior, the method selected for execution is based, not on the type of the 
reference variable holding the reference to the object, but rather on the actual class from which the object 
was instantiated. 

If the method was properly overridden, the behavior exhibited by the execution of the method is appro- 
priate for an object of the class from which the object was instantiated. 

Back to Question 10 (p. 3186) 
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7.12.6.2 Answer 9 
D.A 


7.12.6.2.1 Explanation 9 


Compiles and executes successfully 

This program compiles and executes successfully causing the version of the method named test , which 
is overridden in the class named A to be executed. That overridden method is shown in the following 
fragment. 


class A extends Base{ 
public void test(){ 
System.out.print("A "); 
}//end test() 
}//end class A 


So, what is the issue here? 
The purpose of this program is to determine if you understand polymorphic behavior and the role of 
downcasting. Consider the following fragment taken from the program in Question 8 (p. 3184) . 


Base myVar = new A(); 
((A)myVar) .test(); 


The downcast is redundant 

As you learned in the discussion of Question 8 (p. 3184) , the downcast isn’t required, and it has no 
impact on the behavior of the program in Question 8 (p. 3184) . 

This program behaves exactly the same with the second statement in the above fragment replaced by 
the following statement, which does not contain a downcast. 


myVar.test(); 


Again, you need to know when downcasting is required, when it isn’t required, and to make use of that 
knowledge to downcast appropriately. 


Back to Question 9 (p. 3185) 
7.12.6.3 Answer 8 
D. A 


7.12.6.3.1 Explanation 8 


Compiles and executes successfully 

This program compiles and executes successfully causing the version of the method named test , which 
is overridden in the class named A to be executed. That overridden method is shown in the following 
fragment. 
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class A extends Base{ 
public void testQ{ 
System.out.print("A "); 
}//end test () 
}//end class A 


So, what is the issue here? 
The purpose of this program is to determine if you understand polymorphic behavior and the role of 
downcasting, as shown in the following fragment. 


Base myVar = new A(); 
((A)myVar) .test(); 


This would be a simple case of polymorphic behavior were it not for the downcast shown in the above 
fragment. 

The downcast is redundant 

Actually, the downcast was placed there to see if you could determine that it is redundant. It isn’t 
required, and it has no impact on the behavior of this program. This program would behave exactly the 
same if the second statement in the above fragment were replaced with the following statement, which does 
not contain a downcast. 


myVar.test(); 


You need to know when downcasting is required, when it isn’t required, and to make use of that knowledge 
to downcast appropriately. 
Back to Question 8 (p. 3184) 


7.12.6.4 Answer 7 


B. Runtime Error 


7.12.6.4.1 Explanation 7 


Storing a reference as a superclass type 

You can store an object’s reference in any reference variable whose declared type is a superclass of the 

actual class from which the object was instantiated. 
May need to downcast later 

Later on, when you attempt to make use of that reference, you may need to downcast it. Whether or 

not you will need to downcast will depend on what you attempt to do. 
In order to call a method ... 

For example, if you attempt to call a method on the reference, but that method is not defined in or 
inherited into the class of the reference variable, then you will need to downcast the reference in order to 
call the method on that reference. 

Class Base defines method named test 
This program defines a class named Base that defines a method named test 
Class A extends Base and overrides test 

The program also defines a class named A that extends Base and overrides the method named test 

as shown in the following fragment. 
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class Base{ 
public void test(){ 
System.out.print("Base ");}; 
}//end class Base 


class A extends Base{ 
public void test(){ 
System.out.print("A "); 
}//end test () 
}//end class A 


A new object of the class Base 
The program instantiates a new object of the class Base and stores a reference to that object in a 
reference variable of type Base , as shown in the following fragment. 


Base myVar = new Base(); 
((A)myVar) .test(); 


Could call test directly on the reference 
Having done this, the program could call the method named test directly on the reference variable 
using a statement such as the following, which is not part of this program. 


myVar.test(); 


This statement would cause the version of the method named test defined in the class named Base to 
be called, causing the word Base to appear on the standard output device. 

This downcast is not allowed 

However, this program attempts to cause the version of the method named test defined in the class 
named A to be called, by downcasting the reference to type A before calling the method named test 
This is shown in the following fragment. 


((A)myVar) .test() ; 


A runtime error occurs 
This program compiles successfully. However, the downcast shown above causes the following runtime 
error to occur under JDK 1.3: 


Exception in thread "main" java.lang.ClassCastException: Base 
at Worker .doIt (Ap126. java:22) 
at Ap126.main(Ap126.java:15) 
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What you can do 

You can store an object’s reference in a reference variable whose type is a superclass of the class from 
which the object was originally instantiated. Later, you can downcast the reference back to the type (class) 
from which the object was instantiated. 

What you cannot do 

However, you cannot downcast an object’s reference to a subclass of the class from which the object was 
originally instantiated. 

Unfortunately, the compiler is unable to detect an error of this type. The error doesn’t become apparent 
until the exception is thrown at runtime. 

Back to Question 7 (p. 3183) 


7.12.6.5 Answer 6 
C. Base 


7.12.6.5.1 Explanation 6 


Totally straightforward code 
This rather straightforward program instantiates an object of the class named Base and assigns that 
object’s reference to a reference variable of the type Base as shown in the following fragment 


Base myVar = new Base(); 
myVar.test(); 


Then it calls the method named test on the reference variable. 

Class Base defines the method named test 

The class named Base contains a concrete definition of the method named test as shown in the 
following fragment. This is the method that is called by the code shown in the above fragment (p. 3193) . 


class Base{ 
public void test(){ 
System.out.print("Base ");}; 
}//end class Base 


Class A is just a smokescreen 

The fact that the class named A extends the class named Base , and overrides the method named 
test , as shown in the following fragment, is of absolutely no consequence in the behavior of this program. 
Hopefully you understand why this is so. If not, then you still have a great deal of studying to do on Java 
inheritance. 


class A extends Base{ 
public void testQf{ 
System.out.print("A "); 
}//end test () 
}//end class A 


Back to Question 6 (p. 3182) 
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7.12.6.6 Answer 5 


A. Compiler Error 


7.12.6.6.1 Explanation 5 


Cannot instantiate an abstract class 

This program defines an abstract class named Base . Then it violates one of the rules regarding 
abstract classes, by attempting to instantiate an object of the abstract class as shown in the following 
code fragment. 


Base myVar = new Base(); 


The program produces the following compiler error under JDK 1.3: 


Ap124.java:19: Base is abstract; cannot be instantiated 
Base myVar = new Base(); 


Back to Question 5 (p. 3181) 


7.12.6.7 Answer 4 
C.A 


7.12.6.7.1 Explanation 4 


An abstract class with an abstract method 

This program illustrates the use of an abstract class containing an abstract method to achieve 
polymorphic behavior . 

The following code fragment shows an abstract class named Base that contains an abstract 
method named test 


abstract class Base{ 
abstract public void test(); 
}//end class Base 


Extending abstract class and overriding abstract method 
The class named A , shown in the following fragment extends the abstract class named Base and 
overrides the abstract method named test 


class A extends Base{ 
public void test(){ 
System.out.print("A "); 
}//end test() 
}//end class A 
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Can store a subclass reference as a superclass type 

Because the class named A extends the class named Base , a reference to an object instantiated from 
the class named A can be stored in a reference variable of the declared type Base . No cast is required 
in this case. 

Polymorphic behavior 

Furthermore, because the class named Base contains the method named test , (as an abstract 
method) , when the method named test is called on a reference to an object of the class named A , 
stored in a reference variable of type Base , the overridden version of the method as defined in the class 
named A will actually be called. This is polymorphic behavior. 

(Note, however, that this example does little to illustrate the power of polymorphic behavior because 
only one class extends the class named Base and only one version of the abstract method named test 
exists. Thus, the system is not required to select among two or more overridden versions of the method 
named test .) 

The important code 

The following code fragment shows the instantiation of an object of the class named A and the 
assignment of that object’s reference to a reference variable of type Base . Then the fragment calls the 
method named test on the reference variable. 


Base myVar = new A(); 
myVar.test() ; 


This causes the overridden version of the method named test , shown in the following fragment, to be 
called, which causes the letter A to be displayed on the standard output device. 


public void test(){ 
System.out.print("A "); 
}//end test () 


Back to Question 4 (p. 3180) 


7.12.6.8 Answer 3 


A. Compiler Error 


7.12.6.8.1 Explanation 3 


Classes can be final or abstract, but not both 

A class in Java may be declared final . A class may also be declared abstract . A class cannot be 
declared both final and abstract 

Behavior of final and abstract classes 

A class that is declared final cannot be extended. A class that is declared abstract cannot be 
instantiated. Therefore, it must be extended to be useful. 

An abstract class is normally intended to be extended. 

Methods can be final or abstract, but not both 

A method in Java may be declared final . A method may also be declared abstract . However, a 
method cannot be declared both final and abstract 

Behavior of final and abstract methods 

A method that is declared final cannot be overridden. A method that is declared abstract must be 
overridden to be useful. 
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An abstract method doesn’t have a body. 

Abstract classes and methods 

A class that contains an abstract method must itself be declared abstract . However, an abstract 
class is not required to contain abstract methods. 

Failed to declare the class abstract 

In this program, the class named Base contains an abstract method named test , but the class is 
not declared abstract as required. 


class Basef{ 
abstract public void test(); 
}//end class Base 


Therefore, the program produces the following compiler error under JDK 1.3: 


Ap122.java:24: Base should be declared abstract; 
it does not define test in Base 
class Base{ 


Back to Question 3 (p. 3179) 


7.12.6.9 Answer 2 
C.A 


7.12.6.9.1 Explanation 2 


If you missed this ... 
If you missed this question, you didn’t pay attention to the explanation for Question 1 (p. 3178) . 
Define a method in a subclass 
This program defines a subclass named A that extends a superclass named Base . A method named 
test is defined in the subclass named A but is not defined in any superclass of the class named A 
Store a reference as a superclass type 
The program declares a reference variable of the superclass type, and stores a reference to an object of 
the subclass in that reference variable as shown in the following code fragment. 


Base myVar = new A(); 


Downcast and call the method 
Then the program calls the method named test on the reference stored as the superclass type, as shown 
in the following fragment. 


((A)myVar) .test(); 
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Unlike the program in Question 1 (p. 3178) , the reference is downcast to the true type of the object before 
calling the method named test . As a result, this program does not produce a compiler error. 
Why is the cast required? 

As explained in Question 1 (p. 3178) , it is allowable to store a reference to a subclass object in a variable 
of a superclass type. Also, as explained in Question 1 (p. 3178) , it is not allowable to directly call, on that 
superclass reference, a method of the subclass object that is not defined in or inherited into the superclass. 

However, such a call is allowable if the programmer purposely downcasts the reference to the true type 
of the object before calling the method. 

Back to Question 2 (p. 3178) 


7.12.6.10 Answer 1 


A. Compiler Error 


7.12.6.10.1 Explanation 1 


Define a method in a subclass 
This program defines a subclass named A that extends a superclass named Base . A method named 
test , is defined in the subclass named A , which is not defined in any superclass of the class named A 


Store a reference as superclass type 
The program declares a reference variable of the superclass type, and stores a reference to an object of 
the subclass in that reference variable as shown in the following code fragment. 


Base myVar = new A(); 


Note that no cast is required to store a reference to a subclass object in a reference variable of a superclass 
type. The required type conversion happens automatically in this case. 

Call a method on the reference 

Then the program attempts to call the method named test on the reference stored as the superclass 
type, as shown in the following fragment. This produces a compiler error. 


myVar.test(); 


The reason for the error 

It is allowable to store a reference to a subclass object in a variable of a superclass type. However, it is 
not allowable to directly call, (on that superclass reference) , a method of the subclass object that is not 
defined in or inherited into the superclass. 

The following error message is produced by JDK 1.3. 


Ap120.java:18: cannot resolve symbol 
symbol : method test () 
location: class Base 

myVar.test(); 


The solution is ... 
This error can be avoided by casting the reference to type A before calling the method as shown below: 
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((A)myVar) .test() ; 


Back to Question 1 (p. 3178) 
-end- 


7.13 Ap0120: Self-assessment, Interfaces and polymorphic behavior" 


7.13.1 Table of Contents 


e Preface (p. 3198) 
e Questions (p. 3198) 


1 (p. 3198) , 2 (p. 3199) , 3 (p. 3201) , 4 (p. 3202) , 5 (p. 3203) , 6 (p. 3206) , 7 (p. 3208) , 8 
(p. 3210) , 9 (p. 3212) , 10 (p. 3214) 


e Listings (p. 3216) 
e Miscellaneous (p. 3216) 
e Answers (p. 3216) 


7.13.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

The test consists of a series of questions with answers and explanations of the answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 3216) to easily find and view the listings while you are reading about them. 


7.13.3 Questions 


7.13.3.1 Question 1 


What output is produced by the program shown in Listing 1 (p. 3199) ? 


A. Compiler Error 

B. Runtime Error 

C. Base A-intfcMethod 
D. None of the above. 


17This content is available online at <http://cnx.org/content /m45303/1.4/>. 
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Listing 1 . Listing for Question 1. 


public class Ap131if{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap131 


class Worker{ 
void doIt(){ 
Base myVari = new Base(); 
myVar1.inherMethod() ; 
X myVar2 = new A(); 
myVar2.intfcMethod() ; 


System.out.printlin("") ; 
}//end doItQ 
}// end class Worker 


class Basef{ 
public void inherMethod(){ 
System. out.print ("Base "); 
}//end inherMethod() 
}//end class Base 


class A extends Base{ 
public void inherMethod(){ 
System. out.print ( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethod(){ 
System.out.print("A-intfcMethod "); 
}//end intfcMethod() 
}//end class A 


interface X{ 
public void intfcMethod(); 
}//end X 


Table 7.171 


Answer and Explanation (p. 3231) 


7.13.3.2 Question 2 
What output is produced by the program shown in Listing 2 (p. 3200) ? 


e A. Compiler Error 
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e B. Runtime Error 
e C. A-inherMethod A-intfeMethod 
e D. None of the above. 


Listing 2 . Listing for Question 2. 


public class Ap132{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap132 


class Worker{ 
void doIt(){ 
Base myVari = new Base(); 
myVar1.inherMethod() ; 
Base myVar2 = new A(); 
myVar2.intfcMethod() ; 


System.out.println(""); 
}//end doItQ 
}// end class Worker 


class Basef{ 
public void inherMethod(){ 
System. out.print ("Base "); 
}//end inherMethod() 
}//end class Base 


class A extends Base implements X{ 
public void inherMethod(){ 
System. out.print ( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethod(){ 
System. out.print("A-intfcMethod "); 
}//end intfcMethod() 
}//end class A 


interface X{ 
public void intfcMethod(); 
}//end X 


Table 7.172 


Answer and Explanation (p. 3230) 
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7.13.3.3 Question 3 


What output is produced by the program shown in Listing 3 (p. 3201) ? 


A. Compiler Error 

B. Runtime Error 

C. Base A-intfcMethod 
D. None of the above. 


Listing 3 . Listing for Question 3. 


public class Ap133{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap133 


class Worker{ 
void doIt(){ 
Base myVari = new Base(); 
myVar1.inherMethod() ; 
A myVar2 = new AQ); 
myVar2.intfcMethod() ; 


System.out.println(""); 
}//end doItQ 
}// end class Worker 


class Basef{ 
public void inherMethod(){ 
System. out.print ("Base "); 
}//end inherMethod() 
}//end class Base 


class A extends Base implements X{ 
public void inherMethod(){ 
System. out. print ( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethod(){ 
System. out.print("A-intfcMethod "); 
}//end intfcMethod() 
}//end class A 


interface X{ 
public void intfcMethod(); 
}//end X 
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Table 7.173 


Answer and Explanation (p. 3228) 


7.13.3.4 Question 4 


What output is produced by the program shown in Listing 4 (p. 3203) ? 


A. Compiler Error 

B. Runtime Error 

C. Base A-intfcMethod 
D. None of the above. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3194 CHAPTER 7. OOP SELF-ASSESSMENT 


Listing 4 . Listing for Question 4. 


public class Ap134{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap134 


class Worker{ 
void doIt(){ 
Base myVari = new Base(); 
myVar1.inherMethod() ; 
X myVar2 = new A(); 
myVar2.intfcMethod() ; 


System.out.println(""); 
}//end doItQ 
}// end class Worker 


class Basef{ 
public void inherMethod(){ 
System. out.print ("Base "); 
}//end inherMethod() 
}//end class Base 


class A extends Base implements X{ 
public void inherMethod(){ 
System. out.print ( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethod(){ 
System.out.print("A-intfcMethod "); 
}//end intfcMethod() 
}//end class A 


interface X{ 
public void intfcMethod(); 
}//end X 


Table 7.174 


Answer and Explanation (p. 3227) 


7.13.3.5 Question 5 


What output is produced by the program shown in Listing 5 (p. 3205) ? 


e A. Compiler Error 
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e B. Runtime Error 
e C. A-intfeMethodX B-intfeMethodX 
e D. None of the above. 
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Listing 5 . Listing for Question 5. 


public class Ap135{ 
public static void main( 
String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Ap135 


class Worker{ 
void doIt(){ 
X myVari = new AQ); 
myVari.intfcMethodX() ; 
X myVar2 = new B(); 
myVar2.intfcMethodX() ; 


System.out.printin(""); 
}//end doItQ 
}// end class Worker 


class Basef{ 
public void inherMethod(){ 
System. out.print ("Base "); 
}//end inherMethod() 
}//end class Base 


class A extends Base implements X{ 
public void inherMethod(){ 
System. out.print ( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethodXx()f{ 
System. out.print ( 
"A-intfcMethodX "); 
}//end intfcMethodX() 
}//end class A 


class B extends Base implements X{ 
public void inherMethod(){ 
System. out. print ( 
" B-inherMethod "); 
}//end inherMethod() 


public void intfcMethodXx(){ 
System. out.print ( 
"B-intfcMethodX "); 
}//end intfcMethodXx() 
}//end class B 


interface X{ 
public void int{cMethodX () ; 
}//end X 
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Table 7.175 


Answer and Explanation (p. 3224) 


7.13.3.6 Question 6 


What output is produced by the program shown in Listing 6 (p. 3207) ? 


A. Compiler Error 

B. Runtime Error 

C. A-intfeMethodX B-intfeMethodX 
D. None of the above. 
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Listing 6 . Listing for Question 6. 


public class Ap136{ 
public static void main( 
String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Ap136 


class Worker{ 
void doIt(){ 
Object[] myArray = new Object[2]; 
myArray[0] = new A(); 
myArray[1] = new BQ); 


for(int i=0;i<myArray.length;i++){ 
myArray[i] .intfcMethodX() ; 
}//end for loop 


System. out.printin("") ; 
}//end doItQ 
}// end class Worker 


class Basef{ 
public void inherMethod(){ 
System. out.print ("Base "); 
}//end inherMethod() 
}//end class Base 


class A extends Base implements X{ 
public void inherMethod(){ 
System. out. print ( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethodXx(){ 
System. out.print ( 
"A-intfcMethodX "); 
}//end intfcMethodX() 
}//end class A 


class B extends Base implements X{ 
public void inherMethod(){ 
System. out.print ( 
" B-inherMethod "); 
3//end inherMethod() 


public void intfcMethodXx() { 
System. out.print ( 
"B-intfcMethodX "); 
}//end intfcMethodX() 
}//end class B 


interface X{ 
public void intfcMethodX() ; 
}//end X 
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Table 7.176 


Answer and Explanation (p. 3221) 


7.13.3.7 Question 7 
What output is produced by the program shown in Listing 7 (p. 3209) ? 


A. Compiler Error 

B. Runtime Error 

C. A-intfeMethodX B-intfeMethodX 
D. None of the above. 
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Listing 7 . Listing for Question 7. 


public class Ap137{ 
public static void main( 
String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Ap137 


class Worker{ 
void doIt(){ 
Object[] myArray = new Object[2]; 
myArray[0] = new A(); 
myArray[1] = new BQ); 


for(int i=0;i<myArray.length;i++){ 
((X) myArray[i]) .intfcMethodX() ; 
}//end for loop 


System.out.printin("") ; 
}//end doItQ 
}// end class Worker 


class Basef{ 
public void inherMethod(){ 
System. out.print ("Base "); 
}//end inherMethod() 
}//end class Base 


class A extends Base implements X{ 
public void inherMethod(){ 
System. out. print ( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethodXx(){ 
System. out.print ( 
"A-intfcMethodX "); 
}//end intfcMethodX() 
}//end class A 


class B extends Base implements X{ 
public void inherMethod(){ 
System. out.print ( 
" B-inherMethod "); 
3//end inherMethod() 


public void intfcMethodXx() { 
System. out.print ( 
"B-intfcMethodX "); 
}//end intfcMethodX() 
}//end class B 


interface X{ 
public void intfcMethodX() ; 
}//end X 
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Table 7.177 


Answer and Explanation (p. 3220) 


7.13.3.8 Question 8 


What output is produced by the program shown in Listing 8 (p. 3211) ? 


A. Compiler Error 

B. Runtime Error 

C. A-intfeMethodX B-intfeMethodX 
D. None of the above. 
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Listing 8 . Listing for Question 8. 


public class Ap138{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap138 


class Worker{ 
void doIt(){ 
X[] myArray = new X[2]; 
myArray[0] = new A(); 
myArray[1] = new BQ); 


for(int i=0;i<myArray.length;it++){ 
myArray[i] .intfcMethodX() ; 
}//end for loop 


System. out.printin("") ; 
}//end doItQ 
}// end class Worker 


class Basef{ 
public void inherMethod(){ 
System. out.print ("Base "); 
}//end inherMethod() 
}//end class Base 


class A extends Base implements X{ 
public void inherMethod(){ 
System. out. print ( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethodXx(){ 
System. out.print ( 
"A-intfcMethodX "); 
}//end intfcMethodX() 
}//end class A 


class B extends Base implements X{ 
public void inherMethod(){ 
System. out.print ( 
" B-inherMethod "); 
3//end inherMethod() 


public void intfcMethodXx() { 
System. out.print ( 
"B-intfcMethodX "); 
}//end intfcMethodX() 
}//end class B 


interface X{ 
public void intfcMethodX() ; 
}//end X 
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Table 7.178 


Answer and Explanation (p. 3219) 


7.13.3.9 Question 9 


What output is produced by the program shown in Listing 9 (p. 3213) ? 


A. Compiler Error 

B. Runtime Error 

C. Base A B 

D. None of the above. 
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Listing 9 . Listing for Question 9. 


public class Ap139{ 
public static void main( 
String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Ap139 


class Worker{ 
void doIt(){ 
Base myVar = new Base(); 
myVar.test(); 
myVar = new A(); 
myVar.test(); 
myVar = new B(); 
myVar.test(); 
System. out .println(""); 
}//end doIt() 
}// end class Worker 


class Base{ 
public void test(){ 
System. out.print ("Base "); 
}//end test() 
}//end class Base 


class A extends Base implements X,Y{ 
public void test(){ 
System.out.print("A "); 
}//end test() 
}//end class A 


class B extends Base implements X,Y{ 
public void test(){ 
System.out.print("B "); 
}//end test() 
}//end class B 


interface X{ 
public void test(); 
}//end X 


interface Y{ 
public void test(); 
}//end Y 


Table 7.179 


Answer and Explanation (p. 3217) 
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7.13.3.10 Question 10 


What output is produced by the program shown in Listing 10 (p. 3215) ? 


A. Compiler Error 

B. Runtime Error 

C. Base ABB 

D. None of the above. 
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Listing 10 . Listing for Question 10. 


public class Ap140f{ 
public static void main( 
String args[]){ 
new Worker().doIt(); 
}//end main() 
}//end class Ap140 


class Worker{ 
void doIt(){ 

Base myVari = new Base(); 
myVari.test(); 
myVar1 = new A(); 
myVari.test(); 
myVar1 = new B(); 
myVari.test(); 


X myVar2 = (X)myVar1; 
myVar2.test(); 


System.out.println("") ; 
}//end doItQ 
}// end class Worker 


class Base{ 
public void test(){ 
System. out.print ("Base "); 
}//end test() 
}//end class Base 


class A extends Base implements X,Y{ 
public void test(){ 
System.out.print("A "); 
}//end test() 
}//end class A 


class B extends Base implements X,Y{ 
public void test(){ 
System.out.print("B "); 
}//end test() 
}//end class B 


interface X{ 
public void test(); 
}//end X 


interface Y{ 
public void test(); 
}//end Y 
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Answer and Explanation (p. 3216) 


7.13.4 Listings 
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I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


Listing 1 (p. 3199) . Listing for Question 1. 
Listing 2 (p. 3200) . Listing for Question 2. 
Listing 3 (p. 3201) . Listing for Question 3. 


( ) 

( ) 

( ) 

Listing 4 (p. 3203) . Listing for Question 4. 
Listing 5 (p. 3205) . Listing for Question 5. 
Listing 6 (p. 3207) . Listing for Question 6. 
Listing 7 (p. 3209) . Listing for Question 7. 
Listing 8 (p. 3211) . Listing for Question 8. 
Listing 9 (p. 3213) . Listing for Question 9. 
Listing 10 (p. 3215) . Listing for Question 10. 


7.13.5 Miscellaneous 


This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Ap0120: Self-assessment, Interfaces and polymorphic behavior 
e File: Ap0120.htm 

e Originally published: 2004 

e Published at cnx.org: 12/08/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.13.6 Answers 
7.13.6.1 Answer 10 
C. Base ABB 
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7.13.6.1.1 Explanation 10 


Expansion of the program from Question 9 (p. 3212) 

The class and interface definitions for the classes and interfaces named Base 
Y are the same as in Question 9 (p. 3212) . 

Call the test method differently 

However, the call of the method named test in the object instantiated from the class named B is 
somewhat different. The difference is identified by the code in the following fragment. 


s 


void doIt(){ 
Base myVari = new Base(); 
myVari.test(); 
myVari = new A(); 
myVari.test(); 
myVari = new B(); 
myVari.test(); 


X myVar2 = (X)myVar1i; 
myVar2.test(); 


System.out.printin("") ; 
}//end doIt() 


Calling test method on Base-type reference 

In Question 9 (p. 3212) , and in the above code fragment as well, the method named test was called 
on each of the objects using a reference stored in a reference variable of type Base 

Calling the overridden version of test method 

This might be thought of as calling the overridden version of the method, through polymorphism, without 
regard for anything having to do with the interfaces. 

Calling test method on interface-type reference 

Then the code shown above calls the same method named test on one of the same objects using a 
reference variable of the interface type X 

Only one test method in each object 

Keep in mind that each object defines only one method named test . This single method serves the 
dual purpose of overriding the method having the same signature from the superclass, and implementing a 
method with the same signature declared in each of the interfaces. 

Implementing the interface method 

Perhaps when the same method is called using a reference variable of the interface type, it might be 
thought of as implementing the interface method rather than overriding the method defined in the superclass. 
You can be the judge of that. 

The same method is called regardless of reference type 

In any event, in this program, the same method is called whether it is called using a reference variable 
of the superclass type, or using a reference variable of the interface type. 

Illustrates the behavior of signature collisions 

The purpose of this and Question 9 (p. 3212) is not necessarily to illustrate a useful inheritance and 
implementation construct. Rather, these two questions are intended to illustrate the behavior of Java for 
the case of duplicated superclass and interface method signatures. 

Back to Question 10 (p. 3214) 


7.13.6.2 Answer 9 
C. Base A B 
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7.13.6.2.1 Explanation 9 


A question regarding signature collisions 

The question often arises in my classroom as to what will happen if a class inherits a method with a given 
signature and also implements one or more interfaces that declare a method with an identical signature. 

The answer 

The answer is that nothing bad happens, as long as the class provides a concrete definition for a method 
having that signature. 

Only one method definition is allowed 

Of course, only one definition can be provided for any given method signature, so that definition must 
satisfy the needs of overriding the inherited method as well as the needs of implementing the interfaces. 

An example of signature collisions 

The following fragment defines a class named Base that defines a method named test . The code 
also defines two interfaces named X and Y , each of which declares a method named test with an 
identical signature. 


class Base{ 
public void testQf{ 
System.out.print("Base "); 
}//end test () 
}//end class Base 


interface X{ 
public void test(); 
}//end X 


interface Y{ 
public void test(); 
}//end Y 


class A extends Base implements X,Y{ 
public void test(){ 
System.out.print("A "); 
}//end test() 
}//end class A 


Classes A and B extend Base and implement X and Y 

The code in the following fragment defines two classes, named A and B , each of which extends Base 
, and each of which implements both interfaces X and Y . Each class provides a concrete definition for 
the method named test , with each class providing a different definition. 


class A extends Base implements X,Y{ 
public void test(){ 
System.out.print("A "); 
}//end test() 
}//end class A 


class B extends Base implements X,Y{ 
public void test(){ 
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System.out.print("B "); 
}//end test () 
}//end class B 


Override inherited method and define interface method 

Each of the methods named test in the above fragment serves not only to override the method inherited 
from the class named Base , but also to satisfy the requirement to define the methods declared in the 
implemented interfaces named X and Y . (This can also be thought of as overriding an inherited abstract 
method from an interface.) 

Store object’s references as type Base and call test method 

Finally, the code in the following fragment declares a reference variable of the type Base . Objects 
respectively of the classes Base , A ,and B are instantiated and stored in the reference variable. Then 
the method named test is called on each of the references in turn. 


void doIt(){ 
Base myVar = new Base(); 
myVar.test(); 
myVar = new A(); 
myVar.test() ; 
myVar = new B(); 
myVar.test(); 
System.out.printin("") ; 
}//end doIt() 
}// end class Worker 


As you probably expected, this causes the following text to appear on the screen: 


Base AB 


Back to Question 9 (p. 3212) 


7.13.6.3 Answer 8 
C. A-intfeMethodX B-intfeMethodX 


7.13.6.3.1 Explanation 8 


Similar to previous two programs 

This program is very similar to the programs in Question 6 (p. 3206) and Question 7 (p. 3208) . The 
program is Question 6 (p. 3206) exposed a specific type mismatch problem. The program in Question 7 (p. 
3208) provided one solution to the problem. 

A different solution 

The following fragment illustrates a different solution to the problem. 


void doIt(){ 
X[] myArray = new X[2]; 
myArray[0] = new AQ); 
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myArray[1] = new BQ); 


for(int i=0;i<myArray.length;i++){ 
myArray [i] .intfcMethodX() ; 
}//end for loop 


System.out.printin("") ; 
}//end doIt() 


An array object of the interface type 

In this case, rather than to declare the array object to be of type Object , the array is declared to be 
of the interface type X 

This is a less generic container than the one declared to be of type Object . Only references to objects 
instantiated from classes that implement the X interface, or objects instantiated from subclasses of those 
classes can be stored in the container. However, this is often adequate. 

What methods can be called? 

Since the references are stored as the interface type, any method declared in or inherited into the interface 
can be called on the references stored in the container. Of course, the objects referred to by those references 
must provide concrete definitions of those methods or the program won’t compile. 

(Although it isn’t implicitly obvious, it is also possible to call any of the eleven methods defined in the 
Object class on an object’s reference being stored as an interface type. Those eleven methods can be 
called on any object, including array objects, regardless of how the references are stored.) 
Not the standard approach 

If you are defining your own container, this is a satisfactory approach to implementation of the observer 
design pattern. However, you cannot use this approach when using containers from the standard collections 
framework, because those containers are designed to always store references as the generic type Object 
In those cases, the casting solution of Question 7 (p. 3208) (or the use of generics) is required. 

Back to Question 8 (p. 3210) 


7.13.6.4 Answer 7 
C. A-intfeMethodX B-intfeMethodX 


7.13.6.4.1 Explanation 7 


The correct use of an interface 
This program illustrates the correct use of an interface. It uses a cast of the interface type in the following 
fragment to resolve the problem that was discussed at length in Question 6 (p. 3206) earlier. 


void doIt(){ 
Object[] myArray = new Object[2]; 
myArray[0] = new A(); 
myArray[1] = new BQ); 


for(int i=0;i<myArray.length;i++){ 


((X)myArray[i]) .intfcMethodX() ; 
}//end for loop 


System.out.printin("") ; 
}//end doIt() 


Back to Question 7 (p. 3208) 
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7.13.6.5 Answer 6 


A. Compiler Error 


7.13.6.5.1 Explanation 6 


What is a container? 

The word container is often used in Java, with at least two different meaning. One meaning is to refer 
to the type of an object that is instantiated from a subclass of the class named Container . In that case, 
the object can be considered to be of type Container , and typically appears in a graphical user interface 

(GUI) . That is not the usage of the word in the explanation of this program. 
A more generic meaning 

In this explanation, the word container has a more generic meaning. It is common to store a collection 
of object references in some sort of Java container, such as an array object or a Vector object. In fact, 
there is a complete collections framework provided to facilitate that sort of thing ( Vector is one of the 
concrete classes in the Java Collections Framework) . 

Storing references as type Object 

It is also common to declare the type of references stored in the container to be of the class Object 
Because Object is a completely generic type, this means that a reference to any object instantiated from 
any class (or any array object) can be stored in the container. The standard containers such as Vector 
and Hashtable take this approach. 

(Note that this topic became a little more complicated with the release of generics in jdk version 1.5.) 
A class named Base and an interface named X 

In a manner similar to several previous programs, this program defines a class named Base and an 

interface named X as shown in the following fragment. 


class Basef{ 
public void inherMethod(){ 
System.out.print("Base "); 
}//end inherMethod() 
}//end class Base 


interface X{ 
public void intfcMethodX() ; 
}//end X 


Classes A and B extend Base and implement X 

Also similar to previous programs, this program defines two classes named A and B . Each of these 
classes extends the class named Base and implements the interface named X , as shown in the next 
fragment. 


class A extends Base implements X{ 
public void inherMethod(){ 
System. out .print( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethodX(){ 
System. out .print( 
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"A-intfcMethodX "); 
}//end intfcMethodX () 
}//end class A 


class B extends Base implements X{ 
public void inherMethod(){ 
System. out.print( 
" B-inherMethod "); 
}//end inherMethod() 


public void intfcMethodX(){ 
System. out.print ( 
"B-intfcMethodX "); 
}//end intfcMethodX() 
}//end class B 


Concrete definitions of the interface method 

As before, these methods provide concrete definitions of the method named intfcMethodX , which is 
declared in the interface named X 

An array of references of type Object 

The interesting portion of this program begins in the following fragment, which instantiates and populates 
a two-element array object (container) of type Object . (In the sense of this discussion, an array object 
is a container, albeit a very simple one.) 


void doIt(){ 
Object[] myArray = new Object [2]; 
myArray[0] = new A(); 
myArray[1] = new BQ); 


Store object references of type A and B as type Object 
Because the container is declared to be of type Object , references to objects instantiated from any 
class can be stored in the container. The code in the above fragment instantiates two objects, (one of class 
A and the other of class B ), and stores the two object’s references in the container. 
Cannot call interface method as type Object 
The code in the for loop in the next fragment attempts to call the method named intfeMethodX 
on each of the two objects whose references are stored in the elements of the array. 


for(int i=0;i<myArray.length;i++){ 
myArray [i] .intfcMethodX() ; 
}//end for loop 


System.out.printin(""); 
}//end doIt() 


This produces the following compiler error under JDK 1.3: 
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Ap136.java:24: cannot resolve symbol 
symbol : method intfcMethodX () 
location: class java.lang.Object 


myArray [i] .intfcMethodX() ; 


What methods can you call as type Object? 

It is allowable to store the reference to an object instantiated from any class in a container of the type 
Object . However, the only methods that can be directly called (without a cast and not using generics) 
on that reference are the following eleven methods. These methods are defined in the class named Object 


e clone () 

e equals(Object obj) 
e finalize() 

e getClass() 

e hashCode() 

e notify() 

e notifyAll() 

e toString() 

e wait() 

e wait(long timeout) 
e wait(long timeout,int nanos) 


Overridden methods 

Some, (but not all) , of the methods in the above list are defined with default behavior in the Object 
class, and are meant to be overridden in new classes that you define. This includes the methods named 
equals and toString 

Some of the methods in the above list, such as getClass , are simply utility methods, which are not 
meant to be overridden. 

Polymorphic behavior applies 

If you call one of these methods on an object’s reference (being stored as type Object) , polymorphic 
behavior will apply. The version of the method overridden in, or inherited into, the class from which the 
object was instantiated will be identified and executed. 

Otherwise, a cast is required 

In order to call any method other than one of the eleven methods in the above list (p. 3223) , (on an 
object’s reference being stored as type Object without using generics) , you must cast the reference to 
some other type. 

Casting to an interface type 

The exact manner in which you write the cast will differ from one situation to the next. In this case, the 
problem can be resolved by rewriting the program using the interface cast shown in the following fragment. 


void doIt(){ 
Object[] myArray = new Object[2]; 
myArray[0] = new AQ); 
myArray[1] = new BQ); 


for(int i=0;i<myArray.length;i++){ 


((X)myArray[i]) .intfcMethodX() ; 
}//end for loop 
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System.out.printin("") ; 
}//end doIt() 


The observer design pattern 

By implementing an interface, and using a cast such as this, you can store references to many different 
objects, of many different actual types, each of which implements the same interface, but which have no 
required superclass-subclass relationship, in the same container. Then, when needed, you can call the 
interface methods on any of the objects whose references are stored in the container. 

This is a commonly used design pattern in Java, often referred to as the observer design pattern. 

Registration of observers 

With this design pattern, none, one, or more observer objects, (which implement a common observer 
interface) are registered on an observable object. This means references to the observer objects are stored 
in a container by the observable object. 

Making a callback 

When the observable object determines that some interesting event has occurred, the observable object 
calls a specific interface method on each of the observer objects whose references are stored in the container. 

The observer objects execute whatever behavior they were designed to execute as a result of having been 
notified of the event. 

The model-view-control (MVC) paradigm 

In fact, there is a class named Observable and an interface named Observer in the standard Java 
library. The purpose of these class and interface definitions is to make it easy to implement the observer 
design pattern. 

(The Observer interface and the Observable class are often used to implement a programming style 
commonly referred to as the MVC paradigm.) 
Delegation event model, bound properties of Beans, etc. 

Java also provides other tools for implementing the observer design pattern under more specific circum- 
stances, such as the Delegation Event Model, and in conjunction with bound and constrained properties in 
JavaBeans Components. 

Back to Question 6 (p. 3206) 


7.13.6.6 Answer 5 
C. A-intfeMethodX B-intfeMethodX 


7.13.6.6.1 Explanation 5 


More substantive use of an interface 

This program illustrates a more substantive use of the interface than was the case in the previous pro- 
grams. 

The class named Base 

The program defines a class named Base as shown in the following fragment. 


class Basef{ 
public void inherMethod(){ 
System.out.print("Base "); 
}//end inherMethod() 
}//end class Base 
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The interface named X 
The program also defines an interface named X as shown in the next fragment. Note that this interface 
declares a method named intfeMethodX 


interface X{ 
public void intfcMethodX() ; 
}//end X 


Class A extends Base and implements X 
The next fragment shows the definition of a class named A that extends Base and implements X 


class A extends Base implements X{ 
public void inherMethod(){ 
System. out .print( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethodX(){ 
System. out .print( 
"A-intfcMethodX "); 
}//end intfcMethodX () 
}//end class A 


Defining interface method 

Because the class named A implements the interface named X ,it must provide a concrete definition 
of all the methods declared in X 

In this case, there is only one such method. That method is named intfeMethodX . A concrete 
definition for the method is provided in the class named A 

Class B also extends Base and implements X 

The next fragment shows the definition of another class (named B ), which also extends Base and 
implements X 


class B extends Base implements X{ 
public void inherMethod(){ 
System. out .print( 
" B-inherMethod "); 
}//end inherMethod() 


public void intfcMethodX(){ 
System. out .print( 
"B-intfcMethodX "); 
}//end intfcMethodX() 
}//end class B 


Defining the interface method 
Because this class also implements X , it must also provide a concrete definition of the method named 


intfeMethodX 
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Different behavior for interface method 

However (and this is extremely important) , there is no requirement for this definition of the method to 
match the definition in the class named A , or to match the definition in any other class that implements 
X 

Only the method signature for the method named intfcMethodX is necessarily common among all 
the classes that implement the interface. 

The definition of the method named intfcMethodX in the class named A is different from the 
definition of the method having the same name in the class named B 

The interesting behavior 

The interesting behavior of this program is illustrated by the code in the following fragment. 


void doIt(){ 
X myVar1 = new A(); 
myVari.intfcMethodX() ; 
X myVar2 = new B(); 
myVar2.intfcMethodX() ; 


System.out.printin("") ; 
}//end doIt() 


Store object’s references as interface type X 

The code in the above fragment causes one object to be instantiated from the class named A , and 
another object to be instantiated from the class named B 

The two object’s references are stored in two different reference variables, each declared to be of the type 
of the interface X 

Call the interface method on each reference 

A method named intfeMethodX is called on each of the reference variables. Despite the fact that 
both object’s references are stored as type X , the system selects and calls the appropriate method, (as 
defined by the class from which each object was instantiated) , on each of the objects. This causes the 
following text to appear on the screen: 


A-intfcMethodX B-intfcMethodX 


No subclass-superclass relationship exists 

Thus, the use of an interface makes it possible to call methods having the same signatures on objects 
instantiated from different classes, without any requirement for a subclass-superclass relationship to exist 
among the classes involved. 

In this case, the only subclass-superclass relationship between the classes named A and B was that 
they were both subclasses of the same superclass. Even that relationship was established for convenience, 
and was not a requirement. 

Different behavior of interface methods 

The methods having the same signature, (declared in the common interface, and defined in the classes) 

, need not have any similarity in terms of behavior. 
A new interface relationship 

The fact that both classes implemented the interface named X created a new relationship among the 
classes, which is not based on class inheritance. 

Back to Question 5 (p. 3203) 
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7.13.6.7 Answer 4 
C. Base A-intfeMethod 


7.13.6.7.1 Explanation 4 


Illustrates the use of an interface as a type 
The program defines a class named Base , and a class named A , which extends Base 
implements an interface named X , as shown below. 


and 


3 


class Base{ 
public void inherMethod(){ 
System.out.print("Base "); 
}//end inherMethod() 
}//end class Base 


class A extends Base implements X{ 
public void inherMethod(){ 
System. out.print( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethod(){ 
System.out.print("A-intfcMethod "); 
}//end intfcMethod() 
}//end class A 


interface X{ 
public void intfcMethod(); 
}//end X 


Implementing interfaces 

A class may implement none, one, or more interfaces. 

The cardinal rule on interfaces 

If a class implements one or more interfaces, that class must either be declared abstract, or it must provide 
concrete definitions of all methods declared in and inherited into all of the interfaces that it implements. If 
the class is declared abstract, its subclasses must provide concrete definitions of the interface methods. 

A concrete definition of an interface method 

The interface named X in this program declares a method named intfeMethod . The class named 
A provides a concrete definition of that method. 

(The minimum requirement for a concrete definition is a method that matches the method signature 
and has an empty body.) 

Storing object’s reference as an interface type 

The interesting part of the program is shown in the following code fragment. 


void doIt(){ 
Base myVari = new Base(); 
myVari.inherMethod() ; 
X myVar2 = new A(); 
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myVar2.intfcMethod(); 


System.out.printin(""); 
}//end doIt() 


The above fragment instantiates a new object of the class named A , and saves a reference to that object 
in a reference variable of the declared type X 

How many ways can you save an object’s reference? 

Recall that a reference to an object can be held by a reference variable whose type matches any of the 
following: 


The class from which the object was instantiated. 

Any superclass of the class from which the object was instantiated. 

Any interface implemented by the class from which the object was instantiated. 

Any interface implemented by any superclass of the class from which the object was instantiated. 
Any superinterface of the interfaces mentioned above. 


Save object’s reference as implemented interface type 

In this program, the type of the reference variable matches the interface named X , which is implemented 

by the class named A 
What does this allow you to do? 

When a reference to an object is held by a reference variable whose type matches an interface implemented 
by the class from which the object was instantiated, that reference can be used to call any method declared 
in or inherited into that interface. 

(That reference cannot be used to call methods not declared in or not inherited into that interface.) 
In this simple case ... 

The method named intfeMethod is declared in the interface named X and implemented in the class 
named A 

Therefore, the method named intfeMethod can be called on an object instantiated from the class 
named A when the reference to the object is held in a reference variable of the interface type. 

(The method could also be called if the reference is being held in a reference variable of declared type 
A.) 

The call to the method named intfceMethod causes the text A-intfeMethod to appear on the 
screen. 

Back to Question 4 (p. 3202) 


7.13.6.8 Answer 3 
C. Base A-intfeMethod 


7.13.6.8.1 Explanation 3 


What is runtime polymorphic behavior? 
One way to describe runtime polymorphic behavior is: 

The runtime system selects among two or more methods having the same signature, not on the basis of 
the type of the reference variable in which an object’s reference is stored, but rather on the basis of the class 
from which the object was originally instantiated. 

Illustrates simple class and interface inheritance 

The program defines a class named Base , and a class named A 
implements the interface named X , as shown in the following fragment. 


which extends Base and 


bi 3 
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class Basef 
public void inherMethod(){ 
System.out.print("Base "); 
}//end inherMethod() 
}//end class Base 


class A extends Base implements X{ 
public void inherMethod(){ 
System. out .print( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethod(){ 
System.out.print("A-intfcMethod "); 
}//end intfcMethod() 
}//end class A 


interface X{ 
public void intfcMethod() ; 
}//end X 


Define an interface method 

The interface named X declares a method named intfeMethod . A concrete definition of that 
method is defined in the class named A 

A new object of type Base 

The code in the following fragment instantiates a new object of the class Base and calls its inher- 
Method . This causes the word Base to appear on the output screen. There is nothing special about 
this. This is a simple example of the use of an object’s reference to call one of its instance methods. 


void doIt(){ 
Base myVari = new Base(); 
myVari.inherMethod() ; 


A new object of type A 

The following fragment instantiates a new object of the class A and calls its intfeMethod . This 
causes the text A-intfeMethod to appear on the output screen. There is also nothing special about this. 
This is also a simple example of the use of an object’s reference to call one of its instance methods. 


A myVar2 = new A(); 
myVar2.intfcMethod() ; 


System.out.printin("") ; 
}//end doIt() 


Not polymorphic behavior 
The fact that the class named A implements the interface named X does not indicate polymorphic 
behavior in this case. Rather, this program is an example of simple class and interface inheritance. 
Interface type is not used 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3221 


The program makes no use of the interface as a type, and exhibits no polymorphic behavior (no decision 
among methods having the same signature is required) . 

The class named A inherits an abstract method named intfeMethod from the interface and must 
define it. (Otherwise, it would be necessary to declare the class named A abstract.) 

The interface is not a particularly important player in this program. 

Back to Question 3 (p. 3201) 


7.13.6.9 Answer 2 


A. Compiler Error 


7.13.6.9.1 Explanation 2 


Simple hierarchical polymorphic behavior 
This program is designed to test your knowledge of simple hierarchical polymorphic behavior. 
Implement the interface named X 
This program defines a class named A that extends a class named Base , and implements an interface 
named X_, as shown in the following code fragment. 


class A extends Base implements X{ 
public void inherMethod(){ 
System. out.print ( 
" A-inherMethod "); 
}//end inherMethod() 


public void intfcMethod(){ 
System.out.print("A-intfcMethod "); 
}//end intfcMethod() 
}//end class A 


interface X{ 
public void intfcMethod(); 
}//end X 


Override and define some methods 

The class named A overrides the method named inherMethod , which it inherits from the class 
named Base . It also provides a concrete definition of the method named intfcMethod , which is 
declared in the interface named X 

Store object’s reference as superclass type 

The program instantiates an object of the class named A and assigns that object’s reference to a 
reference variable of type Base , as shown in the following code fragment. 


Base myVar2 = new A(); 
Oops! Cannot call this method 


So far, so good. However, the next fragment shows where the program turns sour. It attempts to call 
the method named intfeMethod on the object’s reference, which was stored as type Base 
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myVar2.intfcMethod() ; 


Polymorphic behavior doesn’t apply here 

Because the class named Base does not define the method named intfcMethod _, hierarchical 
polymorphic behavior does not apply. Therefore a reference to the object being stored as type Base 
cannot be used to directly call the method named intfeMethod , and the program produces a compiler 
error. 

What is the solution? 

Hierarchical polymorphic behavior is possible only when the class defining the type of the reference (or 
some superclass of that class) contains a definition for the method that is called on the reference. 

There are a couple of ways that downcasting could be used to solve the problem in this case. 

Back to Question 2 (p. 3199) 


7.13.6.10 Answer 1 


A. Compiler Error 


7.13.6.10.1 Explanation 1 


I put this question in here just to see if you are still awake. 

Can store reference as interface type 

A reference to an object instantiated from a class can be assigned to any reference variable whose 
declared type is the name of an interface implemented by the class from which the object was instantiated, 
or implemented by any superclass of that class. 

Define two classes and an interface 

This program defines a class named A that extends a class named Base . The class named Base 
extends Object by default. 

The program also defines an interface named X 

Instantiate an object 

The following statement instantiates an object of the class named A , and attempts to assign that 
object’s reference to a reference variable whose type is the interface type named X 


X myVar2 = new A(); 


Interface X is defined but not implemented 

None of the classes named A , Base , and Object implement the interface named X . Therefore, 
it is not allowable to assign a reference to an object of the class named A to a reference variable whose 
declared type is X . Therefore, the program produces the following compiler error under JDK 1.3: 


Ap131.java:20: incompatible types 
found TA 
required: X 

X myVar2 = new A(); 


Back to Question 1 (p. 3198) 
-end- 
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7.14 Ap0130: Self-assessment, Comparing objects, packages, import 
directives, and some common exceptions” 


7.14.1 Table of Contents 


e Preface (p. 3232) 
e Questions (p. 3232) 


1 (p. 3232) , 2 (p. 3233) , 3 (p. 3234) , 4 (p. 3235) , 5 (p. 3236) , 6 (p. 3237) , 7 (p. 3238) , 8 
(p. 3239) , 9 (p. 3240) , 10 (p. 3241) 


e Listings (p. 3241) 
e Miscellaneous (p. 3242) 
e Answers (p. 3242) 


7.14.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

The test consists of a series of questions with answers and explanations of the answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 3241) to easily find and view the listings while you are reading about them. 


7.14.3 Questions 
7.14.3.1 Question 1 


What output is produced by the program shown in Listing 1 (p. 3233) ? 


A. Compiler Error 

B. Runtime Error 

C. Joe Joe false 

D. Joe Joe true 

E. None of the above. 


18This content is available online at <http://cnx.org/content/m45310/1.6/>. 
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Listing 1 . Listing for Question 1. 


public class Ap14if{ 
public static void main( 
String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Ap141 


class Worker{ 
void doIt(){ 
char[] anArray = {’J’,’o’,’e’}; 
String Stri = new String(anArray) ; 
String Str2 = new String(anArray) ; 


System. out .print1n( 
Stri+ ""+Str2+" "+4 
(Stri == Str2)); 
}//end doItQ 
}// end class Worker 


Table 7.181 


Answer and Explanation (p. 3251) 


7.14.3.2 Question 2 


What output is produced by the program shown in Listing 2 (p. 3234) ? 


A. Compiler Error 

B. Runtime Error 

C. Joe Joe false 

D. Joe Joe true 

E. None of the above. 
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Listing 2 . Listing for Question 2. 


public class Ap142{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap142 


class Worker{ 
void doIt(){ 
char[] anArray = {’J’,’o’,’e’}; 
String Stri = new String(anArray) ; 
String Str2 = new String(anArray) ; 


System. out .print1n( 
Stri + woot + Str2 + woot + 
Str1.equals(Str2)); 
}//end doIt() 
}// end class Worker 


Table 7.182 


Answer and Explanation (p. 3250) 


7.14.3.3 Question 3 


What output is produced by the program shown in Listing 3 (p. 3235) ? 


A. Compiler Error 
B. Runtime Error 
C. ABC DEF GHI 
D. None of the above. 
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Listing 3 . Listing for Question 3. 


public class Ap143{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap143 


class Worker{ 
void doIt(){ 
java.util.ArrayList ref = 
new java.util.ArrayList (1); 
ref .add("ABC "); 
ref.add("DEF "); 
ref .add("GHI") ; 


System. out .print1n( 
(String)ref.get(0) + 
(String)ref.get(1) + 
(String) ref.get(2)); 
}//end doIt() 
}// end class Worker 


Table 7.183 


Answer and Explanation (p. 3248) 


7.14.3.4 Question 4 


What output is produced by the program shown in Listing 4 (p. 3236) ? 


A. Compiler Error 
B. Runtime Error 
C. ABC DEF GHI 
D. None of the above. 
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Listing 4 . Listing for Question 4. 


public class Ap144{ 
public static void main( 
String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Ap144 


class Worker{ 
void doIt(){ 
ArrayList ref = 
new ArrayList (1); 
ref .add("ABC "); 
ref.add("DEF "); 
ref .add("GHI") ; 


System. out .print1n( 
(String)ref.get(0) + 
(String)ref.get(1) + 
(String) ref.get(2)); 
}//end doIt() 
}// end class Worker 


Table 7.184 


Answer and Explanation (p. 3247) 


7.14.3.5 Question 5 


What output is produced by the program shown in Listing 5 (p. 3237) ? 


A. Compiler Error 
B. Runtime Error 
C. ABC DEF GHI 
D. None of the above. 
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Listing 5 . Listing for Question 5. 


import java.util.ArrayList; 


public class Ap145{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap145 


class Worker{ 
void doIt(){ 
ArrayList ref = null; 
ref = new ArrayList (1); 
ref .add("ABC "); 
ref .add("DEF "); 
ref .add("GHI") ; 


System. out .print1n( 
(String)ref.get(0) + 
(String)ref.get(1) + 
(String) ref.get(2)); 
}//end doIt() 
}// end class Worker 


Table 7.185 


Answer and Explanation (p. 3246) 


7.14.3.6 Question 6 


What output is produced by the program shown in Listing 6 (p. 3238) ? 


A. Compiler Error 
B. Runtime Error 
C. ABC DEF GHI 
D. None of the above. 
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Listing 6 . Listing for Question 6. 


import java.util.ArrayList; 


public class Ap146{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap146 


class Worker{ 
void doItQf{ 
ArrayList ref = null; 
ref .add("ABC "); 
ref.add("DEF "); 
ref .add("GHI") ; 


System. out. print1n( 
(String)ref.get(0) + 
(String)ref.get(1) + 
(String)ref.get(2)); 
}//end doIt() 
}// end class Worker 


Table 7.186 


Answer and Explanation (p. 3245) 


7.14.3.7 Question 7 
What output is produced by the program shown in Listing 7 (p. 3239) ? 


A. Compiler Error 
B. Runtime Error 
C. ABC DEF GHI 
D. None of the above. 
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Listing 7 . Listing for Question 7. 


import java.util.ArrayList; 


public class Ap147{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap147 


class Worker{ 
void doIt(){ 
ArrayList ref = null; 
ref = new ArrayList (1); 
ref .add("ABC "); 
ref.add("DEF "); 


System. out .print1n( 
(String)ref.get(0) + 
(String)ref.get(1) + 
(String)ref.get(2)); 
}//end doIt() 
}// end class Worker 


Table 7.187 


Answer and Explanation (p. 3244) 


7.14.3.8 Question 8 


What output is produced by the program shown in Listing 8 (p. 3240) ? 


A. Compiler Error 

B. Runtime Error 

C. Infinity 

D. None of the above. 
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Listing 8 . Listing for Question 8. 


public class Ap148{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap148 


class Worker{ 
void doIt(){ 
System. out.println(1.0/0); 
}//end dolt() 
}// end class Worker 


Table 7.188 


Answer and Explanation (p. 3244) 


7.14.3.9 Question 9 


What output is produced by the program shown in Listing 9 (p. 3240) ? 


A. Compiler Error 

B. Runtime Error 

C. Infinity 

D. None of the above. 


Listing 9 . Listing for Question 9. 


public class Ap149f{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap149 


class Worker{ 
void doIt(){ 
System. out.print1n(1/0); 
}//end dolt() 
}// end class Worker 


Table 7.189 


Answer and Explanation (p. 3243) 
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7.14.3.10 Question 10 


What output is produced by the program shown in Listing 10 (p. 3241) ? 


A. Compiler Error 

B. Runtime Error 

C. AB CD EF 

D. None of the above. 


Listing 10 . Listing for Question 10. 


public class Ap150{ 
public static void main( 
String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Ap150 


class Worker{ 
void doIt(){ 
String[] ref = {"AB ","CD ","EF "}; 
for(int i = 0; i <= 3; i++){ 
System.out.print (ref [i]); 
}//end forloop 
System. out .println(""); 
}//end doIt() 
}// end class Worker 


Table 7.190 
Answer and Explanation (p. 3242) 


7.14.4 Listings 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


e Listing 1 (p. 3233) . Listing for Question 1. 
e Listing 2 (p. 3234) . Listing for Question 2. 
e Listing 3 (p. 3235) . Listing for Question 3. 
e Listing 4 (p. 3236) . Listing for Question 4. 
e Listing 5 (p. 3237) . Listing for Question 5. 
e Listing 6 (p. 3238) . Listing for Question 6. 
e Listing 7 (p. 3239) . Listing for Question 7. 
e Listing 8 (p. 3240) . Listing for Question 8. 
e Listing 9 (p. 3240) . Listing for Question 9. 
e Listing 10 (p. 3241) . Listing for Question 10. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3233 


7.14.5 Miscellaneous 


This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Ap0130: Self-assessment, Comparing objects, packages, import directives, and 
some common exceptions 

e File: Ap0130.htm 

e Originally published: 2004 

e Published at cnx.org: 12/18/12 

e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.14.6 Answers 
7.14.6.1 Answer 10 


Both of the following occur. 
C. AB CD EF 
B. Runtime Error 


7.14.6.1.1 Explanation 10 


Another index out of bounds 

This is another example of a program that throws an index out of bounds exception. In this case, since 
the container is an array object, the name of the exception is ArrayIndexOutOfBoundsException 

Populate a three-element array object 

The code in the following fragment creates and populates a three-element array object containing reference 
to three String objects. 


void doIt(){ 
String[] ref = {"AB ","CD ","EF "}; 


Access an out-of-bounds element 
The next fragment attempts to access elements at indices 0 through 3 inclusive. 
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for(int i = 0; i <= 3; i++){ 
System. out.print (ref [i]) ; 
}//end forloop 


Since index value 3 is outside the bounds of the array, the program throws the following exception and 
aborts: 


AB CD EF 
java.lang.ArrayIndexOutOfBoundsException 
at Worker.doIt(Ap150. java:22) 
at Ap150.main(Ap150. java:14) 


Note however that the program displays the contents of the three String objects referred to by the contents 
of the first three elements in the array before the problem occurs. 

That’s the way it often is with runtime errors. Often, a program will partially complete its task before 
getting into trouble and aborting with a runtime error. 

Back to Question 10 (p. 3241) 


7.14.6.2 Answer 9 


B. Runtime Error 


7.14.6.2.1 Explanation 9 


A setup 

If you feel like you’ve been had, chances are you have been had. The purpose for Question 8 (p. 3239) 
was to set you up for this question. 

Division by zero for integer types 

This program deals with the process of dividing by zero for imt types. The code in the following 
fragment divides the int value 1 by the int value 0. 


void doIt(){ 
System.out.println(1/0) ; 
}//end doIt() 


Not the same as double divide by zero 

However, unlike with type double , this process doesn’t return a very large value and continue running. 
Rather, for type int , attempting to divide by zero will result in a runtime error of type ArithmeticEx- 
ception that looks something like the following under JDK 1.3: 


java.lang.ArithmeticException: / by zero 
at Worker.doIt (Ap149. java: 20) 
at Ap149.main(Ap149.java:14) 


An exercise for the student 

I won’t attempt to explain the difference in behavior for essentially the same problem between type int 
and type double . As the old saying goes, I’ll leave that as an exercise for the student. 

Back to Question 9 (p. 3240) 
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7.14.6.3 Answer 8 
C. Infinity 


7.14.6.3.1 Explanation 8 


A double divide by zero operation 
This program deals with the process of dividing by zero for floating values of type double 
The following code fragment attempts to divide the double value 1.0 by the double value 0. 


void doIt(){ 
System.out.println(1.0/0); 
}//end doIt() 


The program runs successfully, producing the output Infinity 
What is Infinity? 
Suffice it to say that Infinity is a very large number. 
(Any value divided by zero is a very large number.) 
At this point, Pm not going to explain it further. If you are interested in learning what you can do with 
Infinity , see the language specifications. 
Back to Question 8 (p. 3239) 


7.14.6.4 Answer 7 


B. Runtime Error 


7.14.6.4.1 Explanation 7 


This program illustrates an IndexOutOfBounds exception. 
Instantiate and populate an ArrayList object 
By now, you will be familiar with the kind of container object that you get when you instantiate the 
ArrayList class. 
The code in the following fragment instantiates such a container, having an initial capacity of one element. 
Then it adds two elements to the container. Each element is a reference to an object of the class String 


void doIt(){ 
ArrayList ref = null; 
ref = new ArrayList(1); 
ref.add("ABC "); 
ref.add("DEF "); 


Increase capacity automatically 

Because two elements were successfully added to a container having an initial capacity of only one element, 
the container was forced to increase its capacity automatically. 

Following execution of the code in the above fragment, String object references were stored at index 
locations 0 and 1 in the ArrayList object. 

Get reference at index location 2 

The next fragment attempts to use the get method to fetch an element from the container at index 
value 2. 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3236 CHAPTER 7. OOP SELF-ASSESSMENT 


Index values in an ArrayList object begin with zero. Therefore, since only two elements were added 
to the container in the earlier fragment, there is no element at index value 2. 


System.out.print1n( 
(String)ref.get(0) + 
(String)ref.get(1) + 
(String) ref .get(2)); 


An IndexOutOfBounds exception 
As a result, the program throws an IndexOutOfBounds exception. The error produced under JDK 
1.3 looks something like the following: 


Exception in thread "main" java.lang. IndexOutOfBoundsException: 

Index: 2, Size: 2 
at java.util.ArrayList .RangeCheck 

(Unknown Source) 
at java.util.ArrayList.get 

(Unknown Source) 
at Worker .doIt (Ap147. java:27) 
at Ap147.main(Ap147.java:16) 


Attempting to access an element with a negative index value would produce the same result. 
An ArrayIndexOutOfBounds exception 
A similar result occurs if you attempt to access an element in an ordinary array object outside the bounds 
of the index values determined by the size of the array. However, in that case, the name of the exception is 
ArrayIndexOutOfBounds 
Back to Question 7 (p. 3238) 


7.14.6.5 Answer 6 


B. Runtime Error 


7.14.6.5.1 Explanation 6 


The infamous NullPointerException 

Interestingly, one of the first things that you read when you start reading Java books, is that there are 
no pointers in Java . It is likely that shortly thereafter when you begin writing, compiling, and executing 
simple Java programs, one of your programs will abort with an error message looking something like that 
shown below 


Exception in thread "main" java.lang.NullPointerException 
at 
Worker .doIt (Ap146. java: 23) 
at 
Ap146.main(Ap146. java: 16) 
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What is a NullPointerException? 

Stated simply, a NullPointerException occurs when you attempt to perform some operation on an 
object using a reference that doesn’t refer to an object. 

That is the case in this program 

The following code fragment declares a local reference variable and initializes its value to null 


void doIt(){ 
ArrayList ref = null; 


(A reference variable in Java must either refer to a valid object, or specifically refer to no object (null). 
Unlike a pointer in C and C++, a Java reference variable cannot refer to something arbitrary.) 
In this case, null means that the reference variable doesn’t refer to a valid object. 
No ArrayList object 
Note that the code in the above fragment does not instantiate an object of the class ArrayList and 
assign that object’s reference to the reference variable. 
(The reference variable doesn’t contain a reference to an object instantiated from the class named 
ArrayList , or an object instantiated from any class for that matter.) 
Call a method on the reference 
However, the code in the next fragment attempts to add a String object’s reference to a nonexistent 
ArrayList object by calling the add method on the reference containing null. 


ref.add("ABC "); 


This results in the NullPointerException shown earlier (p. 3245) . 

What can you do with a null reference? 

The only operation that you can perform on a reference variable containing null is to assign an object’s 
reference to the variable. Any other attempted operation will result in a NullPointerException 

Back to Question 6 (p. 3237) 
7.14.6.6 Answer 5 


C. ABC DEF GHI 
7.14.6.6.1 Explanation 5 
The purpose of this program is to 


e Continue to illustrate the use of java packages, and 
e Illustrate the use of the Java import directive. 


Program contains an import directive 
This program is the same as the program in Question 4 (p. 3235) with a major exception. Specifically, 
the program contains the import directive shown in the following fragment. 


import java.util.ArrayList; 
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A shortcut 

The designers of Java recognized that having to type a fully-qualified name for every reference to a class 
in a Java program can become burdensome. Therefore, they provided us with a shortcut that can be used, 
so long as we don’t need to refer to two or more class files having the same name. 

Import directives 

The shortcut is called an import directive. 

As can be seen above, the import directive consists of the word import followed by the fully-qualified 
name of a class file that will be used in the program. 

A program may have more than one import directive, with each import directive specifying the location 
of a different class file. 

The import directive(s) must appear before any class or interface definitions in the source code. 

The alternative wild-card syntax 

An alternative form of the import directive replaces the name of the class with an asterisk. 

The asterisk behaves as a wild-card character. It tells the compiler to use any class file that it finds in 
that package that matches a class reference in the source code. 

The wild-card form should be used with care, because it can sometimes cause the compiler to use a class 
file that is different from the one that you intended to use (if it finds the wrong one first) . 

Class file name collisions 

If your source code refers to two different class files having the same name, you must forego the use of 
the import directive and provide fully-qualified names for those class files. 

Back to Question 5 (p. 3236) 


7.14.6.7 Answer 4 
A. Compiler Error 


7.14.6.7.1 Explanation 4 


The purpose of this program is to continue to illustrate the use of java packages. 

No fully-qualified class names 

This program is the same as the program in Question 3 (p. 3234) with a major exception. Neither of the 
references to the ArrayList class use fully-qualified names in this program. Rather, the references are as 
shown in the following fragment. 


ArrayList ref = 
new ArrayList (1); 


Compiler errors 
As a result, the JDK 1.3 compiler produces two error messages similar to the following: 


Ap144.java:20: cannot resolve symbol 
symbol : class ArrayList 
location: class Worker 

ArrayList ref = 


Doesn’t know how to find the class file 

This error message indicates that the compiler didn’t know where to look on the disk to find the file 
named ArrayList.class 

Back to Question 4 (p. 3235) 
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7.14.6.8 Answer 3 
C. ABC DEF GHI 


7.14.6.8.1 Explanation 3 


Illustrate the use of java packages 

Since it was necessary to make use of a class to illustrate packages, this program also previews the use of 

the ArrayList class. We will be very interested in this class later when we study Java data containers. 
What is an ArrayList object? 

Some of this terminology may not make much sense to you at this point, but Pll go ahead and tell you 
anyway, just as a preview. 

According to Sun, the ArrayList class provides a 

"Resizable-array implementation of the List interface. Implements all optional list operations, and 
permits all elements, including null. In addition to implementing the List interface, this class provides 
methods to manipulate the size of the array that is used internally to store the list. (This class is roughly 
equivalent to Vector , except that it is unsynchronized.)" 

Stated more simply ... 

Stated more simply, an object of the ArrayList class can be used as a replacement for an array object. 
An ArrayList object knows how to increase its capacity on demand, whereas the capacity of a simple 
array object cannot change once it is instantiated. 

An ArrayList object 

The following statement instantiates a new object of the ArrayList class, with an initial capacity for 
one element. The initial capacity is determined by the int value passed to the constructor when the object 
is instantiated. 


java.util.ArrayList ref = 
new java.util.ArrayList (1); 


Back to the primary purpose ... 

Getting back to the primary purpose of this program, what is the meaning of the term java.util that 

appears ahead of the name of the class, ArrayList ? 
Avoiding name conflicts 

One of the age-old problems in computer programming has to do with the potential for name conflicts. 
The advent of OOP and reusable code didn’t cause that problem to go away. If anything, it made the 
problem worse. 

For example, you and I may work as programmers for separate companies named X and Y. A company 
named Z may purchase our two companies and attempt to merge the software that we have written separately. 
Given that there are only a finite number of meaningful class names, there is a good possibility that you and 
I may have defined different classes with the same names. Furthermore, it may prove useful to use both of 
the class definitions in a new program. 

Put class files in different directories 

Sun’s solution to the problem is to cause compiled class files to reside in different directories. Simplifying 
things somewhat, if your compiled file for a class named Joe is placed in a directory named X , and 
my compiled file for a different class named Joe is placed in a directory named Y , then source code in 
the same Java program can refer to those two class files as X.Joe and Y.Joe . This scheme makes it 
possible for the Java compiler and the Java virtual machine to distinguish between the two files having the 
name Joe.class 

The java and util directories 

Again, simplifying things slightly, the code in the above fragment refers to a file named Array List.class 

, which is stored in a directory named util , which is a subdirectory of a directory named java 
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The directory named java is the root of a directory tree containing a very large number of standard Java 
class files. 

(As an aside, there is another directory named javax, which forms the root of another directory tree 
containing class files considered to be extensions to the standard class library.) 
Many directories (packages) 

Stated simply, a Java package is nothing more or less than a directory containing class files. 

The standard and extended Java class libraries are scattered among a fairly large number of directories or 
packages (a quick count of the packages in the JDK 1.3 documentation indicates that there are approximately 
65 standard and extended packages) . 

A fully-qualified class name 

With one exception, whenever you refer to a class in a Java program, you must provide a fully-qualified 
name for the class, including the path through the directory tree culminating in the name of the class. Thus, 
the following is the fully-qualified name for the class whose name is ArrayList 

java.util. ArrayList 
(Later we will see another way to accomplish this that requires less typing effort.) 

The exception 

The one exception to the rule is the use of classes in the javalang package, (such as Boolean , 
Class , and Double ) . Your source code can refer to classes in the java.lang package without the 
requirement to provide a fully-qualified class name. 

An ArrayList object 

Now back to the use of the object previously instantiated from the class named ArrayList . This is 
the kind of object that is often referred to as a container. 

(A container in this sense is an object that is used to store references to other objects.) 
Many methods available 

An object of the ArrayList class provides a variety of methods that can be used to store object 

references and to fetch the references that it contains. 
The add method 

One of those methods is the method named add 

The following code fragment instantiates three objects of the String class, and stores them in the 
ArrayList object instantiated earlier. 

(Note that since the initial capacity of the ArrayList object was adequate to store only a single 
reference, the following code causes the object to automatically increase its capacity to at least three.) 


ref.add("ABC "); 
ref.add("DEF "); 
ref .add("GHI") ; 


The get() method 

The references stored in an object of the ArrayList class can be fetched by calling the get method 
on a reference to the object passing a parameter of type int 

The code in the following fragment calls the get method to fetch the references stored in index locations 
0, 1, and 2. These references are passed to the println method, where the contents of the String objects 
referred to by those references are concatenated and displayed on the computer screen. 


System.out.printin( 
(String)ref.get(0) + 
(String)ref.get(1) + 
(String) ref.get(2)); 
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The output 

This results in the following being displayed: 

ABC DEF GHI 

Summary 

The above discussion gave you a preview into the use of containers in general, and the ArrayList 
container in particular. 

However, the primary purpose of this program was to help you to understand the use of packages in Java. 

The ArrayList class was simply used as an example of a class file that is stored in a standard Java 
package. 

Back to Question 3 (p. 3234) 


7.14.6.9 Answer 2 


D. Joe Joe true 


7.14.6.9.1 Explanation 2 


Two String objects with identical contents 
As in Question 1 (p. 3232) , the program instantiates two String objects containing identical character 
strings, as shown in the following code fragment. 


char[] anArray = {’J’,’o’,’e’}; 
String Stri = new String(anArray) ; 
String Str2 = new String(anArray) ; 


Compare objects for equality 
Also, as in Question 1 (p. 3232) , this program compares the two objects for equality and displays the 
result as shown by the call to the equals method in the following fragment. 


System.out.print1n( 
Stri +" "+ Str2+" "4 
Str1.equals(Str2)); 


Compare using overridden equals method 

The == operator is not used to compare the two objects in this program. Instead, the objects are 
compared using an overridden version of the equals method. In this case, the equals method returns 
true, indicating that the objects are of the same type and contain the same data values. 

The equals method 

The equals method is defined in the Object class, and can be overridden in subclasses of Object 
It is the responsibility of the author of the subclass to override the method so as to implement that author’s 
concept of "equal" insofar as objects of the class are concerned. 

The overridden equals method 

The reason that the equals method returned true in this case was that the author of the String class 
provided an overridden version of the equals method. 

The default equals method 

If the author of the class does not override the equals method, and the default version of the equals 
method inherited from Object is called on an object of the class, then according to Sun: 

"for any reference values x and y, this method returns true if and only if x and y refer to the same object 

(x==y has the value true)" 
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In other words, the default version of the equals method inherited from the class Object provides 
the same behavior as the == operator when applied to object references. 
Back to Question 2 (p. 3233) 


7.14.6.10 Answer 1 
C. Joe Joe false 


7.14.6.10.1 Explanation 1 


The identity operator 

This program illustrates the behavior of the == operator (sometimes referred to as the identity operator) 
when used to compare references to objects. 

Two String objects with identical contents 

As shown in the following fragment, this program instantiates two objects of the String class containing 
identical character strings. 


class Worker{ 

void doIt(){ 
char[] anArray = {’J’,’o’,’e’}; 
String Stri = new String(anArray) ; 
String Str2 = new String(anArray) ; 


The fact that the two String objects contain identical character strings is confirmed by: 


e Both objects are instantiated using the same array object of type char as input. 
e When the toString representations of the two objects are displayed later, the display of each object 
produces Joe on the computer screen. 


Compare object references using identity (== 

The references to the two String objects are compared using the == operator, and the result of that 
comparison is displayed. This comparison will produce either true or false. The code to accomplish this 
comparison is shown in the following fragment. 


System.out.print1n( 
Stri +" "+ Str2 +" "4 
(Stri == Str2)); 


The statement in the above fragment produces the following display: 

Joe Joe false 

How can this be false? 

We know that the two objects are of the same type ( String ) and that they contain the same character 
strings. Why does the == operator return false? 

Doesn’t compare the objects 

The answer lies in the fact that the above statement doesn’t really compare the two objects at all. Rather, 
it compares the values stored in the reference variables referring to the two objects. That is not the same as 
comparing the objects. 

References are not equal 
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Even though the objects are of the same type and contain the same character string, they are two 
different objects, located in different parts of memory. Therefore, the contents of the two reference variables 
containing references to the two objects are not equal. 

The correct answer is false 

The == operator returns false as it should. The only way that the == operator could return true 

is if both reference variables refer to the same object, (which is not the case) . 
The bottom line is ... 

The == operator cannot be used to compare two objects for equality. However, it can be used to 
determine if two reference variables refer to the same object. 

Back to Question 1 (p. 3232) 

-end- 


7.15 Ap0140: Self-assessment, Type conversion, casting, common 
exceptions, public class files, javadoc comments and directives, and 
null references” 


7.15.1 Table of Contents 


e Preface (p. 3252) 
e Questions (p. 3252) 


1 (p. 3252) , 2 (p. 3253) , 3 (p. 3254) , 4 (p. 3255) , 5 (p. 3257) , 6 (p. 3257) , 7 (p. 3258) , 8 
(p. 3259) , 9 (p. 3260) , 10 (p. 3261) 


Listings (p. 3262) 
Miscellaneous (p. 3262) 
Answers (p. 3263) 


7.15.2 Preface 


This module is part of a self-assessment test designed to help you determine how much you know about 
object-oriented programming using Java. 

The test consists of a series of questions with answers and explanations of the answers. 

The questions and the answers are connected by hyperlinks to make it easy for you to navigate from the 
question to the answer and back. 

I recommend that you open another copy of this document in a separate browser window and use the 
links to under Listings (p. 3262) to easily find and view the listings while you are reading about them. 


7.15.3 Questions 
7.15.3.1 Question 1 


What output is produced by the program shown in Listing 1 (p. 3253) ? 


A. Compiler Error 

B. Runtime Error 

C. OK OK 

D. OK 

E. None of the above. 


19This content is available online at <http://cnx.org/content /m45302/1.5/>. 
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Listing 1 . Listing for Question 1. 


public class Ap15if{ 
public static void main( 
String args[]){ 
new Worker() .doIt(); 
}//end main() 
}//end class Ap151 


class Worker{ 
void doIt(){ 
Object refA 
Object refB = 
(Object) (new MyClassB()); 
System. out.print (refA) ; 
System. out.print (refB) ; 
System. out .println(""); 
}//end doIt() 
}// end class Worker 


new MyClassA(); 


class MyClassAf{ 
public String toString(){ 
return "OK "; 
3//end test() 
}//end class MyClassA 


class MyClassB{ 
public String toString(){ 
return "OK "; 
3//end test() 
}//end class MyClassB 


Table 7.191 


Answer and Explanation (p. 3272) 


7.15.3.2 Question 2 
What output is produced by the program shown in Listing 2 (p. 3254) ? 


A. Compiler Error 

B. Runtime Error 

C. OK OK 

D. OK 

E. None of the above. 
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Listing 2 . Listing for Question 2. 


public class Ap152{ 
public static void main( 
String args[]){ 
new Worker().doItQ; 
}//end main() 
}//end class Ap152 


class Worker{ 
void doIt(){ 
Object ref1 = new MyClassA(); 
Object ref2 = new MyClassB(); 
System. out.print(ref1); 


MyClassB ref3 = (MyClassB)ref1; 
System. out.print (ref3) ; 
System. out .println(""); 
}//end doIt() 
}// end class Worker 


class MyClassA{ 
public String toString(){ 
return "OK "; 
3//end test() 
}//end class MyClassA 


class MyClassBf{ 
public String toString(){ 
return "OK "; 
3//end test() 
}//end class MyClassB 


Table 7.192 


Answer and Explanation (p. 3271) 


7.15.3.3 Question 3 


What output is produced by the program shown in Listing 3 (p. 3255) ? 


A. Compiler Error 

B. Runtime Error 

C. OK 

D. None of the above. 
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Listing 3 . Listing for Question 3. 


import java.util.Random; 
import java.util.Date; 


public class Ap153{ 
public static void main( 
String args[]){ 
new Worker().doItQ; 
}//end main() 
}//end class Ap153 


class Worker{ 
void doItQf{ 
Random ref = new Random( 
new Date().getTime()); 
if (ref .nextBoolean()){ 
throw new IllegalStateException() ; 
}else{ 
System.out.println("0K"); 
}//end else 
}//end doIt() 
}// end class Worker 


Table 7.193 


Answer and Explanation (p. 3269) 


7.15.3.4 Question 4 


What output is produced by the program shown in Listing 4 (p. 3256) ? 


A. Compiler Error 

B. Runtime Error 

C. 51015 

D. None of the above. 
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Listing 4 . Listing for Question 4. 


import java.util.NoSuchElementException; 
public class Ap154{ 
public static void main( 
String args[]){ 
new Worker().doItQ; 
}//end main() 
}//end class Ap154 


class Worker{ 
void doIt(){ 
MyContainer ref = 
new MyContainer() ; 
ref .put(0,5); 
ref .put(1,10); 
ref .put (2,15); 


System.out.print(ref.get(0)+" "); 
System.out.print(ref.get(1)+" "); 
System. out.print (ref. get(2)+" "); 
System. out . print (ref.get(3)+" "); 


}//end doIt() 
}// end class Worker 


class MyContainer{ 
private int[] array = new int[3]; 


public void put(int idx, int data){ 
if(idx > (array.length-1)){ 
throw new 
NoSuchElementException() ; 
}else{ 
array [idx] = data; 
}//end else 
}//end put () 


public int get(int idx){ 
if(idx > (array.length-1)){ 
throw new 
NoSuchElementException() ; 
}else{ 
return array [idx]; 
}//end else 
}//end put () 


}//end class MyContainer 


Table 7.194 
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Answer and Explanation (p. 3267) 


7.15.3.5 Question 5 


The source code in Listing 5 (p. 3257) is contained in a single file named Ap155.java 
What output is produced by the program? 


A. Compiler Error 

B. Runtime Error 

C. OK 

D. None of the above. 


Listing 5 . Listing for Question 5. 


public class Ap155{ 
public static void main( 
String args[]){ 
new Ap155a() .doIt(); 
}//end main() 
}//end class Ap155 


public class Ap155a{ 
void doIt(){ 
System. out.println("0K") ; 
}//end doIt() 
}// end class Api55a 


Table 7.195 


Answer and Explanation (p. 3267) 


7.15.3.6 Question 6 


A Java application consists of the two source files shown in Listing 6 (p. 3257) and Listing 7 (p. 3258) 
having names of AP156.java and AP156a.java 
What output is produced by this program? 


A. Compiler Error 

B. Runtime Error 

C. OK 

D. None of the above. 


Listing 6 . Listing for Question 6. 


continued on next page 
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public class Ap156{ 
public static void main( 
String args[]){ 
new Ap156a() .doIt(); 
}//end main() 
}//end class Ap156 


Table 7.196 


Listing 7 . Listing for Question 6. 


public class Ap156a{ 
void doIt(){ 
System. out.println("0K") ; 
}//end doIt() 
}// end class Ap156a 


Table 7.197 


Answer and Explanation (p. 3266) 


7.15.3.7 Question 7 


Explain the purpose of the terms @param and @return in Listing 8 (p. 3259) 


terms that make sense to you. 


. Also explain any of the other 
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Listing 8 . Listing for Question 7. 


public class Ap157{ 


/ ** 

* Returns the character at the 
specified index. An index ranges from 
<code>0</code> to 

<code>length() - 1</code>. 


@param index index of desired 
character. 
@return the desired character. 


t * e A Fo * ¥ 


*/ 
public char charAt(int index) { 
//Note, this method is not intended 
// to be operational. Rather, it 
// 
return ’a’;//return dummy char 
}//end charAt method 
}//end class 


Table 7.198 


Answer and Explanation (p. 3265) 


7.15.3.8 Question 8 


What output is produced by the program shown in Listing 9 (p. 3260) ? 


A. Compiler Error 

B. Runtime Error 

C. Tom 

D. None of the above. 


CHAPTER 7. OOP SELF-ASSESSMENT 
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Listing 9 . Listing for Question 8. 


public class Ap158{ 
public static void main( 
String args[]){ 
new Worker() .doItQ; 
}//end main() 
}//end class Ap158 


class Worker{ 
void doIt(){ 
char[] ref; 
System. out.print (ref) ; 
System.out.print(" "); 
ref[0] = ’T’; 
ref[1] = ’o’; 
ref [2] m’; 
System. out .println(ref); 
}//end doIt() 
}// end class Worker 


Table 7.199 


Answer and Explanation (p. 3264) 


7.15.3.9 Question 9 

What output is produced by the program shown in Listing 10 (p. 3261) ? 
e A. Compiler Error 

e B. Runtime Error 

e 

e 


C. Tom 
D. None of the above. 
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Listing 10 . Listing for Question 9. 


public class Ap159{ 
public static void main( 
String args[]){ 
new Worker () .doItQ; 
}//end main() 
}//end class Ap159 


class Worker{ 
void doItQf{ 
char[] ref = null; 
System. out.print (ref) ; 
System.out.print(" "); 
ref[0] = ’T’; 
ref[1] = ’o’; 
ref [2] m’; 
System. out .println(ref); 
}//end doIt() 
}// end class Worker 


Table 7.200 


Answer and Explanation (p. 3264) 


7.15.3.10 Question 10 
What output is produced by the program shown in Listing 11 (p. 3262) ? 


A. Compiler Error 

B. Runtime Error 

C. Joe Tom 

D. None of the above. 
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Listing 11 . Listing for Question 10. 


public class Ap160{ 
public static void main( 
String args[]){ 
new Worker().doIt(); 
}//end main() 
}//end class Ap160 


class Worker{ 
void doItQf{ 
char[] ref = {’J’,’o’,’e’}; 
System.out.print (ref) ; 
System.out.print(" "); 
ref[0] = ’T’; 
ref[1] = ’o’; 
ref[2] = ’m’; 
System. out.println(ref); 
}//end doIt() 
}// end class Worker 


Table 7.201 


Answer and Explanation (p. 3263) 


7.15.4 Listings 


I recommend that you open another copy of this document in a separate browser window and use the 
following links to easily find and view the listings while you are reading about them. 


Listing 1 (p ) . Listing for Question 1. 
Listing 2 (p. 3254) . Listing for Question 2. 
Listing 3 (p. 3255) . Listing for Question 3. 
Listing 4 (p ) . Listing for Question 4. 
Listing 5 (p. 3257) . Listing for Question 5. 
Listing 6 (p. 3257) . Listing for Question 6. 
Listing 7 (p. 3258) . Listing for Question 6. 
Listing 8 (p. 3259) . Listing for Question 7. 
Listing 9 (p ) . Listing for Question 8. 
Listing 10 (p. 3261) . Listing for Question 9. 
Listing 11 (p. 3262) . Listing for Question 10. 


7.15.5 Miscellaneous 


This section contains a variety of miscellaneous information. 
Housekeeping material 


e Module name: Ap0140: Self-assessment, Type conversion, casting, common exceptions, public 
class files, javadoc comments and directives, and null references 
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e File: Ap0140.htm 

e Originally published: 2004 

e Published at cnx.org: 12/18/12 
e Revised: 12/03/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


7.15.6 Answers 
7.15.6.1 Answer 10 
C. Joe Tom 


7.15.6.1.1 Explanation 10 


This is an upgrade to the program from Question 9 (p. 3260) . 

Success at last 

The code in the following fragment resolves the compilation problem from Question 8 and the runtime 
problem from Question 9 (p. 3260) . 


void doIt(){ 

char[] ref = {’J’,’o’,’e’}; 

System.out.print(ref) ; 

System.out.print(" "); 

ref[0] = °T’; 

ref [1] 2073 

ref[2] = ’m’; 

System.out.println(ref) ; 
}//end doIt() 


Simply initializing the local reference variable named ref satisfies the compiler, making it possible to 


compile the program. 
Initializing the local reference variable named ref with a reference to a valid array object eliminates 


the NullPointerException that was experienced in Question 9 (p. 3260) . 
Printing the contents of the array object 
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The print statement passes the reference variable to the print method. The print method finds that 
the reference variable refers to a valid object (instead of containing null as was the case in Question 9 (p. 
3260) ) and behaves accordingly. 

The print statement causes the initialized contents of the array object to be displayed. Then those 
contents are replaced with a new set of characters. The println statement causes the new characters to 
be displayed. 

Back to Question 10 (p. 3261) 


7.15.6.2 Answer 9 


B. Runtime Error 


7.15.6.2.1 Explanation 9 


Purposely initializing a local variable 
This is an update to the program from Question 8 (p. 3259) . The code in the following fragment solves 
the compilation problem identified in Question 8 (p. 3259) . 


void doIt(){ 
char[] ref = null; 


In particular, initializing the value of the reference variable named ref satisfies the compiler and makes it 
possible to compile the program. 

A NullPointerException 

However, there is still a problem, and that problem causes a runtime error. 

The following statement attempts to use the reference variable named ref to print something on the 
screen. This results, among other things, in an attempt to call the toString method on the reference. 
However, the reference doesn’t refer to an object. Rather, it contains the value null 


System.out.print(ref) ; 


The result is a runtime error with the following infamous NullPointerException message appearing on 
the screen: 


java.lang.NullPointerException 
at java.io.Writer.write(Writer.java:107) 
at java.io.PrintStream.write(PrintStream. java: 245) 
at java.io.PrintStream. print (PrintStream. java: 396) 
at Worker.doIt (Ap159. java:22) 
at Ap159.main(Ap159.java:15) 


Back to Question 9 (p. 3260) 


7.15.6.3 Answer 8 


A. Compiler Error 
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7.15.6.3.1 Explanation 8 


Garbage in, garbage out 

Earlier programming languages, notably C and C++ allowed you to inadvertently write programs that 
process the garbage left in memory by previous programs running there. This happens when the C or C++ 
programmer fails to properly initialize variables, allowing them to contain left-over garbage from memory. 

Member variables are automatically initialized to default values 

That is not possible in Java. All member variables in a Java object are automatically initialized to a 
default value if you don’t write the code to initialize them to some other value. 

Local variables are not automatically initialized 

Local variables are not automatically initialized. However, your program will not compile if you write 
code that attempts to fetch and use a value in a local variable that hasn’t been initialized or had a value 
assigned to it. 

Print an uninitialized local variable 

The statement in the following code fragment attempts to fetch and print a value using the uninitialized 
local variable named ref 


void doIt(){ 
char[] ref; 
System. out.print (ref); 


As a result, the program refuses to compile, displaying the following error message under JDK 1.3. 


Ap158.java:23: variable ref might not have been initialized 
System. out.print (ref); 


Back to Question 8 (p. 3259) 


7.15.6.4 Answer 7 


See explanation below. 


7.15.6.4.1 Explanation 7 


The javadoc.exe program 

When you download the JDK from Oracle, you receive a program named javadoc.exe in addition to 
several other programs. 

The purpose of the javadoc program is to help you document the Java programs that you write. You 
create the documentation by running the javadoc program and specifying your source file or files as a 
command-line parameter. For example, you can generate documentation for this program by entering the 
following at the command line. 


javadoc Ap157.java 
Produces HTML files as output 


This will produce a large number of related HTML files containing documentation for the class named 
Ap157 . The primary HTML file is named Ap157.html . A file named index.html is also created. 
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This file can be opened in a browser to provide a viewer for all of the information contained in the many 
related HTML files. 

(As a labor saving device, you can also specify a group of input files to the javadoc program, using 
wildcard characters as appropriate, to cause the program to produce documentation files for each of the 
input files in a single run.) 

Special documentation comments and directives 

If you include comments in your source code that begin with 
/** 
and end with 
we 
they will be picked up by the javadoc program and become part of the documentation. 
In addition to comments, you can also enter a variety of special directives to the javadoc program as 
shown in the following program. 


public class Ap157{ 


[xx 

Returns the character at the 
specified index. An index ranges from 
<code>0</code> to 

<code>length() - 1</code>. 


* 
* 
* 
* 
* 
* @param index index of desired 
* character. 

* 


@return the desired character. 
*/ 
public char charAt(int index) { 
//Note, this method is not intended 
// to be operational. Rather, it 
// is intended solely to illustrate 
// the generation of javadoc 
// documentation for the parameter 
// and the return value. 
return ’a’;//return dummy char 
}//end charAt method 
}//end class 


The @param and @return directives 

The @param and @return directives in the source code shown above are used by the javadoc 
program for documenting information about parameters passed to and information returned from the method 
named charAt . The method definition follows the special javadoc comment. 

Back to Question 7 (p. 3258) 
7.15.6.5 Answer 6 


C. OK 


7.15.6.5.1 Explanation 6 


Public classes in separate files 
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This program meets the requirement identified in Question 5 (p. 3257) . In particular, this program 
defines two public classes. The source code for each public class is stored in a separate file. Thus, the 
program compiles and executes successfully, producing the text OK on the screen. 

Back to Question 6 (p. 3257) 


7.15.6.6 Answer 5 


A. Compiler Error 


7.15.6.6.1 Explanation 5 


Public classes in separate files 

Java requires that the source code for every public class be contained in a separate file. In this case, the 
source code for two public classes was contained in a single file. The following compiler error was produced 
by JDK 1.3: 


Ap155.java:18: class Ap155a is public, should be declared in a file 
named Api55a. java 
public class Ap155a{ 


Back to Question 5 (p. 3257) 


7.15.6.7 Answer 4 


This program produces both of the following: 


e €.51015 
e B. Runtime Error 


7.15.6.7.1 Explanation 4 


The NoSuchElementException 

This program defines, creates, and uses a very simple container object for the purpose of illustrating the 
NoSuchElementException 

The code in the following fragment shows the beginning of a class named MyContainer from which 
the container object is instantiated. 


class MyContainer{ 
private int[] array = new int[3]; 


public void put(int idx, int data){ 
if (idx > (array.length-1)){ 
throw new 
NoSuchElementException() ; 
}else{ 
array [idx] = data; 
}//end else 
}//end put() 
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A wrapper for an array object 

This class is essentially a wrapper for a simple array object of type int . An object of the class provides 
a method named put , which can be used to store an int value into the array. The put method 
receives two parameters. The first. parameter specifies the index of the element where the value of the second 
parameter is to be stored. 

Throw NoSuchElementException on index out of bounds 

The put method tests to confirm that the specified index is within the positive bounds of the array. 
If not, it uses the throw keyword to throw an exception of the type NoSuchElementException 
Otherwise, it stores the incoming data value in the specified index position in the array. 

(Note that a negative index will cause an ArrayIndexOutOfBoundsException instead of a NoSuchEle- 

mentException to be thrown.) 

The get method 

An object of the MyContainer class also provides a get method that can be used to retrieve the 
value stored in a specified index. 


public int get(int idx){ 
if (idx > (array.length-1)){ 
throw new 
NoSuchElementException() ; 
telsef 
return array [idx]; 
3//end else 
}//end put () 


The get method also tests to confirm that the specified index is within the positive bounds of the array. 
If not, it throws an exception of the type NoSuchElementException . Otherwise, it returns the value 
stored in the specified index of the array. 
(As noted earlier, a negative index will cause an ArrayIndexOutOfBoundsException instead of a No- 
SuchElementException to be thrown.) 
The NoSuchElementException 
Thus, this container class illustrates the general intended purpose of the NoSuchElementException 


Instantiate and populate a container 

The remainder of the program simply exercises the container. The code in the following fragment instan- 
tiates a new container, and uses the put method to populate each of its three available elements with the 
values 5, 10, and 15. 


void doIt(){ 
MyContainer ref = 
new MyContainer (); 
ref .put (0,5); 
ref .put(1,10); 
ref .put (2,15); 


Get and display the data in the container 

Then the code in the next fragment uses the get method to get and display the values in each of the 
three elements, causing the following text to appear on the screen: 

51015 
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System.out.print(ref.get(0)+" "); 
System.out.print(ref.get(1)+" "); 
System.out.print(ref.get(2)+" "); 


One step too far 
Finally, the code in the next fragment goes one step too far and attempts to get a value from index 3, 
which is outside the bounds of the container. 


System.out.print(ref.get(3)+" "); 


This causes the get method of the container object to throw a NoSuchElementException . The 
program was not designed to handle this exception, so this causes the program to abort with the following 
text showing on the screen: 


5 10 15 java.util.NoSuchElementException 
at MyContainer.get (Ap154. java:49) 
at Worker.doIt (Ap154. java:30) 
at Ap154.main(Ap154. java:15) 


(Note that the values of 5, 10, and 15 were displayed on the screen before the program aborted and displayed 
the error message.) 
Back to Question 4 (p. 3255) 


7.15.6.8 Answer 3 


This program can produce either of the following depending on the value produced by a random boolean 
value generator: 


e B. Runtime Error 
e C. OK 


7.15.6.8.1 Explanation 3 


Throwing an exception 

This program illustrates the use of the throw keyword to throw an exception. 

(Note that the throw keyword is different from the throws keyword.) 

Throw an exception if random boolean value is true 

A random boolean value is obtained. If the value is true, the program throws an IllegalStateEx- 
ception and aborts with the following message on the screen: 


java.lang.IllegalStateException 
at Worker.doIt(Ap153.java:29) 
at Ap153.main(Ap153. java: 20) 
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If the random boolean value is false, the program runs to completion, displaying the text OK on the 
screen. 

Instantiate a Random object 

The following code fragment instantiates a new object of the Random class and stores the object’s 
reference in a reference variable named ref 


void doIt(){ 
Random ref = new Random( 
new Date().getTime()); 


Pm not going to go into a lot of detail about the Random class. Suffice it to say that an object of this 
class provides methods that will return a pseudo random sequence of values upon successive calls. You might 
think of this object as a random value generator. 

Seeding the random generator 

The constructor for the class accepts a long integer as the seed for the sequence. 

(Two Random objects instantiated using the same seed will produce the same sequence of values.) 

In this case, I obtained the time in milliseconds, relative to January 1, 1970, as a long integer, and 
provided that value as the seed. Thus, if you run the program two times in succession, with a time delay of 
at least one millisecond in between, the random sequences will be different. 

Get a random boolean value 

The code in the next fragment calls the nextBoolean method on the Random object to obtain a 
random boolean value. (Think of this as tossing a coin with true on one side and false on the other side.) 


if (ref .nextBoolean()){ 
throw new IllegalStateException() ; 


Throw an exception 

If the boolean value obtained in the above fragment is true, the code instantiates a new object of the 
IllegalStateException class , and uses the throw keyword to throw an exception of this type. 

Program aborts 

The program was not designed to gracefully handle such an exception. Therefore the program aborts, 
displaying the error message shown earlier. 

Don’t throw an exception 

The code in the next fragment shows that if the boolean value tested above is false, the program will 
display the text OK and run successfully to completion. 


}else{ 
System. out.println("0K") ; 

}//end else 

}//end doIt() 


You may need to run the program several times to see both possibilities. 
Back to Question 3 (p. 3254) 
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7.15.6.9 Answer 2 


The answer is both of the following: 


e D.OK 
e B. Runtime Error 


7.15.6.9.1 Explanation 2 


One cast is allowable ... 

It is allowable, but not necessary, to cast the type of an object’s reference toward the root of the inheritance 
hierarchy. 

It is also allowable to cast the type of an object’s reference along the inheritance hierarchy toward the 
actual class from which the object was instantiated. 

Another cast is not allowable ... 

However, (excluding interface type casts) , it is not allowable to cast the type of an object’s reference in 
ways that are not related in a subclass-superclass inheritance sense. For example, you cannot cast the type 
of an object’s reference to the type of a sibling of that object. 

Two sibling classes 

The code in the following fragment defines two simple classes named MyClassA and MyClassB 
By default, each of these classes extends the class named Object . Therefore, neither is a superclass of 
the other. Rather, they are siblings. 


class MyClassAf{ 
public String toString(){ 
return "OK "; 
}//end test () 
}//end class MyClassA 


class MyClassBf{ 
public String toString(){ 
return "OK "; 
}//end test () 
}//end class MyClassB 


Instantiate one object from each sibling class 

The code in the next fragment instantiates one object from each of the above classes, and stores references 
to those objects in reference variables of type Object. 

Then the code causes the overridden toString method of one of the objects to be called by passing 
that object’s reference to the print method. 


void doIt(){ 
Object ref1 = new MyClassAQ); 
Object ref2 = new MyClassB() ;s 
System.out.print(ref1); 


The code in the above fragment causes the text OK to appear on the screen. 
Try to cast to a sibling class type 
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At this point, the reference variable named refl holds a reference to an object of type MyClassA 
The reference is being held as type Object 

The statement in the next fragment attempts to cast that reference to type MyClassB 
sibling of the class named MyClassA 


which is a 


3 


MyClassB ref3 = (MyClassB)ref1; 


A ClassCastException 
The above statement causes a ClassCastException to be thrown, which in turn causes the program 
to abort. The screen output is shown below: 


OK java.lang.ClassCastException:MyClassA 
at Worker.doIt(Ap152. java:24) 
at Ap152.main(Ap152. java:14) 


(Note that the text OK appeared on the screen before the program aborted and displayed diagnostic 
information on the screen.) 
Back to Question 2 (p. 3253) 


7.15.6.10 Answer 1 
C. OK OK 


7.15.6.10.1 Explanation 1 


Type conversion 

This program illustrates type conversion up the inheritance hierarchy, both with and without a cast. 

Store object’s reference as type Object 

The following fragment instantiates a new object of the class named MyClassA_, and stores that 
object’s reference in a reference variable of type Object . This demonstrates that you can store an object’s 
reference in a reference variable whose type is a superclass of the class from which the object was instantiated, 
with no cast required. 


class Worker{ 
void doIt(){ 
Object refA = new MyClassAQ) ; 


Cast object’s reference to type Object 

The code in the next fragment instantiates an object of the class named MyClassB , and stores the 
object’s reference in a reference variable of type Object , after first casting the reference to type Object 
. This, and the previous fragment demonstrate that while it is allowable to cast a reference to the superclass 
type before storing it in a superclass reference variable, such a cast is not required. 


Object refB = 
(Object) (new MyClassB()); 
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Type conversion and assignment compatibility 
This is part of a larger overall topic commonly referred to as type conversion. It also touches the fringes 
of something that is commonly referred to as assignment-compatibility. 
Automatic type conversions 
Some kinds of type conversions happen automatically. For example, you can assign a value of type byte 
to a variable of type int and the type conversion will take place automatically. 
Cast is required for narrowing conversions 
However, if you attempt to assign a value of type int toa variable of type byte , the assignment will 
not take place automatically. Rather, the compiler requires you to provide a cast to confirm that you accept 
responsibility for the conversion, which in the case of int to byte could result in the corruption of data. 
Automatic conversions up the inheritance hierarchy 
When working with objects, type conversion takes place automatically for conversions toward the root of 
the inheritance hierarchy. Therefore, conversion from any class type to type Object happen automatically. 
However, conversions in the direction away from the root require a cast. 
(Conversion from any class type to any superclass of that class also happens automatically.) 
Polymorphic behavior 
The code in the next fragment uses polymorphic behavior to display the contents of the two String 
objects. 


System.out.print (refA) ; 
System. out.print (refB); 


No cast required 

This works without the use of a cast because the print method calls the toString method on any 
object’s reference that it receives as an incoming parameter. The toString method is defined in the 
Object class, and overridden in the String class. Polymorphic behavior dictates that in such a situation, 
the version of the method belonging to the object will be called regardless of the type of the reference variable 
holding the reference to the object. 

When would a cast be required? 

Had the program attempted to call a method on the reference that is not defined in the Object , class, 
it would have been necessary to cast the reference down the inheritance hierarchy in order to successfully 
call the method. 

Back to Question 1 (p. 3252) 

-end- 
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Anatomy of a Game Engine 


8.1 Jy0060: Anatomy of a Game Engine’ 


8.1.1 Table of Contents 


e Welcome (p. 3275) 
e Miscellaneous (p. 3276) 


8.1.2 Welcome 


Click the link to view the material for Anatomy of a Game Engine ? , which I use in some of the courses 
that I teach at Austin Community College in Austin, TX. 

This is a collection of modules designed to teach students about the anatomy of a typical game or 
simulation engine (sometimes called a game or simulation framework) 

The collection is built around the Slick2D Game library. 

The Slick2D library 

I chose to concentrate on the free game library named Slick2D è ,(which is written in Java) for several 
reasons including the following: 


e Java is the language with which I am the most comfortable. Hence, I can probably do a better job of 
explaining the anatomy of a game engine that uses Slick2D than would be the case for a game engine 
written in C++, C#, Python, or some other programming language. 

e Java has proven in recent years to be a commercially successful game programming language. For 
example, I cite the commercial game named Minecraft 4 , written in Java, for which apparently millions 
of copies have been sold. Also, knowing Java is very beneficial for those who might want to develop 
apps for Android. 

e Slick2D is free and the source code for Slick2D is readily available. 

e The overall structure of a basic Slick2D game engine is very similar to Dark GDK and XNA, and is 
probably similar to other game engines as well. 

e Java is platform independent. 


Applicable to other environments as well 

Although the modules in this collection concentrate on the Java game library named Slick2D, the concepts 
involved and the knowledge that you will gain is applicable to other game engines written in different 
programming languages. 


'This content is available online at <http://cnx.org/content /m45747/1.1/>. 
*http://cnx.org/content /col11489 /latest / 
3http://slick.cokeandcode.com/index.php 

“http://minecraft.net / 
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8.1.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Jy0060: Anatomy of a Game Engine 
e File: Jy0060.htm 
e Published: 02/05/13 


NOTE: Disclaimers:: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


Chapter 9 


Principles of Object-Oriented 
Programming 


9.1 Jy0070-Principles of Object-Oriented Programming’ 


9.1.1 Table of Contents 


e Welcome (p. 3277) 
e Miscellaneous (p. 3277) 


9.1.2 Welcome 
Click the following title to view Principles of Object-Oriented Programming ? (current as of 02/20/13) : 


Summary : An objects-first with design patterns introductory course 
Instructor : Stephen Wong and Dung Nguyen 

Institution : Rice University 

Course Number : COMP201 


One of the great things about cnx.org is the ability for an instructor like myself to incorporate course 
materials shared by others. This makes it possible for the courses that I teach to have more breadth than 
might otherwise be the case. 

It may be beneficial for you to study this material, which you will probably find to be more formal and 
rigorous than the material that I have provided. Pay particular attention to the design pattern concept as 
well as the UML diagrams. 


9.1.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Jy0070-Principles of Object-Oriented Programming 
e File: Jy0070.htm 
e Published: 02/20/13 


'This content is available online at <http://cnx.org/content /m45793/1.1/>. 
*http://cnx.org/content /col10213/latest / 
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NOTE: Disclaimers:: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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Programming Oldies But Goodies 


10.1 Jy0050: Programming Oldies But Goodies’ 


10.1.1 Table of Contents 


e Welcome (p. 3279) 
e Miscellaneous (p. 3279) 


10.1.2 Welcome 


Over the years, I have published a large number of tutorials in the areas of computer programming and 
DSP. As I have the time to do so, I am converting the more significant of those tutorials into cnxml code 
and re-publishing them at cnx.org. In the meantime, the collection titled Programming Oldies But Goodies 
2 which is a work in process, gathers many of the tutorials in their original HTML format into a common 
location to make them readily available for Connexions users. 


10.1.3 Miscellaneous 


This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 


e Module name: Jy0050: Programming Oldies But Goodies 
e File: Jy0050.htm 
e Published: 01/17/13 


NOTE: Disclaimers:: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 


'This content is available online at <http://cnx.org/content /m45681/1.1/>. 
*http://cnx.org/content /col11478 
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compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 
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Chapter 11 


Objects First 


11.1 Gf0100: Objects First with Greenfoot’ 


11.1.1 Table of Contents 


Preface (p. 3281) 
Overview (p. 3282) 


A visual interactive programming environment (p. 3282) 
Greenfoot is not a toy (p. 3282) 
The Greenfoot gallery (p. 3283) 


Software (p. 3283) 


Software to download and install (p. 3283) 
Stand alone software (p. 3283) 


Running Greenfoot (p. 3284) 


The installed version (p. 3284) 
The stand alone version (p. 3284) 


Textbook and tutorials (p. 3284) 
The textbook (p. 3285) 


The tutorials (p. 3285) 


* Written tutorials (p. 3285) 
* Video tutorials (p. 3285) 
x Other possibilities (p. 3285) 


What comes next after Greenfoot (p. 3286) 
Miscellaneous (p. 3286) 


11.1.2 Preface 


If you are new to programming and want to learn how to program, or if you have programming experience 
but are new to object-oriented programming (OOP) and want to learn OOP, I can’t think of a better way 


to take that first step than through the use of Greenfoot ? . 


'This content is available online at <http://cnx.org/content /m45790/1.2/>. 
*http://www.greenfoot.org/door 
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Greenfoot provides a set of interactive visual tools coupled with the Java programming language that 
makes learning to program both interesting and productive. 
(Note that descriptions of the Greenfoot website contained herein are current as of 02/19/13.) 


11.1.3 Overview 


11.1.3.1 A visual interactive programming environment 


"teaches object 


The greenfoot overview 3 page describes Greenfoot as an Interactive Visual World that 
orientation with Java." 

When programming with Greenfoot, you "Create ‘actors’ which live in ’worlds’ to build games, simula- 
tions, and other graphical programs." 

Greenfoot is both instructive and enjoyable because it is visual and interactive. Visualization and inter- 
action tools are built into the programming environment. 

Unlike Scratch 4 and Alice © (two programming environments for beginners that use a drag-and-drop 
approach to programming) , Greenfoot actors "are programmed in standard textual Java code, providing 
a combination of programming experience in a traditional text-based language with visual execution." 

According to Wikipedia ® , 

"Greenfoot is an interactive Java development environment designed primarily for educational pur- 
poses at the high school and undergraduate level. It allows easy development of two-dimensional graphical 
applications, such as simulations and interactive games. 

Greenfoot is being developed and maintained at the University of Kent * and La Trobe University 

, with support from Oracle °’ . It is free software, released under the GPL license. Greenfoot is available 
for Microsoft Windows '!° , MacOSX !! , Linux ! , Sun Solaris '!° , and any recent JVM ™ 


I 
H 


8 


Continuing with Wikipedia 15 , 

"Greenfoot aims to motivate learners quickly by providing easy access to animated graphics, sound 
and interaction. The environment is highly interactive and encourages exploration and experimentation. 
Pedagogically, the design is based on constructivist and apprenticeship approaches. 

Secondly, the environment is designed to illustrate and emphasize important abstractions and concepts 
of object-oriented programming. Concepts such as the class/object relationship, methods, parameters, and 
object interaction are conveyed through visualizations and guided interactions. The goal is to build and 
support a mental model that correctly represents modern object-oriented programming systems." 


11.1.3.2 Greenfoot is not a toy 


Your first impression when you enter the Greenfoot home page !® may be that Greenfoot is a toy, but that 
definitely is not the case. 


Shttp://www.greenfoot.org/overview 
“http://scratch.mit.edu/ 
*http://www.alice.org/ 
Shttp://en.wikipedia.org/wiki/Greenfoot 
“http://en.wikipedia.org/wiki/University_ of _ Kent 
Shttp://en.wikipedia.org/wiki/La_Trobe_ University 
°http://en.wikipedia.org/wiki/Oracle 
10http://en.wikipedia.org/wiki/Microsoft Windows 
"http://en.wikipedia.org/wiki/Mac_OS_X 
'http://en.wikipedia.org /wiki/Linux 
13http://en.wikipedia.org/wiki/Sun_ Solaris 
'4http://en.wikipedia.org/wiki/Java_Virtual_ Machine 
1http://en.wikipedia.org/wiki/Greenfoot 
6http://www.greenfoot.org/home 
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While it is true that the first impulse of many beginning programmers is to create computer games (as 
evidenced on the home page ' andthe Greenfoot Gallery !8 ), Greenfoot can also be used to create 
serious interactive simulations. As an example, I will point you to the following simulations: 


e Ants 1? by mik 
e Wave-Lab 7° by delmar 
e Birds and Trees 2! by polle 


(Click a link given above to download and run a simulation. When the simulation window appears, click 
the Run button on the simulation window to start the simulation running.) 

You can view more than 7500 scenarios (Greenfoot programs are commonly referred to as scenarios) by 
clicking the Scenarios link at the top of the home page 7? . Some of the scenarios are impressive. Some 
are not so impressive. Many, possibly most, were written by beginning programmers. 

(Note that you must have Java applets enabled on your computer to run these simulations. Alternatively, 
if you have Greenfoot installed on your computer, you can click the "Open in Greenfoot" button to cause 
the program to be downloaded for compilation and execution locally on your computer.) 


11.1.3.3 The Greenfoot Gallery 


What you see when you click the Scenarios link at the top of the home page ?3 has been called the 
Greenfoot Gallery 74 in times past. This is a place where the authors of Greenfoot scenarios can publish 
their scenarios if they so choose. 

This is a social network or virtual programming community where Greenfoot programmers gather to 
encourage one another and to critique the work being done by themselves and others. Note however that 
active participation in the gallery is completely voluntary. 


11.1.4 Software 


The Greenfoot software and the Java Development Kit (JDK), both of which run on Windows, Mac, and 
Linux, are available for free download 7° . 


11.1.4.1 Software to download and install 


When you visit the download 7° page, you will find download links for Windows, Mac OS X, and Ubuntu. 
Click one of those links to download and install the appropriate version of Greenfoot on your computer. 

You will also need to download and install the Java Development Kit (JDK). There is a download button 
labeled Download JDK for that purpose. 


11.1.4.2 Stand alone software 


As an alternative to the version that can be installed on your computer, there is a self-contained Stand 
Alone version that you can download, unzip, copy to, and run either from a disk folder or from a USB 
memory stick with no other installation required. This version contains both the Greenfoot software and 
the Java JDK. 


'Thittp://www-greenfoot.org/home 
18http://www.greenfoot.org/scenarios 
1http://www.greenfoot.org/scenarios/1016 
°nttp://www.greenfoot.org/scenarios/597 
21 http://www.greenfoot.org/scenarios/267 
?2http://www.greenfoot.org/home 
3http://www.greenfoot.org/home 
4http://www.greenfoot.org/scenarios 
5http://www.greenfoot.org/download 
6http://www.greenfoot.org /download 
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Once you extract the software from the zip file, you will need about 200 Mbytes to store it in a disk 
folder. Depending on the formatting, you may need as much as 275 Mbytes of available space to copy the 
software to a USB memory stick. 

The stand alone version is particularly useful in several situations including the following: 


e You want to run Greenfoot on a computer for which you don’t have installation privileges, such as in 
a public library or a college computer lab. 

e You don’t already have the Java JDK installed on your computer and would prefer not to go through 
the effort to download and install it. 

e You want to run Greenfoot, but you don’t want to install anything on your computer. 


11.1.5 Running Greenfoot 
11.1.5.1 The installed version 


If you download and install Greenfoot and the Java JDK on your computer, you will have an opportunity to 
place a Greenfoot icon on your desktop. Just double-click the icon to start the Greenfoot program running. 
(Although not necessary, it is probably best to install the JDK before installing Greenfoot.) 


11.1.5.2 The stand alone version 


If you elect to use the stand alone version, you will extract the following folders from the zip file: 


BlueJ 2? (a more advanced Java programming environment) 
Greenfoot (the programming environment of interest in this module) 
jdk (the Java Development Kit) 

userhome (not sure the purpose of this folder) 


You will find a file named Greenfoot.exe inside the Greenfoot folder. It will have an icon of a small 
green footprint. Double click this file to start the Greenfoot program running. 
Once the program is running, you can select the Greenfoot Tutorial item on the Help menu to open 
a webpage containing a variety of educational tutorials. (I will have more to say about this later.) The 
Help menu also provides access to several other useful items, such as documentation for both Greenfoot 
and the Java JDK. 


11.1.6 Textbook and tutorials 


There is a textbook titled Introduction to Programming with Greenfoot - Object-Oriented Programming in 
Java with Games and Simulations 7° that you can purchase on Amazon for about $75.00. (As usual, you 
can rent it for less or purchase a used copy for less.) 

There are also many free online tutorials 7° available to help you get started programming with Java and 
Greenfoot. 

Whether you need the textbook, or whether the tutorials will suffice will depend on your background. 
My advice is to begin with the tutorials alone, and then purchase the textbook if needed. 


27 http:/ /www.bluej.org/ 
*Shttp://www.greenfoot.org/book 
°http://www.greenfoot.org/doc 
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11.1.6.1 The textbook 


That having been said, I will comment on the textbook. If I had the luxury of designing a computer 
programming curriculum from scratch, I would choose a model very similar to the Greenfoot textbook. 

In particular, unlike the programming curricula in many colleges and universities, I would begin with 
the big picture (classes, interfaces, objects, methods, variables, etc.) and work my way down to the more 
detailed aspects of programming (selection, loops, operators, types, etc.) 

(The programming curricula at many colleges and universities begin at the bottom and work their way 
up instead of beginning at the top and working their way down. As a result, many students become bogged 
down in details and either quit or fail and never get a chance to see the big picture of object-oriented 
programming.) 

Because I believe in the top down model on which the text book is based, I can recommend this textbook as 
a very good way to get started learning computer programming in general and object-oriented programming 
in particular. (I am not affiliated with the author or the publisher and receive no compensation from the 
sale of this textbook.) 


11.1.6.2 The tutorials 
11.1.6.2.1 Written tutorials 


As of 02/19/13, the Greenfoot website provides the following written tutorials to help you learn how to use 
Greenfoot and begin programming: 


Interacting with Greenfoot 30 

Movement and Key Control 3! 

Detecting and Removing Actors, and Making Methods 3? 
Saving the World, Making and Playing Sound 33 

Adding a Randomly Moving Enemy *4 

How to Access One Object From Another *° 


11.1.6.2.2 Video tutorials 

If you prefer video tutorials, the Joy Of Code *° is a thorough introduction to Greenfoot broken down into 
a large number of videos. A wide range of other short. videos 37 are also available. 

11.1.6.2.3 Other possibilities 


Once you become an accomplished Greenfoot programmer, you might be interested in some of the following 
possibilities, which generally require other resources or more advanced knowledge: 


e Kinect with Greenfoot 38 . 
e PicoBoard with Greenfoot 3° . 
e Sense Board with Greenfoot *° . 


3°http://www.greenfoot.org/doc/tut-1 

31 http://www.greenfoot.org/doc/tut-2 
32http://www.greenfoot.org/doc/tut-3 
33http://www.greenfoot.org/doc/tut-4 
34http://www.greenfoot.org/doc/tut-5 
35http://www.greenfoot.org/doc/howto-1 
36http://www.joyofcode.org/ 
37http://www.youtube.com/user/18km?ob=5#g/u 
38http://www.greenfoot.org/doc/kinect 
3°http://www.greenfoot.org/doc/pico 
40http://www.greenfoot.org/doc/sense 
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Finch with Greenfoot * . 

Loading native libraries with Greenfoot 4? . 
Gamepads with Greenfoot 4° . 

CS Unplugged with Greenfoot * . 

AP Computer Science with Greenfoot 45 . 
Learn Maths with Greenfoot 46 


11.1.7 What comes next after Greenfoot 


While this may sound like an exaggeration, programming with Greenfoot is sort of like riding a bicycle with 
training wheels. After awhile, you no longer need the training wheels and you are ready to move on to true 
two-wheeler. 

While is it possible to push Greenfoot into some pretty complex and sophisticated scenarios, there comes 
a time when you need to take the training wheels off and ride that two-wheeler. 

Numerous possibilities are possible in this regard. One possibility is BlueJ - The interactive Java envi- 
ronment 47 from the same folks who brought you Greenfoot. Like Greenfoot, the BlueJ software is available 
for free downloading. Also like Greenfoot, a textbook can be purchased and some free tutorials are available. 

Another possibility is to continue working through the modules in this collection. 

A very good possibility is to do both. 


11.1.8 Miscellaneous 
This section contains a variety of miscellaneous information. 


Housekeeping material 


e Module name: Gf0100: Objects First with Greenfoot 
e File: Gf0100.htm 

e Published: 02/19/13 

e Revised: 12/26/14 


Disclaimers: Financial : Although the Connexions site makes it possible for you to download 
a PDF file for this module at no charge, and also makes it possible for you to purchase a pre-printed 
version of the PDF file, you should be aware that some of the HTML elements in this module may 
not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : Iam a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


4lhttp://www.greenfoot.org/doc/finch 
42http://www.greenfoot.org/doc/native_ loader 
43http://www.greenfoot.org/doc/gamepad 

44h ttp://www.greenfoot.org/doc/csunplugged 
45http://www.greenfoot.org/doc/ap 
46http://sinepost.wordpress.com/ 
47http://www.bluej.org/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


Chapter 12 


Appendices 


12.1 Java OOP: Java Documentation’ 


12.1.1 Table of Contents 
e Preface (p. 3287) 


Viewing tip (p. 3287) 
x Figures (p. 3288) 


Discussion (p. 3288) 

Java Platform, Standard Edition 7 API Specification (p. 3289) 
A universal documentation format (p. 3292) 

Typical usage of the API documentation (p. 3292) 

Summary (p. 3292) 

Miscellaneous (p. 3292) 


12.1.2 Preface 


This module is one of a series of modules designed to teach you about Object-Oriented Programming (OOP) 
using Java. 

I cannot overemphasize the importance of Oracle’s Java documentation ? to aspiring Java programmers. 
The documentation package, which can be downloaded for installation and local access or accessed online, 
contains a wealth of information. 

In my opinion, it is not possible to write Java programs of any substance without frequent reference 
to the documentation. No one can memorize everything that they need to know to be a successful Java 
programmer. 

(Note that each time Oracle releases a new version of the Java Development Kit (JDK), they also release 
a new version of the documentation. Therefore, as new versions are released, the links provided in this 
document may become outdated and may not take you to the latest version of the documentation. However, 
you should be able to find the latest documentation via an online search.) 


12.1.2.1 Viewing tip 


I recommend that you open another copy of this module in a separate browser window and use the following 
links to easily find and view the figures while you are reading about them. 


'This content is available online at <http://cnx.org/content/m45117/1.1/>. 
*http://docs.oracle.com/javase/7/docs/ 
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12.1.2.1.1 Figures 


e Figure 1 (p. 3289) . Screen shot of the API specification at startup. 
e Figure 2 (p. 3291) . Screen shot of the API documentation after selecting the JButton class. 


12.1.3 Discussion 


Small core language, large class library 

The Java Platform Standard Edition programming environment consists of a small core programming 
language and a large class library. 

(As of the date of this writing, you can view The Java Language Specification * online. This specification 
will tell you just about everything that most programmers need to know about the core language.) 

The size of the class library grows with the release of each new version of the JDK, because each new 
version provides capabilities that didn’t exist in the previous version. New capabilities are added through 
the addition of new classes and new interfaces to the library. 

The true power of Java resides in the class libraries 

Once you understand how OOP is implemented in Java and you get beyond while loops, if statements, 
and other fundamental programming concepts, virtually all the power of Java resides in: 


e Classes, interfaces, and methods in the various class libraries that you use directly. 
e Classes, interfaces, and methods in the various class libraries that you extend. 
e New classes, interfaces, and methods that you and others define. 


You will always use material from Oracle’s standard class libraries. You will often use material from other 
libraries that you create yourself, or that you obtain from sources outside of Oracle (such as Barb Ericson’s 
multimedia library + , for example) . 

Top-level online documentation 

As of the date of this writing, you can view the top-level page of the documentation for Java Platform 
Standard Edition 7 at http://docs.oracle.com/javase/7/docs/ ° . 

A complicated page 

When you first view that documentation page, it may appear to be very complicated. Of all the material 
on the page, the most important is probably the Application Programming Interface (API) , which is 
currently available via a link on the right side of the page labeled Java SE API ê. 

However, you should not ignore the links to other information available on the top-level page 7 . Those 
links will often contain information that you need, and that information can make you more efficient in using 
the API documentation. 

Search 

If you follow the Search link at the top of the page, you will arrive at a search engine page 8 that gives 

you the ability to do a keyword search on the online documentation. 
Downloading and installing Java 

Of particular interest to most newcomers should be the links titled Installation Instructions °? and Java 
SE Downloads !° . 

The Java Tutorials 


3http://java.sun.com/docs/books/jls/second_ edition/html/j.title.doc.html 
“*http://coweb.cc.gatech.edu/mediaComp-plan/101 
>http://docs.oracle.com/javase/7/docs/ 
®http://docs.oracle.com/javase/7/docs/api/index.html 
“http://docs.oracle.com/javase/7/docs/ 
Shttp://docs.oracle.com/javase/search.html 
*http://docs.oracle.com/javase/7/docs/webnotes/install/index.html 
'http://www.oracle.com/technetwork/java/javase /downloads/index.html 
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Also very important is the link to The Java Tutorials !! . Once you reach those tutorials, of particular 
importance is the Path and CLASSPATH !? tutorial. (Many students trip on the path, the classpath, and 
the difference between the two.) 


12.1.4 Java Platform, Standard Edition 7 API Specification 


The API Specification '° is probably the most frequently used section of the entire documentation package. 
A screen shot 
Figure 1 (p. 3289) shows a partial screen shot of what you should see when you first load the API 
Specification into your browser. (Note that this screen shot was cropped to force it to fit into this 
publication format. ) 


Screen shot of the API specification at startup. 


Java™ Platform 
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This document is the API specification for the Java™ Platform, Standard Edition. 
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Figure 12.1: Screen shot of the API specification at startup. 


'http://docs.oracle.com/javase/ tutorial / 
http://docs.oracle.com/javase/tutorial/essential/environment/paths.html 
'3http://docs.oracle.com/javase/7/docs/api/index.html 
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Screen layout 

The purpose of providing this screen shot is to give you an idea of the general layout of the material as 
it appears on your screen. As you can see, the layout consists of three frames when viewed in your HTML 
browser. 

(A version without frames is also available by selecting the "No Frames" link at the top of the page. 
The version without frames is particularly useful for using the "page search" capability of your browser to 
find something on the page.) 

The two leftmost frames 

The upper-left frame contains a list of packages . The lower-left frame contains a list of the classes 
and interfaces that are contained in the package that is selected in the top-left frame. 

(The default package selection in the upper-left frame is "All Classes".) 

You make selections in these two frames (or in the link bar at the top of the page) to control the contents 
of the rightmost frame. 

The rightmost frame 

When you first access the API documentation (and when you select Overview at the top of the page), 
the rightmost frame contains summary information about all of the packages. 

When you select a class in the lower-left frame (such as the JButton class for example) , the rightmost 
frame contains hyperlinked information about that class, including: 


A visual class hierarchy diagram 

Interfaces implemented by the class 

Known subclasses of the class 

Text description of the class 

Summary of nested classes 

Summary of fields defined in the class 

Summary of fields inherited into the class 

Summary and detailed information on constructors defined in the class 
Summary and detailed information on methods defined in the class 
List of methods inherited into the class 


Figure 2 (p. 3291) shows a screen shot of the browser window after selecting the class named JButton in 
the lower-left frame. If you pull down the thumb in the scroll bar on the right side of the browser window, 
you will expose all of the information in the above list. 
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Screen shot of the API documentation after selecting the JButton class. 
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Figure 12.2: Screen shot of the API documentation after selecting the JButton class. 


The link bar at the top of the page 

It can sometimes be difficult to find what you are looking for in the documentation package. Referring 
back to Figure 2 (p. 3291) , you can see a link bar at the top of the page in the rightmost frame. This link 
bar contains the following hyperlinks: 


e Overview - provides summary information about packages (shown in Figure 1 (p. 3289) ). 


e Package - provides a description of the package that contains the class selected in the lower-left 
frame. 

e Class - provides a description of the class selected in the lower-left frame. 

e Use - describes how the class selected in the lower-left frame is used in various packages. 

e Tree - provides detailed inheritance hierarchy information for a selected package. 

e Deprecated - provides a list of material that has been deprecated (may not be supported in future 
versions) 

e Index - provides a hyperlinked alphabetized index of interfaces, classes, constructors, variables, and 
methods. 

e Help - Describes how the API document is organized. 
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The various pages that are displayed by selecting these links can often help you to find what you are looking 
for. Probably the most useful and frequently consulted item in the above list is the Index. 
The alphabetical index 

The alphabetical index can be extremely useful if you know the full or partial spelling of what you are 
looking for, beginning with the first character. 

For example, assume that you remember (or you can surmise from what you know about Java properties) 
that there is a method whose name begins with getSystemLookAndFeel , which returns the name of 
the LookAndFeel class that implements the native look and feel for a particular operating system. You 
can easily look this up under G in the alphabetical index. 

What you will find when you look it up is a brief description of a method named getSystemLookAnd- 
FeelClassName that matches what you are looking for. The name of the method is also a hyperlink 
to the detailed description of the same method as it appears in the documentation for the class named 
UIManager 


12.1.5 A universal documentation format 


The documentation for the API is created using a program named javadoc.exe that is contained in the 
JDK. Therefore, the API documentation for class libraries obtained from outside sources should have the 
same format as that described above (assuming that the documentation was produced using javadoc.exe) . 

However, the program named javadoc.exe only controls the format of the documentation. It does not 
produce the explanatory content. It is the responsibility of the author of the class library to provide that 
content. 


12.1.6 Typical usage of the API documentation 


Typical usage of the API documentation consists of the following steps: 


Open the API documentation in your browser. 
Click the class of interest in the lower-left frame. 
Manually search the rightmost frame for summary information about fields, constructors, or methods 
of interest. 

e Click the name of a field, constructor, or method in the summary section to open a detailed description 
of that field, constructor, or method. 


12.1.7 Summary 


There are several ways to search for useful information in the Oracle documentation. There is no single 
approach that will serve all of your needs to find information in the documentation. You simply need to 
become familiar with the different ways to search for information in the documentation and be prepared to 
use the approach that does the best job in each situation. 


12.1.8 Miscellaneous 
This section contains a variety of miscellaneous information. 


NOTE: Housekeeping material 
e Module name: Java OOP: Java Documentation 


e File: Java3140.htm 
e Published: 11/11/12 
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NOTE: Disclaimers: Financial : Although the Connexions site makes it possible for you to 
download a PDF file for this module at no charge, and also makes it possible for you to purchase a 
pre-printed version of the PDF file, you should be aware that some of the HTML elements in this 
module may not translate well into PDF. 


I also want you to know that, I receive no financial compensation from the Connexions website even 
if you purchase the PDF version of the module. 


In the past, unknown individuals have copied my modules from cnx.org, converted them to Kindle 
books, and placed them for sale on Amazon.com showing me as the author. I neither receive 
compensation for those sales nor do I know who does receive compensation. If you purchase such 
a book, please be aware that it is a copy of a module that is freely available on cnx.org and that it 
was made and published without my prior knowledge. 


Affiliation : I am a professor of Computer Information Technology at Austin Community College 
in Austin, TX. 


-end- 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3284 


Index of Keywords and Terms 


INDEX 


Keywords are listed by the section with that keyword (page numbers are in parentheses). Keywords 
do not necessarily appear in the text of the page. They are merely associated with that section. Ex. 
apples, § 1.1 (1) Terms are referenced by the page they appear on. Ex. apples, 1 


abstract class, § 3.2.1(268), § 3.2.2(276), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 
§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 


§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 


§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 
§ 3.3.12(623 § 3.3.14(633), 
§ 3.3.17(651), 
§ 3.3.20(680), 
, § 3.3.24(736), 
) 
) 
) 


), 
), ( 

§ 3.3.18 : 
801), § 3.3.28(802), 
), ( 

), ( 
) 


iF 

J; 

60), 

§ 3.3.21 oa , 
737), § 3.3.27 

62), § 3.3.32(878), 
), § 3.3.36(917), 
), 


, § 3.3.41 (993), 


6 
6 
8 
8 


78 


§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 


§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 


§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 


§ 4.4.2.1.2(1700 
§ 4.4.2.1.4(1731 
§ 4.4.2.2.1(1775 
§ 4.4.2.2.3(1818 
§ 4.4.2.2.5(1848 

( 

( 

( 


§ 4.4.2.1.3 
§ 4.4.2.1.5 
§ 4.4.2.2.2 
§ 4.4.2.2.4 
§ 4.4.2.3.1 
§ 4.4.2.3.3 
§ 4.4.2.3.5 
§ 4.4.2.4.2 


1712), 
1754), 
1795), 
1834 
1872), 
1902), 
1930), 
1997), 


§ 4.4.2.3.2(1883 
§ 4.4.2.3.4(1916 
§ 4.4.2.4.1(1955 
§ 4.4.2.4.3(2038) 


a Na NNN NN ee 
fe pe et oS, ee fo Go 


) 
) 
) 
), 
) 
) 
) 
) 


abstract method, § 3.2.1(268), § 3.2.2(276), 


§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 
§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 


§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 


§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 
§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 
§ 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
§ 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
§ 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
§ 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
§ 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 
§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 
§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 
§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 
§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834 
§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 
) 
) 
) 
) 


YS Ss DS SS SH 


§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 
§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 
§ 4.4.2.4.3(2038 

accessor, § 3.3.4(509), § 3.3.5(536), § 3.3.6(556) 
accessor methods, § 7.9(3116) 

addMessage, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

Affine Transforms, § 3.3.34(902) 

algorithms, § 3.4.7(1111), § 3.4.8(1122) 
Anatomy of a Game Engine, § 8.1(3275) 
Apache, § 4.5.3(2129) 

arithmetic, § 7.3(2972) 

array, § 2.30(202), § 2.31(215), § 3.4.23(1253) 
arrays, § 7.6(3046), § 7.7(3074) 

ascending order, § 3.4.19(1224) 

assignment, § 7.3(2972) 

assignment compability, § 3.2.1(268), 

§ 3.2.2(276), § 3.2.3(277), § 3.2.4(287), 

§ 3.2.5(288), § 3.2.6(299), § 3.2.7(299), 


jn Bee pe 


) 
) 
) 
), 
) 
) 
) 
) 


gO ara e ee on E ee 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


INDEX 


§ 3.2. a) § 3.2.9(308), § nan 


Ds 
(338), § 3.2.15(339), 
(349), § 3.2.18(361), 
§ 3.2. 220(374), § 3.2.21(374), 
(392), § 3.2.24(405), § 3.2.25(406), 
(428), § 3.2.27(428), 
§ 3.2.29(457), § 3.2.30(458), § 3.3.7(557), 
§ 3.3. See), § 3.3.9(591), § 3.3.10(592), 
), § 3.3.12(623), § 3.3.13(624), 
), § 3.3.15(639), § 3.3.16(640), 
), § 3.3.18(660), § 3.3.19(661), 
), § 3.3.21(691), § 3.3.22(692), 
736), § 3.3.25(737), § 3.3.27(801), 
), § 3.3.30(862), § 3.3.31(863), 
), § 3.3.33(878), § 3.3.35(916), 
), § 3.3.38(958), § 3.3.39(959), 


§ 3.3.45(1028), § 3.3.47(1067), § 4.2.1(1431), 


§ 4.2.2(1433), § 4.2.3(1450), § 4.2.4(1480), 
§ 4.2.5(1489), § 4.2.6(1516), § 4.2.7(1537), 
§ 4.4.2.1.1(1686), (1700) 
§ 4.4.2.1.3(1712), (1731) 
§ 4.4.2.1.5(1754), (1775) 
§ 4.4.2.2.2(1795), .2.3(1818) 
§ 4.4.2.2.4(1834), § 4.4.2.2.5(1848), 
§ 4.4.2.3.1(1872), (1883) 
§ 4.4.2.3.3(1902), (1916) 
§ 4.4.2.3.5(1930), (1955) 
§ 4.4.2.4.9(1997), (2038) 


B behavior, § 3.2.1(268), § 3.2.2(276), 


§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 

§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 


§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 

§ 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
(639) (640), § 3.3.17(651), 
(660) (661), § 3.3.20(680), 
(691), § 3.3.22(692), § 3.3.24(736), 

§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 

§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
(878) (916), § 3.3.36(917), 
(958) (959), § 3.3.41(993), 
(994) ( 


3285 


§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 


§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 


§ eae § 4.2. ie § 4.4.2.1.1(1686), 


Bask Claes: § 3.3.4(509), § 3.3.5(536), 
§ 3.3.6(556) 

bounded type parameters, § 4.3.5(1623), 
§ 4.3.6(1638) 

Brightening, § 3.3.29(838) 

browser, § 5.2.10(2711) 

button, § 4.5.10(2324) 


case, § 3.4.21(1240) 


casting, § 3.2.1(268), § 3.2.2(276), § 3.2.3(277), 


§ 3.2.4(287), § 3.2.5(288), § 3.2.6(299), 
§ 3.2.7(299), § 3.2.8(308), § An, 
§ 3.2.10(317), 
§ 3.2.13(329), § 3.2.14(338), 
§ 3.2.16(349), § 3.2.17(349), 
§ 3.2.19(361), § 3.2.20(374), 
§ 3.2.22(392), § 3.2.23(392), § 3.2.24(405 
§ 3.2.25(406), § 3.2.26(428), 
§ 3.2.28(442), § 3.2.29(457), 


§ 3.3.11(610 
§ 3.3.14(633 
§ 3.3.17(651), § 3.3.18(660 
§ 3.3.20(680), § 3.3.21(691 


), ), § 3.3.12(623 
), (633), ( 
), (651), ( 
), (680), ( 

692), § 3.3.24(736), § 3.3.25(737 
), (802), ( 
), (878), ( 
), (917), ( 
), 


§ 3.3.15(639 


3 
3 


ki 


§ 3.3.28(802), § 3.3.30(862 
§ 3.3.32(878), § 3.3.33(878 
§ 3.3.36(917), § 3.3.38(958), 
§ 3.3.41(993), § 3.3.42(994), 


) 
) 
) 
), 
) 
) 
) 
) 


§ 3.3.44(1027), § 3.3.45(1028), § 3.3.47(1067), 


§ 4.2.1(1431), § 4.2.2(1433), § 4.2.3(1450), 
§ 4.2.4(1480), § 4.2.5(1489), § 4.2.6(1516), 
§ 4.2.7(1537), § 4.4.2.1.1(1686), 

§ 4.4.2.1.2(1700), 


) 

(1731) 

(1775) 

(1818), § 4.4.2.2.4 
§ 4.4.2.2.5(1848), 

(1883) 

(1916) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3286 INDEX 


§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), § 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
§ 4.4.2.4.3(2038), § 7.15(3252) § 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
catch, § 4.5.12(2410) § 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
class, § 3.2.1(268), § 3.2.2(276), § 3.2.3(277), § 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.2.4(287), § 3.2.5(288), § 3.2.6(299), § 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 

§ 3.2.7(299), § 3.2.8(308), § 3.2.9(308), § 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.2.10(317), § 3.2.11(318), § 3.2.12(329), § 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 3.2.13(329), § 3.2.14(338), § 3.2.15(339), § 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 
§ 3.2.16(349), § 3.2.17(349), § 3.2.18(361), § 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 3.2.19(361), § 3.2.20(374), § 3.2.21(374), § 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 

§ 3.2.22(392), § 3.2.23(392), § 3.2.24(405), § 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 

§ 3.2.25(406), § 3.2.26(428), § 3.2.27(428), § 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 

§ 3.2.28(442), § 3.2.29(457), § 3.2.30(458), § 4.4.2.2.3(1818), § 4.4.2.2.4(1834), 

§ 3.3.7(557), § 3.3.8(575), § 3.3.9(591), § 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 

§ 3.3.10(592), § 3.3.11(610), § 3.3.12(623), § 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 

§ 3.3.13(624), § 3.3.14(633), § 3.3.15(639), § 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 

§ 3.3.16(640), § 3.3.17(651), § 3.3.18(660), § 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 

§ 3.3.19(661), § 3.3.20(680), § 3.3.21(691), § 4.4.2.4.3(2038) 

§ 3.3.22(692), § 3.3.24(736), § 3.3.25(737), class variable, § 3.2.1(268), § 3.2.2(276), 

§ 3.3.27(801), § 3.3.28(802), § 3.3.30(862), § 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 3.3.31(863), § 3.3.32(878), § 3.3.33(878), § 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.3.35(916), § 3.3.36(917), § 3.3.38(958), § 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 

§ 3.3.39(959), § 3.3.41(993), § 3.3.42(994), § 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 3.3.44(1027), § 3.3.45(1028), § 3.3.47(1067), § 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 4.2.1(1431), § 4.2.2(1433), § 4.2.3(1450), § 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 4.2.4(1480), § 4.2.5(1489), § 4.2.6(1516), § 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
§ 4.2.7(1537), § 4.4.2.1.1(1686), § 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), § 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), § 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 

§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), § 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 

§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834), § 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), § 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), § 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), § 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), § 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
§ 4.4.2.4.3(2038) § 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
class method, § 3.2.1(268), § 3.2.2(276), § 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), § 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 

§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), § 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), § 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), § 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), § 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), § 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 

§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), § 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 

§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), § 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 

§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), § 4.4.2.2.3(1818), § 4.4.2.2.4(1834), 

§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), § 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 

§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), § 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 

§ 3.3.12(623), § 3.3.13(624), § 3.3.14(633), § 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 

§ 3.3.15(639), § 3.3.16(640), § 3.3.17(651), § 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 

§ 3.3.18(660), § 3.3.19(661), § 3.3.20(680), § 4.4.2.4.3(2038) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


INDEX 


classes, § 2.16(94), § 2.17(97), § 4.5.11(2370), 
§ 7.9(3116) 

classpath, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

Clients and Servers, § 5.2.2(2649), 

§ 5.2.3(2660) 

Clipping Images, § 3.3.43(1013) 

Collection, § 3.4.9(1130), § 3.4.23(1253) 
Collection interface, § 3.4.29(1306), 

§ 3.4.31(1324) 

Collections class, § 3.4.25(1274), § 3.4.27(1289) 
Collections Framework, § 3.4.13(1162) 

color class, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

Colors, § 3.3.29(838) 

command-line arguments, § 2.33(226), 

§ 2.34(230) 

comment, § 2.10(50), § 2.11(56), § 4.5.8(2253) 
common exceptions, § 7.15(3252) 
Communication Protocol, § 5.2.2(2649), 

§ 5.2.3(2660) 

Comparable interface, § 3.4.13(1162), 

§ 3.4.14(1176), § 3.4.15(1186), § 3.4.16(1198), 
§ 3.4.17(1205) 

Comparator, § 3.4.19(1224), § 3.4.21(1240), 
§ 3.4.23(1253), § 3.4.27(1289) 

Comparator interface, § 3.4.15(1186), 

§ 3.4.17(1205), § 3.4.18(1218), § 3.4.20(1235) 
Comparator object, § 3.4.25(1274) 
comparing objects, § 7.14(3232) 
concatenation, § 7.5(3026) 

concrete implementations, § 3.4.3(1087), 

§ 3.4.4(1093), § 3.4.7(1111), § 3.4.8(1122), 

§ 3.4.10(1140), § 3.4.12(1154) 

consistent with equals, § 3.4.15(1186) 
constructor, § 3.2.1(268), § 3.2.2(276), 

§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 


§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 


§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 
§ 3.3.12(623 
§ 3.3.15(639 
§ 3.3.18(660 
§ 3.3.21(691 


) 
, § 3.3.16(640), § 3.3.17(651 
, § 3.3.19(661), § 3.3.20(680 
, § 3.3.22(692), § 3.3.24(736), 


Nae Na 


3287 
§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
§ 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 
§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 


§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 

§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 

§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 
§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 
§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834 
§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 
§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 
§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 
§ 4.4.2.4.3(2038) 

constructors, § 7.9(3116) 

contract, § 3.4.5(1098), § 3.4.6(1104) 
control structures, § 7.4(3000) 

cookies, § 4.5.13(2455), § 4.5.14(2519), 

§ 5.4.8(2871), § 5.4.9(2893) 

Cookies with JSP, § 4.5.4(2142) 

core collection interfaces, § 3.4.7(1111), 

§ 3.4.8(1122), § 3.4.10(1140), § 3.4.12(1154) 
core interfaces, § 3.4.5(1098), § 3.4.6(1104), 
§ 3.4.9(1130) 

Cropping, § 3.3.23(721) 

CSS, § 4.5.6(2176) 


) 
) 
) 
), 
) 
) 
) 
) 


aN NN NNN a 


Darkening, § 3.3.29(838) 

data structures, § 3.4.1(1068), § 3.4.2(1079), 
§ 3.4.3(1087), § 3.4.4(1093) 

data types, § 2.12(60), § 2.13(73) 

datalist, § 4.5.10(2324) 

Declaration, § 4.5.8(2253) 

deploying, § 5.4.1(2771), § 5.4.2(2793) 
deployment, § 4.5.3(2129) 

descending order, § 3.4.21(1240) 

Directive, § 4.5.8(2253) 

documentation, § 12.1(3287) 

Domain Name, § 5.2.2(2649), § 5.2.3(2660) 
Duplicate Elements, § 3.4.11(1147), 

§ 3.4.12(1154) 


elements, § 3.4.27(1289) 

encapsulation, § 3.2.1(268), § 3.2.2(276), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 
§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3288 


§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575) 


j; ), § 3.3.14(633), 
), § 3.3.16(640), § 3.3.17(651), 
§ 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
§ 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
§ 3.3.25(737), § 3.3.27(801), § 3.3.28(80 
} ) (8 
J; ) ( 
) ) 


§ 3.3.15(639 ( 

( ( 

( ( 

(7 ( 2 {$ 
§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878 

( ( 

( ( 

( ( 


69 

) 
862 ), 
§ 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.3.38(958), § 3.3.39(959), § 3.3.41 (993), 


§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 


§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 


§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 


§ 4.4.2.1.2(1700), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5 
§ 4.4.2.2.1(1775), § 4.4.2.2.2 
§ 4.4.2.2.3(1818), § 4.4.2.2.4 


), § 4.4.2.1.3 

) 

| 
§ 4.4.2.2.5(1848), § 4.4.2.3.1 

) 

) 

) 

) 


1712), 
1754), 
1795), 
1834 
1872), 
1902), 
1930), 
1997), 


§ 4.4.2.3.2(1883), § 4.4.2.3.3 
§ 4.4.2.3.4(1916), § 4.4.2.3.5 
§ 4.4.2.4.1(1955), § 4.4.2.4.2 
§ 4.4.2.4.3(2038 


) 
) 
) 
), 
) 
) 
) 
) 


fo pe 


Ericson, § 3.3.4(509), § 3.3.5(536), § 3.3.6(556) 


escape characters, § 7.6(3046) 
event handling, § 4.4.1(1685), § 4.4.3(2061) 
exception handling, § 2.32(223) 

exceptions, § 7.14(3232) 

Expression, § 4.5.8(2253) 

expressions, § 2.26(171), § 2.27(174) 
extending classes, § 7.12(3177) 

extends, § 3.2.1(268), § 3.2.2(276), 

§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 

§ 3.2.12(329), 3.2.14(338), 
§ 3.2.15(339), ( 3.2.17(349), 
§ 3.2.18(361), ( 3.2.20(374 
§ 3.2.21(374), § 3.2.22(392 3.2.23(392 
§ 3.2.24(405), ( 3.2.26(428 
§ 3.2.27(428), 3.2.29(457 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 
§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 
§ 3.3.12(623), § 3.3.13(624), 
§ 3.3.15(639), § 3.3.16(640), § 3.3.17(651 
§ 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
§ 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 


Liron 


Nae Na 


INDEX 


§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
§ 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 
§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 


§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 


§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 


§ 4.4.2.1.2(1700 
§ 4.4.2.1.4(1731 
§ 4.4.2.2.1(1775), 
§ 4.4.2.2.3(1818 
§ 4.4.2.2.5(1848 

( 

( 

( 


§ 4.4.2.1.3 
§ 4.4.2.1.5 
§ 4.4.2.2.9 
§ 4.4.2.2.4 
§ 4.4.2.3.1 
§ 4.4.2.3.3 
§ 4.4.2.3.5 
§ 4.4.2.4.2 


1712), 
1754), 
1795), 
1834 
1872), 
1902), 
1930), 
1997), 


§ 4.4.2.3.2(1883 
§ 4.4.2.3.4(1916), 
§ 4.4.2.4.1(1955), 
§ 4.4.2.4.3(2038) 

extract, § 3.4.23(1253) 


) 
) 
) 
), 
) 
) 
) 
) 


aN NNN NN a 
PS nN ee ee 


File, § 4.5.12(2410) 
FileWriter, § 4.5.12(2410) 
final, § 3.2.1(268), § 3.2.2(276), § 3.2.3(277), 
§ 3.2.4(287), § 3.2.5(288), § 3.2.6(299), 
§ 3.2.7(299), § 3.2.8(308), § 3.2.9(308), 
§ 3.2.10(317), § 3.2.11(318), § 3.2.12(329), 
§ 3.2.13(329), § 3.2.14(338), § 3.2.15(339), 
§ 3.2.16(349), § 3.2.17(349), § 3.2.18(361), 
3.2.19(361), § 3.2.20(374), § 3.2.21(374), 
§ 3.2.22(392), § 3.2.23(392), § 3.2.24(405), 
§ 3.2.25(406), § 3.2.26(428), § 3.2.27(428), 
§ 3.2.28(442), § 3.2.29(457), § 3.2.30(458), 
§ 3.3.7(557), § 3.3.8(575), § 3.3.9(591), 
§ 3.3.10(592), § 3.3.11(610), § 3.3.12(623), 
§ 3.3.13(624), § 3.3.14(633), § 3.3.15( 
§ 3.3.16(640), § 3.3.17(651), § 3.3.18( 
§ 3.3.19(661), § 3.3.20(680), § 3.3.21( 
§ 3.3.22(692), § 3.3.24(736), § 3.3.25(7 
§ 3.3.27(801), § 3.3.28(802), § 3.3.30( 
(863) (878) ( 
(916) (917) ( 
(959) 


9), 
0), 
1), 


37), 


63 
66 
69 
862), 
§ 3.3.31(863), § 3.3.32(878), § 3.3.33(878), 
§ 3.3.35(916), § 3.3.36(917), § 3.3.38(958), 


§ 3.3.39(959), § 3.3.41(993), § 3.3.42(994), 


§ 3.3.44(1027), § 3.3.45(1028), § 3.3.47(1067), 


§ 4.2.1(1431), § 4.2.2(1433), § 4.2.3(1450), 
§ 4.2.4(1480), § 4.2.5(1489), § 4.2.6(1516), 
§ 4.2.7(1537), § 4.4.2.1.1(1686), 

§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 

§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 

§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 

§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834), 

§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 
§ 4.4.2.3.2(1883), ( ) 
§ 4.4.2.3.4 ) (1930) 


§ 4.4.2.3.3(1902), 
§ 4.4.2.3.5(1930), 


ee Sore Yamane, Soe Se 


1916), 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


INDEX 


§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 

§ 4.4.2.4.3(2038) 

final Keyword, § 7.10(3136) 

Firewall, § 5.2.2(2649), § 5.2.3(2660) 
Flipping, § 3.3.23(721) 

flow of control, § 2.28(178), § 2.29(194) 
Form Processing, § 4.5.9(2286) 

Form Processing with JSP, § 4.5.4(2142) 
frameworks, § 5.5.1(2944) 


general behavior, § 3.4.5(1098), § 3.4.6(1104) 
generic methods, § 4.3.4(1614), § 4.3.5(1623), 
§ 4.3.6(1638) 

generic types, § 4.3.3(1599) 

Generics, § 4.3.1(1558), § 4.3.2(1581), 

§ 4.3.6(1638), § 4.3.7(1653), § 4.3.8(1667) 
getPicture, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

getter method, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

GradientPaint, § 3.3.40(981) 

Green-Screen, § 3.3.26(773) 

Greenfoot, § 11.1(3281) 

Guzdial, § 3.3.4(509), § 3.3.5(536), § 3.3.6(556) 
Guzdial-Ericson Multimedia Class Library, 

§ 3.3.1(483), § 3.3.2(501), § 3.3.3(508) 


Hello World, § 2.14(81), § 2.15(88) 

hidden fields, § 5.4.5(2814), § 5.4.6(2838) 
HTML, § 4.5.6(2176) 

HTML and CSS Fundamentals, § 4.5.4(2142) 
hyperlink, § 5.3.2(2765) 


ignoring case, § 3.4.19(1224) 
Images, § 3.3.34(902) 


implements, § 3.2.1(268), § 3.2.2(276), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 


§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 


§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 


§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 

§ 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
§ 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
§ 3.3.18(660), § 3.3.19(661), § 3.3.20(680) 
§ 3.3.21(691), § 3.3.22(692), § 3.3.24(736) 
§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 


3 
3 


3289 


§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878 
§ 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 
§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 
§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 
§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 
§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834 
§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 
( ( 
( ( 
( ( 


), 
) 


§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 

§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 

§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 

§ 4.4.2.4.3(2038) 

import directive, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

import directives, § 7.14(3232) 

increment operator, § 7.4(3000) 

INEW2338, § 5.1.1(2647) 

inheritance, § 3.2.1(268), § 3.2.2(276), 

§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 

§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338 

§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349 

§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374 

§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392 
(405), ( ( 
(428), 

J; 


aN Saa Sa Saai S Sa Sai 


) 
) 
) 
), 
) 
) 
) 
) 


3 
a 
3 


i 


§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 
§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 
§ 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
§ 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
§ 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
§ 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 

(878), (917) 

(958), 

( 


3 


ji 


Wwe Dow KH at 
NNN Saa S 


§ 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.3.38(958), § 3.3.39(959), § 3.3.41 (993), 
§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 
§ 4.2.6(1516), § 4.2.7(1537), § 4.3.6(1638), 
§ 4.4.2.1.1(1686), § 4.4.2.1.2(1700), 
§ 4.4.2.1.3(1712), § 4.4.2.1.4(1731), 
§ 4.4.2.1.5(1754), § 4.4.2.2.1(1775 
§ 4.4.2.2.2(1795), § 4.4.2.2.3(1818), 
( 
( 


SB NS DS SS a 


§ 4.4.2.2.4(1834), § 4.4.2.2.5(1848), 


) 
) 
), 
| 
§ 4.4.2.3.1(1872), § 4.4.2.3.2(1883), 


We Dm Dae wee a 
JRE ee Bo N, 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3290 INDEX 


§ 4.4.2.3.3(1902), § 4.4.2.3.4(1916), § 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
§ 4.4.2.3.5(1930), § 4.4.2.4.1(1955), § 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
§ 4.4.2.4.2(1997), § 4.4.2.4.3(2038) § 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
inheritance structure, § 3.4.9(1130) § 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
inner class, § 3.2.1(268), § 3.2.2(276), § 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), § 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), § 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), § 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 

§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), § 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), § 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), § 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), § 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), § 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 

§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), § 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 

§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), § 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 

§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), § 4.4.2.2.3(1818), § 4.4.2.2.4(1834), 

§ 3.3.12(623), § 3.3.13(624), § 3.3.14(633), § 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 

§ 3.3.15(639), § 3.3.16(640), § 3.3.17(651), § 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 

§ 3.3.18(660), § 3.3.19(661), § 3.3.20(680), § 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 

§ 3.3.21(691), § 3.3.22(692), § 3.3.24(736), § 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 

§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), § 4.4.2.4.3(2038) 

§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878), instance iariables, § 7.11(3154) 

§ 3.3.33(878), § 3.3.35(916), § 3.3.36(917), instance method, § 3.2.1(268), § 3.2.2(276), 
§ 3.3.38(958), § 3.3.39(959), § 3.3.41(993), § 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), § 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), § 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 

§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), § 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), § 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), § 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), § 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), § 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834), § 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), § 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 

§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), § 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 

§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), § 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), § 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
§ 4.4.2.4.3(2038) § 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
input, § 4.5.10(2324) § 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
input element, § 4.5.10(2324) § 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
instance, § 3.2.1(268), § 3.2.2(276), § 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), § 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), § 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 

§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), § 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), § 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), § 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), § 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), § 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 

§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), § 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 

§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), § 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 

§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), § 4.4.2.2.3(1818), § 4.4.2.2.4(1834), 

§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), § 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


INDEX 3291 


§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), § 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), § 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), § 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
§ 4.4.2.4.3(2038) § 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
instance variable, § 3.2.1(268), § 3.2.2(276), § 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), § 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), § 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 

§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), § 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), § 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), § 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), § 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), § 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 

§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), § 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 

§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), § 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 

§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), § 4.4.2.2.3(1818), § 4.4.2.2.4(1834), 

§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), § 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 

§ 3.3.12(623), § 3.3.13(624), § 3.3.14(633), § 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 

§ 3.3.15(639), § 3.3.16(640), § 3.3.17(651), § 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 

§ 3.3.18(660), § 3.3.19(661), § 3.3.20(680), § 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 

§ 3.3.21(691), § 3.3.22(692), § 3.3.24(736), § 4.4.2.4.3(2038) 

§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), interface, § 3.2.1(268), § 3.2.2(276), 

§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878), § 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 3.3.33(878), § 3.3.35(916), § 3.3.36(917), § 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.3.38(958), § 3.3.39(959), § 3.3.41(993), § 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 

§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), § 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), § 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), § 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), § 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), § 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), § 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), § 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 

§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834), § 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 

§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), § 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), § 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), § 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), § 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
§ 4.4.2.4.3(2038) § 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
instance variables, § 2.22(118), § 2.23(132) § 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
instantiate, § 3.2.1(268), § 3.2.2(276), § 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), § 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 

§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), § 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), § 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), § 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), § 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), § 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 

§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), § 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 

§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), § 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 

§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), § 4.4.2.2.3(1818), § 4.4.2.2.4(1834), 

§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), § 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 

§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), § 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 

§ 3.3.12(623), § 3.3.13(624), § 3.3.14(633), § 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3292 


§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 

§ 4.4.2.4.3(2038) 

Interface Specialization, § 3.4.11(1147), 
§ 3.4.12(1154) 

interfaces, § 3.4.3(1087), § 3.4.4(1093), 
§ 7.13(3198) 

interfaces., § 3.4.9(1130) 

ip, § 5.2.2(2649), § 5.2.3(2660) 

IP Address, § 5.2.2(2649), § 5.2.3(2660) 
ITSE 2317, § 4.1.1(1429), § 4.4.1(1685) 
ITSE 2321, § 3.1.1(265) 


Java, § 1.1(1), § 2.2(7), § 2.3(11), § 2.4(17), 
§ 2.5(21), § 2.6(25), § 2.7(32), § 2.8(36), 
§ 2.9(45), § 2.10(50), § 2.11(56), § 2.12(60), 
§ 2.13(73), § 2.14(81), § 2.15(88), § 2.16(94), 
§ 2.17(97), § 2.18(100), § 2.19(104), 
§ 2.20(108), § 2.21(112), § 2.22(118), 
§ 2.23(132), § 2.24(144), § 2.25(154), 
§ 2.26(171), § 2.27(174), § 2.28(178), 
§ 2.29(194), § 2.30(202), § 2.31(215), 
(223) ( (230) 
(234) 
) 


3 


bi = 


), 
7), 
108 
132 
171 


§ 2.32(223), § 2.33(226), § 2.34(230), 
§ 2.35(234), § 2.36(243), § 2.37(254), 
§ 2.38(263), § 3.1.1(265), § 3.2.1(268), 
§ 3.2.2(276), § 3.2.3(277), § 3.2.4(287), 
§ 3.2.5(288), § 3.2.6(299), § 3.2.7(299), 
§ 3.2.8(308), § 3.2.9(308), § 3.2.10(317), 
3.2.11(318), § 3.2.12(329), 
§ 3.2.14(338), § 3.2.15(339), § 3.2.16 
) 
) 
} 
), 


),8 
),§ 
),8 
),8 
),8 
),§ 


Ur LOD LOD LOD LOD LOD 


J; 
(338) ( (34 
§ 3.2.17(349), § 3.2.18(361), § 3.2.19( 
§ 3.2.20(374), § 3.2.21(374), § 3.2.22( 
§ 3.2.23(392), § 3.2.24(405), § 3.2.25( 
§ 3.2.26(428), § 3.2.27(428), § 3.2.28(4 
§ 3.2.29(457), § 3.2.30(458), § 3.3.4(509), 
§ 3.3.5(536), § 3.3.6(556), § 3.3.7(557), 
§ 3.3.8(575), § 3.3.9(591), § 3.3.10(592), 
§ 3.3.11(610), § 3.3.12(623), § 3.3.13(624), 
§ 3.3.14(633), § 3.3.15(639), § 3.3.16(640), 
§ 3.3.17(651), § 3.3.18(660), § 3.3.19(661), 
§ 3.3.20(680), § 3.3.21(691), § 3.3.22(692), 
§ 3.3.23(721), § 3.3.24(736), § 3.3.25(737), 
§ 3.3.26(773), § 3.3.27(801), § 3.3.28(802), 
§ 3.3.29(838), § 3.3.30(862), § 3.3.31(863), 
§ 3.3.32(878), § 3.3.33(878), § 3.3.35(916), 
(917), § 3.3.37(944), § 3.3.38(958), 
(959), § 3.3.40(981), § 3.3.41(993), 
(994), § 3.3.43(1013), § 3.3.44(1027), 


§ 3.3.36(917), 
§ 3.3.39(959), 
§ 3.3.42(994), 


§ 3.3.45(1028), § 3.3.46(1047), § 3.3.47(1067), 


§ 4.1.1(1429 
§ 4.2.3(1450 
§ 4.2.6(1516 
§ 4.3.2(1581 


§ 4.2.1(1431), § 4.2.2(1433), 
§ 4.2.4(1480), § 4.2.5(1489), 
§ 4.2.7(1537), § 4.3.1(1558), 
, § 4.3.3(1599), § 4.3.5(1623), 


Ve Dmwawa_ 


INDEX 


§ 4.3.6(1638), § 4.3.7(1653), § 4.3.8(1667), 
§ 4.4.1(1685), § 4.4.2.1.1(1686), 


§ 4.4.2.1.2(1700), 


§ 4.4.2.1.4(1731 


§ 4.4.2.2.1(1775), 


( 

( 

§ 4.4.2.2.3(1818 

§ 4.4.2.2.5(1848 

§ 4.4.2.3.2(1883 

§ 4.4.2.3.4(1916 
( 


§ 4.4.2.4.1(1955), 


nN NNN NN Sl 


§ 4.4.2.1.3(1712), 
§ 4.4.2.1.5(1754), 
§ 4.4.2.2.2(1795), 
§ 4.4.2.2.4(1834 

§ 4.4.2.3.1(1872), 
§ 4.4.2.3.3(1902), 
§ 4.4.2.3.5(1930), 


) 
) 
) 
), 
) 
| 
§ 4.4.2.4.2(1997), 


§ 4.4.2.4.3(2038), § 4.4.3(2061), § 4.5.2(2104), 
§ 4.5.14(2519), § 5.2.10(2711), § 5.2.11(2740), 
§ 5.2.12(2759), § 5.4.8(2871), § 5.4.9(2893), 

§ 5.4.10(2898), § 5.4.11(2941), § 5.5.1(2944), 
§ 7.1(2949), § 7.2(2950), § 7.3(2972), 

§ 7.4(3000), § 7.5(3026), § 7.6(3046), 

§ 7.7(3074), § 7.8(3099), § 7.9(3116), 

§ 7.10(3136), § 7.11(3154), § 7.12(3177), 

§ 7.13(3198), § 7.14(3232), § 7.15(3252), 

§ 11.1(3281), § 12.1(3287) 

Java classes, § 4.5.12(2410) 

Java collection, § 3.4.3(1087), § 3.4.4(1093) 
Java Collections framework, § 3.4.1(1068), 

§ 3.4.2(1079), § 3.4.5(1098), § 3.4.6(1104), 

§ 3.4.7(1111), § 3.4.8(1122), § 3.4.10(1140), 

§ 3.4.11(1147), § 3.4.12(1154) 

Java Collections Framework., § 3.4.3(1087), 

§ 3.4.4(1093) 

Java servlets, § 5.4.1(2771), § 5.4.2(2793), 

§ 5.4.3(2795), § 5.4.4(2808) 

Java., § 4.3.4(1614) 

Java2D, § 3.3.40(981) 

javadoc, § 12.1(3287) 

javadoc comments and directives, § 7.15(3252) 
JavaServer Pages, § 4.5.7(2231) 

JSP, § 4.5.1(2103), § 4.5.2(2104), 

§ 4.5.4(2142), § 4.5.7(2231), § 4.5.8(2253), 

§ 4.5.9(2286), § 4.5.11(2370), § 4.5.13(2455), 
§ 4.5.14(2519), § 4.5.15(2588), § 5.4.5(2814), 
§ 5.4.6(2838), § 5.4.7(2841) 

JSP Assessment Questions, § 4.5.16(2642) 
JSP Fundamentals, § 4.5.4(2142) 

JSP., § 4.5.3(2129) 


List, § 3.4.13(1162), § 3.4.25(1274), 

§ 3.4.27(1289) 

List object, § 3.4.11(1147) 

local variables, § 2.22(118), § 2.23(132) 
logical operations, § 7.5(3026) 

loop, § 2.5(21) 


M main method, § 2.18(100), § 2.19(104), 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


INDEX 


§ 3.3.4(509), § 3.3.5(536), § 3.3.6(556) 
Map, § 3.4.9(1130) 
Mathematical Applications for Game 
Development, § 6.1(2947) 
member variables, § 2.22(118), § 2.23(132) 
Merging Pictures, § 3.3.46(1047) 
method, § 2.8(36), § 2.9(45), § 3.2.1(268), 
§ 3.2.2(276), § 3.2.3(277), § 3.2.4(287), 
§ 3.2.5(288), § 3.2.6(299), § 3.2.7(299), 
§ 3.2.8(308), § 3.2.9(308), § 3.2.10(317), 
§ 3.2.11(318), § 3.2.12(329), § 3.2.13(329 
§ 3.2.14(338), § 3.2.15(339), § 3.2.16(349 
§ 3.2.17(349), § 3.2.18(361), § 3.2.19(361 
§ 3.2.20(374), § 3.2.21(374), § 3.2.22(392 
§ 3.2.23(392), § 3.2.24(405), § 3.2.25(406 

(428) (428) 

) ) 


Wwe Dees EK a 


§ 3.2.26(428), § 3.2.27(428), § 3.2.28(442 
§ 3.2.29(457), $ o 


§ 3.3.11(610), 
§ 3.3.14(633), 
§ 3.3.17(651 


), § 3.3.12(623), 
(633), § 3.3.15(639), ( 
(651), § 3.3.18(660), ( 
§ 3.3.20(680), § 3.3.21(691), ( 
§ 3.3.24(736), § 3.3.25(737), § 3.3. 3.271801 i 
§ 3.3.28(802), § 3.3.30(862), ( 
§ 3.3.32(878), § 3.3.33(878), ( 
§ 3.3.36(917), § 3.3.38(958), ( 
§ 3.3.41(993), § 3.3.42(994), § 3.3.44(1027), 


§ 3.3.45(1028), § 3.3.47(1067), § 4.2.1(1431), 


§ 4.2.2(1433), § 4.2.3(1450), § 4.2.4(1480), 
§ 4.2.5(1489), 42 8818), § 4.2.7(1537), 
§ 4.4.2.1.1(1686), .2(1700) 
§ 4.4.2.1.3(1712), (1731) 
§ 4.4.2.1.5(1754), .1(1775) 
§ 4.4.2.2.2(1795), .3(1818) 
§ 4.4.2.2.4(1834), § 4.4.2.2. 2.51848), 
§ 4.4.2.3.1(1872), .2(1883) 
§ 4.4.2.3.3(1902), 4(1916) 
§ 4.4.2.3.5(1930), .1(1955) 

-3(2038) 


method pterloading: $ 3. 2. 1(268), § 3.2.2(276), 


§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 
§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 


§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 


§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 


3293 


§ 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
§ 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
§ 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
§ 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
§ 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 
§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 


§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 


§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 


§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 


§ 4.4.2.1.2(1700 
§ 4.4.2.1.4(1731 


), § 4.4.2.1.3(1712), 

(1731), § 4.4.2.1.5(1754), 

§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 

§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834 

§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 

§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 

§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 

§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 
§ 4.4.2.4.3(2038), § 7.8(3099) 


) 
) 
) 
), 
) 
) 
) 
) 


method overriding, § 3.2.1(268), § 3.2.2(276), 


§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 
§ 3.2.9(308), § 3.2.10(317), § 3.2. a) 
§ 3.2.12(329), § 3.2.13(329), 

§ 3.2.15(339), § 3.2.16(349), ( 

§ 3.2.18(361), § 3.2.19(361), ( 

§ 3.2.21(374), § 3.2.22(392), § 3.2. 2.23(392 
§ 3.2.24(405), § 3.2.25(406), ( 

§ 3.2.27(428), § 3.2.28(442), 

§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 
§ 3.3.9(591), § ee § 3.3. eto) 


§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 


§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 


§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 


§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 
§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795 
§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834), 
(1848), ( 
(1883), ( 


§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 


) 
) 
), 
§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3294 


§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 

§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 

§ 4.4.2.4.3(2038) 

methods, § 3.4.5(1098), § 3.4.6(1104) 
Mirroring Image, § 3.3.37(944) 


moveTo, § 3.3.4(509), § 3.3.5(536), § 3.3.6(556) 


natural order, § 3.4.19(1224) 
natural ordering of the elements, 
§ 3.4.15(1186) 

network, § 5.2.10(2711) 


Network Layers, § 5.2.2(2649), § 5.2.3(2660) 


network programming, § 5.2.1(2649) 
null reference, § 7.15(3252) 
numeric casting, § 7.5(3026) 


object, § 3.2.1(268), § 3.2.2(276), § 3.2.3(277), 


§ 3.2.4(287), § 3.2.5(288), § 3.2.6(299), 
§ 3.2.7(299), § 3.2.8(308), § 3.2.9(308), 
§ 3.2.10(317), 
§ 3.2.13(329), § 3.2.14(338), 
§ 3.2.16(349), § 3.2.17(349), 
§ 3.2.19(361), § 3.2.20(374), 
§ 3.2.22(392), § 3.2.23(392), § 3.2.24(405), 
§ 3.2.25(406), (428) 
§ 3.2.28(442), ) 


§ 3.2.26(428), 


), § 3.3.11(610), 
), § 3.3.14(633), ( 
), § 3.3.17(651), ( 
), § 3.3.20(680), ( 
692), § 3.3.24(736), § 3.3. 3.25737 
), § 3.3.28(802), ( 
), § 3.3.32(878), ( 
), § 3.3.36(917), ( 
), § 3.3.41(993), § 3.3.42(994), 


§ 3.3.44(1027), § 3.3.45(1028), § 3.3.47(1067), 


§ 4.2.1(1431), § 4.2.2(1433), § 4.2.3(1450), 
§ 4.2.4(1480), § 4.2.5(1489), § 4.2.6(1516), 


INDEX 


§ 2.6(25), § 2.7(32), § 2.8(36), § 2.9(45), 
§ 2.10(50), § 2.11(56), § 2.12(60), § 2.13(73 
§ 2.14(81), § 2.15(88), § 2.16(94), § 2.17(97 


( 
§ 2.18(100), § 2.19(104), § 2.20(108), 
§ 2.21(112), § 2.22(118), § 2.23(132), 
§ 2.24(144), § 2.25(154), § 2.26(171), 
§ 2.27(174), § 2.28(178), § 2.29(194), 
§ 2.30(202), § 2.31(215), § 2.32(223), 
§ 2.33(226), § 2.34(230), § 2.35(234), 
§ 2. Oe) § 2.37(254), § 2.38(263), 


§ 3.2.1(268), 

§ 3.2.4(287), § 3.2.5(288 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.2.10(317), § 3.2.11(318), 


6), 
) 


3 


§ 3.2.12(329 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20 


), § 3.2.13(329), 
(339) (349), ( 
(361) (361), ( 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392 
(405) (406), ( 
(428) ), 
) 


§ 3.2.14(338 


§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457 
§ 3.2.30(458), § 3.3.4(509), § 3.3.5(536), 
§ 3.3.6(556), § 3.3.7(557), § 3.3.8(575), 

§ ey § 3.3.10(592), § 3.3. Te) 
), § 3.3.13(624), 

), § 3.3.16(640), ( 

), § 3.3.19(661), ( 

), § 3.3.22(692), ( 
737), § 3.3.27(801), § 3.3. 3.28(802 
), § 3.3.31 (863), ( 

) (916), ( 

) (959), 

), ( 


NNN 


§ 3.3.35(916 
§ 3.3.39(959), § 3.3. 41(993), 
§ 3.3.47(1067), § 3.4.1(1068), § 3.4.2(1079), 
§ 4.1.1(1429), § 4.2.1(1431), § 4.2.2(1433), 
§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 
§ 4.2.6(1516), § 4.2.7(1537), § 4.4.1(1685), 


§ 4.2.7(1537), § 4.4.2.1.1(1686), 


§ 4.4.2.1.2(1700), 
, § 4.4.2.1.5(1754), 


§ 4.4.2.1.4(1731 


§ 4.4.2.2.1(1775), 
§ 4.4.2.2.3(1818), 


§ 4.4.2.1.3(1712), 


§ 4.4.2.2.2(1795), 
§ 4.4.2.2.4(1834 


§ 4.4.2.1.1(1686 
§ 4.4.2.1.3(1712 
§ 4.4.2.1.5(1754 
§ 4.4.2.2.2(1795 


§ 4.4.2.3.1(1872 


§ 4.4.2.3.5(1930 


§ 4.4.2.1.2(1700), 
§ 4.4.2.1.4(1731), 
§ 4.4.2.2.1(1775), 
§ 4.4.2.2.3(1818 
§ 4.4.2.3.2(1883), 
§ 4.4.2.3.4(1916), 


) 
) 
) 
), 
) 
) 
) 
§ 4.4.2.4.1(1955), 


§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 
§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 
§ 4.4.2.4.3(2038) 

object-oriented programming, § 1.1(1), 
§ 2.2(7), § 2.3(11), § 2.4(17), § 2.5(21), 


) ) 

(1731) (1754) 

(1775) (1795) 

(1818) (1834), 

§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 
(1883) (1902) 

(1916) (1930) 

(1955) (1997) 


)s ( 
), ( 
j aa22al 
§ 4.4.2.2.4(1834), § 4.4.2.2.5(1848 
), ( 
i ( 
) ( 
), ( 


§ 4.4.2.4.2(1997 
§ 7.2(2950), § 7.3(2972), § 7.4(3000), 

§ 7.5(3026), § 7.6(3046), § 7.7(3074), 

§ 7.8(3099), § 7.9(3116), § 7.10(3136), 

§ 7.11(3154), § 7.12(3177), § 7.13(3198), 
§ 7.14(3232), § 7.15(3252) 

objects, § 4.5.11(2370) 


( 
( 
( 
) 
§ 4.4.2.3.3(1902 
( 
( § 4.4.2.4.3(2038), 
), 
i 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


), 
), 


§ 3.3.44(1027), § 3.3.45(1028), 


INDEX 


OOP, § 1.1(1), § 2.2(7), § 2.6(25), § 2.7(32), 
§ 2.8(36), § 2.9(45), § 2.10(50), § 2.11(56), 
§ 2.14(81), § 2.15(88), § 2.16(94), § 2.17(97), 
§ 2.18(100), § 2.19(104), § 2.20(108), 
§ 2.21(112), § 2.22(118), § 2.23(132), 
§ 2.24(144), § 2.25(154), § 3.1.1(265), 
§ 3.2.1(268), § 3.2.2(276), § 3.2.3(277 
§ 3.2.4(287), § 3.2.5(288), § 3.2.6(299 
), § 3. 3.2.9(308), 


§ 3.2.7(299), § 3.2.8(308), 
§ 3.2.11(318), § 3.2.12(329), 


), 8 

), 8 

§ 

§ 3.2.10(317 ), 
§ 3.2.14(338), § 3.2.15(339), 

), 

), 

), 

), 


), 
) 


3 3 


I ) 
§ 3.2.13(329), ( (339) 
§ 3.2.16(349), § 3.2.17(349), § 3.2.18(361), 
§ 3.2.19(361), § 3.2.20(374), § 3.2.21(374), 
§ 3.2.22(392), § 3.2.23(392), § 3.2.24(405), 
§ 3.2.25(406), § 3.2.26(428), § 3.2.27(428), 
§ 3.2.28(442), § 3.2.29(457), § 3.2.30(458), 
§ 3.3.4(509), § 3.3.5(536), § 3.3.6(556), 
§ 3.3.7(557), § 3.3.8(575), § 3.3.9(591), 
§ 3.3.10(592), § 3.3.11(610), § 3.3.12(623), 
§ 3.3.13(624), § 3.3.14(633), § 3.3.15(639), 
§ 3.3.16(640), § 3.3.17(651), § 3.3.18(660), 
§ 3.3.19(661), § 3.3.20(680), § 3.3.21(691), 
§ 3.3.22(692), § 3.3.24(736), § 3.3.25(737), 
§ 3.3.27(801), § 3.3.28(802), § 3.3.30(862), 
§ 3.3.31(863), § 3.3.32(878), § 3.3.33(878), 
§ 3.3.35(916), § 3.3.36(917), § 3.3.37(944), 
§ 3.3.38(958), § 3.3.39(959), § 3.3.40(981), 
§ 3.3.41(993), § 3.3.42(994), § 3.3.43(1013), 
§ 3.3.44(1027), § 3.3.45(1028), § 3.3.46(1047), 
§ 3.3.47(1067), § 4.1.1(1429), § 4.2.1(1431), 
§ 4.2.2(1433), § 4.2.3(1450), § 4.2.4(1480), 
§ 4.2.5(1489), § 4.2.6(1516), § 4.2.7(1537), 
§ 4.4.1(1685), § 4.4.2.1.1(1686), 
§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 
§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 
§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834 
§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 
§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 

a5 ( 

), ( 

), ) 


E at Sa Naaa h a S Sa l 


§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 
§ 4.4.2.4.3(2038), § 7.1(2949), § 7.2(2950), 

§ 7.3(2972), § 7.4(3000), § 7.5(3026), 

§ 7.6(3046), § 7.7(3074), § 7.8(3099), 

§ 7.9(3116), § 7.10(3136), § 7.11(3154), 

§ 7.12(3177), § 7.13(3198), § 7.14(3232), 

§ 7.15(3252), § 12.1(3287) 

operators, § 2.24(144), § 2.25(154), § 7.3(2972) 
option, § 4.5.10(2324) 

optional methods, § 3.4.9(1130) 

Ordered Collections, § 3.4.11(1147), 


) 
) 
) 
), 
) 
) 
) 
) 


KEA SE ee ee ee ee ee ee N 


3295 


§ 3.4.11(1147), § 3.4.12(1154) 
overriding methods, § 7.12(3177) 


P packages, § 2.35(234), § 7.14(3232) 


pagerank, § 5.3.2(2765) 

Picture, § 3.3.29(838) 

Picture class, § 3.3.4(509), § 3.3.5(536), 
§ 3.3.6(556) 

Pictures, § 3.3.23(721) 

polymorphic behavior, § 7.12(3177), 

§ 7.13(3198) 

polymorphic methods, § 3.4.9(1130) 
polymorphism, § 3.2.1(268), § 3.2.2(276), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 
§ 3.2.12(329), ) 

§ 3.2.15(339), (349) ( 

§ 3.2.18(361), (361) ( 

§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392 
§ 3.2.24(405), (406) ( 

§ 3.2.27(428), ) 

§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 
§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 


§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 

§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 

§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 
§ 4.4.2.2.1(1775), § 44.2.2.2(1795), 
§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834 
§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 
§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 
§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 
§ 4.4.2.4.3(2038) 

Port, § 5.2.2(2649), § 5.2.3(2660) 
practice programs, § 3.5.1(1347), § 3.5.2(1380), 
§ 3.5.3(1406) 

primitive type, § 3.2.1(268), § 3.2.2(276), 

§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 


Na NaN NNN E aa 


) 
) 
) 
), 
) 
) 
) 
) 


SE opt Sa prem Ga a ae: 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3296 


§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575) 


) ), § 3.3.14(633), 
(639) (640), § 3.3.17(651), 
(660) (661), § 3.3.20(680), 
(691) (692), § 3.3.24(736), 

§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 

§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
(878) (916), § 3.3.36(917), 
(958) (959), § 3.3.41(993), 
( ( 


§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 

§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 

§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 
§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 
§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834 
§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 
§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 
§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 
§ 4.4.2.4.3(2038) 

primitive types, § 7.2(2950) 
Principles of Object-Oriented Programming, 
§ 9.1(3277) 

println method, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

PrintStream class, § 2.20(108), § 2.21(112) 
Print Writer, § 4.5.12(2410) 

Prob01 class, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 


a Po Gat pe a ee a: Se 


) 
) 
) 
), 
) 
) 
) 
) 


Prob01Runner class, § 3.3.4(509), § 3.3.5(536), 


§ 3.3.6(556) 

programming fundamentals, § 2.1(5) 
Programming Oldies But Goodies, 

§ 10.1(3279) 

Protocols, § 5.2.2(2649), § 5.2.3(2660) 
Proxy Server, § 5.2.2(2649), § 5.2.3(2660) 
public, § 3.2.1(268), § 3.2.2(276), § 3.2.3(277), 
§ 3.2.4(287), § 3.2.5(288), § 3.2.6(299), 

§ 3.2.7(299), § 3.2.8(308), § 3.2.9(308), 

§ 3.2.10(317), § 3.2.11(318), § 3.2.12(329), 
§ 3.2.13(329), § 3.2.14(338), § 3.2.15(339), 
§ 3.2.16(349), § 3.2.17(349), § 3.2.18(361), 


INDEX 
§ 3.2.19(361), § 3.2.20(374), § 3.2.21(374), 
§ 3.2.22(392), § 3.2.23(392), § 3.2.24(405), 
§ 3.2.25(406), § 3.2.26(428), § 3.2.27(428), 
§ 3.2.28(442), § 3.2.29(457), § 3.2.30(458), 
§ 3.3.7(557), § 3.3.8(575), § 3.3.9(591), 

§ 3.3.10(592), § 3.3.11(610), § 3.3.12(623), 
§ 3.3.13(624), § 3.3.14(633), § 3.3.15(639), 
§ 3.3.16(640), § 3.3.17(651), § 3.3.18(660), 
§ 3.3.19(661), § 3.3.20(680), § 3.3.21(691), 
§ 3.3.22(692), § 3.3.24(736), § 3.3.25(737), 
§ 3.3.27(801), § 3.3.28(802), § 3.3.30(862), 
§ 3.3.31(863), § 3.3.32(878), § 3.3.33(878), 
§ 3.3.35(916), § 3.3.36(917), § 3.3.38(958), 
§ 3.3.39(959), § 3.3.41(993), § 3.3.42(994), 


§ 3.3.44(1027), § 3.3.45(1028), § 3.3.47(1067), 
§ 4.2.1(1431), § 4.2.2(1433), § 4.2.3(1450), 

§ 4.2.4(1480), § 4.2.5(1489), § 4.2.6(1516), 

§ 4.2.7(1537), § 4.4.2.1.1(1686), 

§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 
§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 
§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834 
§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 
§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 
§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 
§ 4.4.2.4.3(2038) 

public class files, § 7.15(3252) 


) 
) 
) 
), 
) 
) 
) 
) 


a NNN NNN Sa 


reference, § 3.2.1(268), § 3.2.2(276), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 
§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 
§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392 
(405) ( 
(428) 
) 


3 
a 
i 


i 


fe ee 


§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 
§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 
§ 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
§ 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
§ 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
§ 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 

(878) (917) 

(958) 

( 


x | 


Wwe Dow YK aat 
Ne NaN NE Sa S 


zi 


§ 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 

§ 3.3.38(958), § 3.3.39(959), § 3.3.41 (993), 

§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 


SB NS DS SS a 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


INDEX 


§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 


§ 4.4.2.1.2(1700 
§ 4.4.2.1.4(1731 
§ 4.4.2.2.1(1775 
§ 4.4.2.2.3(1818 
§ 4.4.2.2.5(1848 
§ 4.4.2.3.2(1883 
§ 4.4.2.3.4(1916 
§ 4.4.2.4.1(1955 
§ 4.4.2.4.3(2038) 


Ra NNN NN Ne 


§ 4.4.2.1.3(1712), 
§ 4.4.2.1.5(1754), 
§ 4.4.2.2.2(1795), 
§ 4.4.2.2.4(1834 
§ 4.4.2.3.1(1872), 
§ 4.4.2.3.3(1902), 
§ 4.4.2.3.5(1930), 
( 


) 
) 
) 
), 
) 
§ 4.4.2.4.2(1997), 


reference type, § 3.2.1(268), § 3.2.2(276), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 
§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 


§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 

§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 


§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 


§ 3.3.12(623 
§ 3.3.15(639 
§ 3.3.18(660 
§ 3.3.21(691 
§ 3.3.25(7 
§ 3.3.30(862 
§ 3.3.33(878 
§ 3.3.38(958 

( 


), § 3.3.13(624), 
), § 3.3.16(640), 
), § 3.3.19(661), 
), § 3.3.22(692), 
37), § 3-3.27( 

), § 3.3.31(863), 
), § 3.3.35(916), 
), § 3.3.39(959), 
§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 


) 
) ( 
) ( 
) (73 
801), § 3.3.28( 
) ( 
) ( 
) 


§ 3.3.41(993), 


§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 


§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 


§ 4.4.2.1.2(1700 
§ 4.4.2.1.4(1731 
§ 4.4.2.2.1(1775 
§ 4.4.2.2.3(1818 
§ 4.4.2.2.5(1848 
§ 4.4.2.3.2(1883 
§ 4.4.2.3.4(1916 
§ 4.4.2.4.1(1955 
§ 4.4.2.4.3(2038) 


reference variables, § 2.22(118), § 2.23(132) 


ee NNN NEN Ne a 


§ 4.4.2.1.3(1712), 
§ 4.4.2.1.5(1754), 
§ 4.4.2.2.9(1795), 
§ 4.4.2.2.4(1834), 
§ 4.4.2.3.1(1872), 
§ 4.4.2.3.3(1902), 
§ 4.4.2.3.5(1930), 
§ 4.4.2.4.2(1997), 


relational operators, § 7.4(3000) 
rendering, § 5.2.10(2711) 

reverse method, § 3.4.27(1289) 
reverse natural order, § 3.4.23(1253), 


§ 3.4.25 (1274) 


reverse the order, § 3.4.27(1289) 
reverseOrder method, § 3.4.27(1289) 


3297 


review, § 2.4(17), § 2.7(32), § 2.9(45), 

§ 2.11(56), § 2.13(73), § 2.15(88), § 2.17(97), 
§ 2.19(104), § 2.21(112), § 2.23(132), 

§ 2.25(154), § 2.27(174), § 2.29(194), 

§ 2.34(230), § 2.37(254), § 3.3.2(501), 

§ 3.3.5(536), § 3.3.8(575), § 3.3.11(610), 

§ 3.3.14(633), § 3.3.17(651), § 3.3.20(680), 

§ 3.3.23(721), § 3.3.26(773), § 3.3.29(838), 

§ 3.3.34(902), § 3.3.37(944), § 3.3.40(981), 

§ 3.3.43(1013), § 3.3.46(1047), § 5.3.2(2765) 
review questions, § 4.3.2(1581), § 4.3.3(1599) 
review questions and answers, § 4.3.4(1614), 
§ 4.3.5(1623), § 4.3.6(1638), § 4.3.7(1653), 

§ 4.3.8(1667), § 4.4.3(2061) 

robots exclusion standard, § 5.3.2(2765) 
robots.txt, § 5.3.2(2765) 

Rotating, § 3.3.34(902) 

run method, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 


Scaling, § 3.3.34(902) 

Scriptlet, § 4.5.8(2253) 

search algorithms, § 3.4.1(1068), § 3.4.2(1079) 
search engine, § 5.3.2(2765) 

search engines, § 5.3.1(2762) 

select, § 4.5.10(2324) 

select element, § 4.5.10(2324) 

selection, § 2.5(21) 

self assessment, § 7.1(2949) 
self-assessment, § 7.2(2950), § 7.3(2972), 
§ 7.4(3000), § 7.5(3026), § 7.6(3046), 

§ 7.7(3074), § 7.8(3099), § 7.9(3116), 

§ 7.10(3136), § 7.11(3154), § 7.12(3177), 

§ 7.13(3198), § 7.14(3232), § 7.15(3252) 
sequence, § 2.5(21) 

servlet, § 4.5.2(2104), § 5.4.5(2814), 

§ 5.4.6(2838), § 5.4.7(2841), § 5.4.8(2871), 
§ 5.4.9(2893), § 5.4.10(2898), § 5.4.11(2941) 
servlets, § 4.5.3(2129) 

session tracking, § 5.4.5(2814), § 5.4.6(2838), 
§ 5.4.7(2841), § 5.4.8(2871), § 5.4.9(2893) 
Session Tracking API, § 5.4.10(2898), 

§ 5.4.11(2941) 

sessions, § 4.5.14(2519), § 4.5.15(2588) 
Sessions with JSP, § 4.5.4(2142) 

Set, § 3.4.13(1162) 

Set object, § 3.4.11(1147) 

setBodyColor, § 3.3.4(509), § 3.3.5(536), 
§ 3.3.6(556) 

setName, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

setPenColor, § 3.3.4(509), § 3.3.5(536), 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3298 


§ 3.3.6(556) 

setPenDown, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

setPenWidth, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

setPicture, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

setShell, § 3.3.4(509), § 3.3.5(536), § 3.3.6(556) 
setter method, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

signature, § 3.2.1(268), § 3.2.2(276), 

§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 

§ 3.2.12(329), 3.2.14(338), 
§ 3.2.15(339), ( 3.2.17(349), 
§ 3.2.18(361), ( 3.2.20(374), 
§ 3.2.21(374), § 3.2.22(392 3.2.23(392), 
§ 3.2.24(405), ( 3.2.26(428), 
§ 3.2.27(428), § 3. 3.2.29(457), 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 

§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 
§ 3.3.12(623), § 3.3.13(624), 
§ 3.3.15(639), § 3.3.16(640), ( 
§ 3.3.18(660), § 3.3.19(661), ( 
§ 3.3.21(691), § 3.3.22(692), (73 
§ 3.3.25(737), § 3.3.27(801), § 3.3.28( 
§ 3.3.30(862), § 3.3.31(863), ( 
§ 3.3.33(878), § 3.3.35(916), § 3.3.36( 
§ 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 

§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 

§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 

§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 
§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 
§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834 
§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 
§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 
§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 
§ 4.4.2.4.3(2038) 

SimplePicture class, § 3.3.4(509), § 3.3.5(536), 
§ 3.3.6(556) 

SimpleTurtle class, § 3.3.4(509), § 3.3.5(536), 
§ 3.3.6(556) 

slides, § 3.3.3(508), § 3.3.6(55 8), § 3.3.9(591), 
§ 3.3.12(623), § 3.3.15(639), § 3.3.18(660), 

§ 3.3.21(691), § 3.3.24(736), § 3.3.27(801) 
socket, § 5.2.11(2740), § 5.2.12(2759) 


) 
) 
) 
), 
) 
) 
) 
) 


ee NNN NEN Ne a 


INDEX 


Socket Class, § 5.2.2(2649), § 5.2.3(2660) 

Socket Programming, § 5.2.2(2649), 

§ 5.2.3(2660) 

sort, § 3.4.23(1253) 

sort a list into reverse natural order, 

§ 3.4.27(1289) 

sort method, § 3.4.25(1274) 

sorted, § 3.4.21(1240) 

sorted collections, § 3.4.11(1147), 

§ 3.4.11(1147), § 3.4.12(1154) 

SortedMap, § 3.4.13(1162) 

SortedSet, § 3.4.13(1162) 

sorting algorithms, § 3.4.1(1068), § 3.4.2(1079) 

sorting order natural order, § 3.4.17(1205) 

Standards, § 5.2.2(2649), § 5.2.3(2660) 

state, § 3.2.1(268), § 3.2.2(276), § 3.2.3(277), 

§ 3.2.4(287), § 3.2.5(288), § 3.2.6(299), 

§ 3.2.7(299), § 3.2.8(308), § 3.2.9(308), 

§ 3.2.10(317), § 3.2.11(318), § 3.2.12(329), 

§ 3.2.13(329), § 3.2.14(338), § 3.2.15(339), 

§ 3.2.16(349), § 3.2.17(349), § 3.2.18(361), 

§ 3.2.19(361), § 3.2.20(374), § 3.2.21(374), 

§ 3.2.22(392), § 3.2.23(392), § 3.2.24(405), 

3.2.25(406), § 3.2.26(428), § 3.2.27(428), 

§ 3.2.28(442), § 3.2.29(457), § 3.2.30(458), 

§ 3.3.7(557), § 3.3.8(575), § 3.3.9(591), 

§ 3.3.10(592), § 3.3.11(610), § 3.3.12(623), 

§ 3.3.13(624), § 3.3.14(633), § 3.3.15(63 

§ 3.3.16(640), § 3.3.17(651), § 3.3.18(66 

§ 3.3.19(661), § 3.3.20(680), § 3.3.21(69 

§ 3.3.22(692), § 3.3.24(736), § 3.3.25(7 

§ 3.3.27(801), § 3.3.28(802), § 3.3.30(86 
(863) (878) ( 
(916) (917) ( 
(959) 


9), 

0), 

1), 

37), 
862), 

§ 3.3.31(863), § 3.3.32(878), § 3.3.33(878), 

§ 3.3.35(916), § 3.3.36(917), § 3.3.38(958), 

§ 3.3.39(959), § 3.3.41(993), § 3.3.42(994), 

§ 3.3.44(1027), § 3.3.45(1028), § 3.3.47(1067), 

§ 4.2.1(1431), § 4.2.2(1433), § 4.2.3(1450), 

§ 4.2.4(1480), § 4.2.5(1489), § 4.2.6(1516), 

§ 4.2.7(1537), § 4.4.2.1.1(1686), 


§ 4.4.2.1.2(1700), 


§ 4.4.2.1.4(1731 


§ 4.4.2.2.1(1775), 


( 

( 

§ 4.4.2.2.3(1818 

§ 4.4.2.2.5(1848 

§ 4.4.2.3.2(1883 
( 
( 


§ 4.4.2.3.4(1916), 
§ 4.4.2.4.1(1955), 


§ 4.4.2.4.3(2038) 


aN NNN a S 


§ 4.4.2.1.3(1712), 
§ 4.4.2.1.5(1754), 
§ 4.4.2.2.2(1795), 
§ 4.4.2.2.4(1834 
§ 4.4.2.3.1(1872), 
§ 4.4.2.3.3(1902), 
§ 4.4.2.3.5(1930), 
( 


) 
) 
) 
), 
) 
§ 4.4.2.4.2(1997), 


statements, § 2.26(171), § 2.27(174) 
static final Variables, § 7.11(3154) 
static initializer block, § 3.2.1(268), 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


INDEX 3299 


§ 3.2.2(276), § 3.2.3(277), § 3.2.4(287), § 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
§ 3.2.5(288), § 3.2.6(299), § 3.2.7(299), § 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
§ 3.2.8(308), § 3.2.9(308), § 3.2.10(317), § 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
§ 3.2.11(318), § 3.2.12(329), § 3.2.13(329), § 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
§ 3.2.14(338), § 3.2.15(339), § 3.2.16(349), § 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
§ 3.2.17(349), § 3.2.18(361), § 3.2.19(361), § 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
§ 3.2.20(374), § 3.2.21(374), § 3.2.22(392), § 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.2.23(392), § 3.2.24(405), § 3.2.25(406), § 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 

§ 3.2.26(428), § 3.2.27(428), § 3.2.28(442), § 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.2.29(457), § 3.2.30(458), § 3.3.7(557), § 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 3.3.8(575), § 3.3.9(591), § 3.3.10(592), § 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 
§ 3.3.11(610), § 3.3.12(623), § 3.3.13(624), § 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 3.3.14(633), § 3.3.15(639), § 3.3.16(640), § 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 

§ 3.3.17(651), § 3.3.18(660), § 3.3.19(661), § 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 

§ 3.3.20(680), § 3.3.21(691), § 3.3.22(692), § 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 

§ 3.3.24(736), § 3.3.25(737), § 3.3.27(801), § 4.4.2.2.3(1818), § 4.4.2.2.4(1834), 

§ 3.3.28(802), § 3.3.30(862), § 3.3.31(863), § 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 

§ 3.3.32(878), § 3.3.33(878), § 3.3.35(916), § 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 

§ 3.3.36(917), § 3.3.38(958), § 3.3.39(959), § 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 

§ 3.3.41(993), § 3.3.42(994), § 3.3.44(1027), § 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 

§ 3.3.45(1028), § 3.3.47(1067), § 4.2.1(1431), § 4.4.2.4.3(2038) 

§ 4.2.2(1433), § 4.2.3(1450), § 4.2.4(1480), submit element, § 4.5.10(2324) 

§ 4.2.5(1489), § 4.2.6(1516), § 4.2.7(1537), subtypes, § 4.3.6(1638) 

§ 4.4.2.1.1(1686), § 4.4.2.1.2(1700), super Keyword, § 7.10(3136) 

§ 4.4.2.1.3(1712), § 4.4.2.1.4(1731), superclass, § 3.2.1(268), § 3.2.2(276), 

§ 4.4.2.1.5(1754), § 4.4.2.2.1(1775), § 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 4.4.2.2.2(1795), § 4.4.2.2.3(1818), § 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 4.4.2.2.4(1834), § 4.4.2.2.5(1848), § 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 

§ 4.4.2.3.1(1872), § 4.4.2.3.2(1883), § 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 4.4.2.3.3(1902), § 4.4.2.3.4(1916), § 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 4.4.2.3.5(1930), § 4.4.2.4.1(1955), § 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 4.4.2.4.2(1997), § 4.4.2.4.3(2038) § 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
static Methods, § 7.10(3136) § 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
String, § 2.30(202), § 2.31(215), § 2.36(243), § 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 2.37(254), § 7.5(3026) § 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 
String objects, § 3.4.19(1224) § 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 
StringBuffer, § 2.30(202), § 2.36(243), § 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
§ 2.37(254) § 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
StringBufferreview, § 2.31(215) § 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
subclass, § 3.2.1(268), § 3.2.2(276), § 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), § 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), § 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), § 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 
§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), § 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 

§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), § 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), § 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), § 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 
§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), § 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), § 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 

§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), § 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 

§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), § 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3300 


§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834), 

§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 

§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 

§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 

§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 

§ 4.4.2.4.3(2038) 

System class, § 2.20(108), § 2.21(112) 


TCP, § 5.2.2(2649), § 5.2.3(2660) 

testing, § 5.4.1(2771), § 5.4.2(2793) 
textarea, § 4.5.10(2324) 

The Comparator Interface, § 3.4.22(1248), 

§ 3.4.24(1267), § 3.4.26(1283), § 3.4.28(1299) 
the Inet Address class, § 5.2.4(2668), 

§ 5.2.5(2681) 

The Java Collections Framework, § 3.4.9(1130) 
The toArray Method, § 3.4.30(1319), 

§ 3.4.32(1338) 

the URL class, § 5.2.6(2684), § 5.2.7(2698) 
the URLConnection class, § 5.2.8(2701), 

§ 5.2.9(2708) 

the URLEncoder class, § 5.2.6(2684), 

§ 5.2.7(2698) 

this Keyword, § 7.11(3154) 

Tinting, § 3.3.29(838) 

toArray method, § 3.4.29(1306), § 3.4.31(1324) 
Tomcat, § 4.5.3(2129) 

toString, § 7.5(3026) 

toString method, § 3.2.1(268), § 3.2.2(276), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 

§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 

§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 


§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374), 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 
§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 


§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 
§ 3.3.12(623), ), § 3.3.14(633), 
§ 3.3.15(639), ), § 3.3.17(651), 
§ 3.3.18(660), ), § 3.3.20(680), 
§ 3.3.21(691), § 3. ), § 3.3.24(736), 
§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
§ 3.3.30(862), ), § 3.3.32(878), 
§ 3.3.33(878), ), § 3.3.36(917), 
§ 3.3.38(958), ), § 3.3.41(993), 
§ 3.3.42(994), 
§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 
§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 


§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 


INDEX 

§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 
§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 
§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 
§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834), 
§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 
§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 
§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 
§ 4.4.2.4.3(2038) 


Translating, § 3.3.34(902) 

TreeSet, § 3.4.21(1240) 

TreeSet collection, § 3.4.15(1186), 

§ 3.4.19(1224) 

try, § 4.5.12(2410) 

Turtle class, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.6(556) 

type conversion, § 7.15(3252) 

type inference, § 4.3.7(1653), § 4.3.8(1667) 


UDP, § 5.2.2(2649), § 5.2.3(2660) 
URL, § 5.2.2(2649), § 5.2.3(2660) 

URL Class, § 5.2.2(2649), § 5.2.3(2660) 
URL Programming, § 5.2.2(2649), 

§ 5.2.3(2660) 

URL rewriting, § 5.4.7(2841) 


variable, § 3.2.1(268), § 3.2.2(276), 
§ 3.2.3(277), § 3.2.4(287), § 3.2.5(288), 
§ 3.2.6(299), § 3.2.7(299), § 3.2.8(308), 
§ 3.2.9(308), § 3.2.10(317), § 3.2.11(318), 
§ 3.2.12(329), § 3.2.13(329), § 3.2.14(338), 
§ 3.2.15(339), § 3.2.16(349), § 3.2.17(349), 
§ 3.2.18(361), § 3.2.19(361), § 3.2.20(374 
§ 3.2.21(374), § 3.2.22(392), § 3.2.23(392), 

(405) ( 

(428) 

) 


PE ib ee pe 


§ 3.2.24(405), § 3.2.25(406), § 3.2.26(428), 
§ 3.2.27(428), § 3.2.28(442), § 3.2.29(457), 
§ 3.2.30(458), § 3.3.7(557), § 3.3.8(575), 
§ 3.3.9(591), § 3.3.10(592), § 3.3.11(610), 
§ 3.3.12(623), § 3.3.13(624), § 3.3.14(633), 
§ 3.3.15(639), § 3.3.16(640), § 3.3.17(651), 
§ 3.3.18(660), § 3.3.19(661), § 3.3.20(680), 
§ 3.3.21(691), § 3.3.22(692), § 3.3.24(736), 
§ 3.3.25(737), § 3.3.27(801), § 3.3.28(802), 
§ 3.3.30(862), § 3.3.31(863), § 3.3.32(878), 
(878) (917) 
(958) 
( 


NNN a a 


) 
) 
), 
) 
) 
) 


§ 3.3.33(878), § 3.3.35(916), § 3.3.36(917), 

§ 3.3.38(958), § 3.3.39(959), § 3.3.41(993), 

§ 3.3.42(994), § 3.3.44(1027), § 3.3.45(1028), 
§ 3.3.47(1067), § 4.2.1(1431), § 4.2.2(1433), 

§ 4.2.3(1450), § 4.2.4(1480), § 4.2.5(1489), 

§ 4.2.6(1516), § 4.2.7(1537), § 4.4.2.1.1(1686), 
§ 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 

§ 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 


eae NNN aN Na NA 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


INDEX 3301 


§ 4.4.2.2.1(1775), § 4.4.2.2.2(1795), § 3.3.35(916), § 3.3.36(917), § 3.3.38(958), 
§ 4.4.2.2.3(1818), § 4.4.2.2.4(1834), § 3.3.39(959), § 3.3.41(993), § 3.3.42(994), 
§ 4.4.2.2.5(1848), § 4.4.2.3.1(1872), § 3.3.44(1027), § 3.3.45(1028), § 3.3.47(1067), 
§ 4.4.2.3.2(1883), § 4.4.2.3.3(1902), § 4.2.1(1431), § 4.2.2(1433), § 4.2.3(1450), 
§ 4.4.2.3.4(1916), § 4.4.2.3.5(1930), § 4.2.4(1480), § 4.2.5(1489), § 4.2.6(1516), 
§ 4.4.2.4.1(1955), § 4.4.2.4.2(1997), § 4.2.7(1537), § 4.4.2.1.1(1686), 

§ 4.4.2.4.3(2038) § 4.4.2.1.2(1700), § 4.4.2.1.3(1712), 
variables, § 2.22(118), § 2.23(132) § 4.4.2.1.4(1731), § 4.4.2.1.5(1754), 

void, § 3.2.1(268), § 3.2.2(276), § 3.2.3(277), § 4.4.2.2.1(1775), § 4.4.2.2.2(1795), 

§ 3.2.4(287), § 3.2.5(288), § 3.2.6(299), § 4.4.2.2.3(1818), § 4.4.2.2.4(1834), 

§ 3.2.7(299), § 3.2.8(308), § 3.2.9(308), § 4.4.2.2.5(1848), § 4.4.2.3.1(1872), 

§ 3.2.10(317), § 3.2.11(318), § 3.2.12(329), § 4.4.2.3.2(1883), § 4.4.2.3.3(1902), 

§ 3.2.13(329), § 3.2.14(338), § 3.2.15(339), § 4.4.2.3.4(1916), § 4.4.2.3.5(1930), 

§ 3.2.16(349), § 3.2.17(349), § 3.2.18(361), § 4.4.2.4.1(1955), § 4.4.2.4.2(1997), 

§ 3.2.19(361), § 3.2.20(374), § 3.2.21(374), § 4.4.2.4.3(2038) 

§ 3.2.22(392), § 3.2.23(392), § 3.2.24(405), 

§ 3.2.25(406), § 3.2.26(428), § 3.2.27(428), W web, § 5.5.1(2944) 

§ 3.2.28(442), § 3.2.29(457), § 3.2.30(458), Web Programming Model, § 4.5.4(2142) 

§ 3.3.10(592), § 3.3.11(610), § 3.3.12(623), web server, § 4.5.3(2129) 

§ 3.3.13(624), § 3.3.14(633), § 3.3.15(639), wildcard, § 4.3.8(1667) 

§ 3.3.16(640), § 3.3.17(651), § 3.3.18(660), Working with Java Classes in JSP, 

§ 3.3.19(661), § 3.3.20(680), § 3.3.21(691), § 4.5.4(2142) 

§ 3.3.22(692), § 3.3.24(736), § 3.3.25(737), World class, § 3.3.4(509), § 3.3.5(536), 

§ 3.3.27(801), § 3.3.28(802), § 3.3.30(862), § 3.3.6(556) 

§ 3.3.31(863), § 3.3.32(878), § 3.3.33(878), writing, § 5.4.1(2771), § 5.4.2(2793) 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3302 
Attributions 


Collection: Object-Oriented Programming (OOP) with Java 
Edited by: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /col11441 /1.181/ 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jy0010: Preface to OOP with Java" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45136/1.17/ 

Pages: 1-4 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0103 Preface to Programming Fundamentals" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45179/1.10/ 

Pages: 5-7 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0105: Java OOP: Similarities and Differences between Java and C++" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45142/1.3/ 

Pages: 7-11 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0110: Java OOP: Programming Fundamentals, Getting Started" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45137/1.4/ 

Pages: 11-16 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0110r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45162/1.6/ 

Pages: 17-21 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0115: Java OOP: First Program" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45220/1.3/ 

Pages: 21-25 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


ATTRIBUTIONS 


Module: "Jb0120: Java OOP: A Gentle Introduction to Java Programming" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45138/1.3/ 

Pages: 25-31 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0120r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45164/1.5/ 

Pages: 32-36 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0130: Java OOP: A Gentle Introduction to Methods in Java" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45139/1.3/ 

Pages: 36-44 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0130r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45165 /1.5/ 

Pages: 45-50 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0140: Java OOP: Java comments" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45140/1.4/ 

Pages: 50-55 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0140r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45169/1.5/ 

Pages: 56-59 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses /by /4.0/ 


Module: "Jb0150: Java OOP: A Gentle Introduction to Java Data Types" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45141/1.3/ 

Pages: 60-72 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0150r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45168/1.5/ 

Pages: 73-81 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3303 


3304 


Module: "Jb0160: Java OOP: Hello World" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45143/1.3/ 

Pages: 81-87 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0160r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45159/1.8/ 

Pages: 88-94 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0170: Java OOP: A little more information about classes." 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45144/1.3/ 

Pages: 94-96 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0170r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45177/1.5/ 

Pages: 97-100 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0180: Java OOP: The main method." 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45145 /1.3/ 

Pages: 100-103 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0180r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45171/1.5/ 

Pages: 104-107 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0190: Java OOP: Using the System and PrintStream Classes" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45148/1.3/ 

Pages: 108-111 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0190r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45175/1.6/ 

Pages: 112-118 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


ATTRIBUTIONS 


Module: "Jb0200: Java OOP: Variables" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45150/1.3/ 

Pages: 118-131 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0200r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45173/1.7/ 

Pages: 132-144 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0210: Java OOP: Operators" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45195 /1.5/ 

Pages: 144-153 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0210r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45186/1.6/ 

Pages: 154-171 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0220: Java OOP: Statements and Expressions" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45192/1.4/ 

Pages: 171-173 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0220r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45189/1.5/ 

Pages: 174-178 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0230: Java OOP: Flow of Control" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45196/1.5/ 

Pages: 178-193 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jb0230r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45218/1.6/ 

Pages: 194-202 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3305 


3306 


Module: "Jb0240: Java OOP: Arrays and Strings" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45214/1.5/ 

Pages: 202-214 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0240r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45208/1.5/ 

Pages: 215-223 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0250: Java OOP: Brief Introduction to Exceptions" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45211/1.4/ 

Pages: 223-226 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0260: Java OOP: Command-Line Arguments" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45246/1.5/ 

Pages: 226-229 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0260r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45244/1.6/ 

Pages: 230-234 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0270: Java OOP: Packages" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45229/1.5/ 

Pages: 234-243 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0280: Java OOP: String and StringBuffer" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45237/1.4/ 

Pages: 243-253 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Jb0280r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45241/1.5/ 

Pages: 254-263 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


ATTRIBUTIONS 


Module: "Jb0290: The end of Programming Fundamentals" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45257 /1.4/ 

Page: 263 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jy0020: Java OOP: Preface to ITSE 2321" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45222/1.10/ 

Pages: 265-268 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java1600: Objects and Encapsulation" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44153/1.4/ 

Pages: 268-276 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Javal600s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48897 /1.4/ 

Pages: 276-277 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Javal602: Classes" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44150/1.4/ 

Pages: 277-287 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Javal602s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48898 /1.3/ 

Pages: 287-288 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java1604: Inheritance, Part 1" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44193/1.5/ 

Pages: 288-299 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java1604s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48908 /1.3/ 

Page: 299 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3307 


3308 ATTRIBUTIONS 


Module: "Javal606: Inheritance, Part 2" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44156/1.4/ 

Pages: 299-308 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Javal606s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48907 /1.3/ 

Page: 308 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java1608: Polymorphism Based on Overloaded Methods" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44182/1.4/ 

Pages: 308-317 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Javal608s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48903/1.3/ 

Pages: 317-318 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java1610: Polymorphism, Type Conversion, Casting, etc." 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44168/1.4/ 

Pages: 318-329 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Javal610s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48917/1.3/ 

Page: 329 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java1612: Runtime Polymorphism through Inheritance" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44177/1.4/ 

Pages: 329-338 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java1612s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48928/1.2/ 

Pages: 338-339 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 3309 


Module: "Javal614: Polymorphism and the Object Class" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44190/1.4/ 

Pages: 339-349 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Javal614s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48923/1.2/ 

Page: 349 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Javal616: Polymorphism and Interfaces, Part 1" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44195/1.4/ 

Pages: 349-361 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Javal616s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48921 /1.2/ 

Page: 361 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Javal618: Polymorphism and Interfaces, Part 2" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44196/1.4/ 

Pages: 361-374 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Javal618s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48925 /1.2/ 

Page: 374 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Javal620: Static Members" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44197/1.5/ 

Pages: 374-392 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java1620s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48929/1.2/ 

Page: 392 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3310 


Module: "Javal622: Array Objects, Part 1" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44198/1.4/ 

Pages: 392-405 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java1622s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48930/1.2/ 

Pages: 405-406 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Javal624: Array Objects, Part 2" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44199/1.4/ 

Pages: 406-428 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Javal624s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48931/1.2/ 

Page: 428 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Javal626: Array Objects, Part 3" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44200/1.5/ 

Pages: 428-442 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java1628: The this and super Keywords" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44201/1.5/ 

Pages: 442-457 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Javal628s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48932/1.2/ 

Pages: 457-458 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Javal630: Exception Handling" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44202/1.5/ 

Pages: 458-482 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


ATTRIBUTIONS 


Module: "Java3000: The Guzdial-Ericson Multimedia Class Library" 
By: R.G. (Dick) Baldwin 

URL: http://cenx.org/content /m44148/1.11/ 

Pages: 483-500 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3000r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45761/1.5/ 

Pages: 501-508 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3000s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45620/1.3/ 

Pages: 508-509 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /3.0/ 


Module: "Java3002: Creating and Manipulating Turtles and Pictures in a World Object" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44149/1.8/ 

Pages: 509-535 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3002r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45762/1.4/ 

Pages: 536-556 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3002s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45621/1.5/ 

Pages: 556-557 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /3.0/ 


Module: "Java3004: Image Processing Algorithms, Image Inversion, and PictureExplorer Objects" 


By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44203/1.7/ 

Pages: 557-574 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3004r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45763/1.7/ 

Pages: 575-591 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3311 


3312 ATTRIBUTIONS 


Module: "Java3004s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45622/1.4/ 

Pages: 591-592 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /3.0/ 


Module: "Java3006: Implementing a space-wise linear color-modification algorithm." 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44204/1.7/ 

Pages: 592-609 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3006r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45768/1.3/ 

Pages: 610-623 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3006s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45623/1.3/ 

Pages: 623-624 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /3.0/ 


Module: "Java3008: Abstract Methods, Abstract Classes, and Overridden Methods" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44205 /1.7/ 

Pages: 624-632 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3008r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45773/1.2/ 

Pages: 633-639 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3008s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45624/1.3/ 

Pages: 639-640 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /3.0/ 


Module: "Java3010: Indirection, Array Objects, and Casting" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44206/1.6/ 

Pages: 640-650 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


Module: "Java3010r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45774/1.2/ 

Pages: 651-660 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3010s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45625 /1.2/ 

Pages: 660-661 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /3.0/ 


Module: "Java3012: Using Nested Loops to Process Pixels" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44207 /1.7/ 

Pages: 661-679 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3012r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45775 /1.2/ 

Pages: 680-691 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3012s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45626/1.2/ 

Pages: 691-692 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /3.0/ 


Module: "Java3014: Cropping, Flipping, and Combining Pictures" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44238/1.8/ 

Pages: 692-720 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3014r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45778 /1.2/ 

Pages: 721-736 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3014s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45628/1.3/ 

Pages: 736-737 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /3.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3313 


3314 


Module: "Java3016: Green-Screen Processing" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44210/1.8/ 

Pages: 737-772 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3016r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45781/1.2/ 

Pages: 773-801 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3016s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45637 /1.2/ 

Pages: 801-802 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /3.0/ 


Module: "Java3018: Darkening, Brightening, and Tinting the Colors in a Picture" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44234/1.6/ 

Pages: 802-837 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3018r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45782/1.2/ 

Pages: 838-862 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3018s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45636/1.2/ 

Pages: 862-863 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /3.0/ 


Module: "Java3020: Interfaces, Object Arrays, etc." 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44214/1.6/ 

Pages: 863-878 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3020s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45632/1.2/ 

Page: 878 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /3.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


ATTRIBUTIONS 3315 


Module: "Java3022: Scaling, Rotating, and Translating Images using Affine Transforms" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44223/1.7/ 

Pages: 878-901 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3022r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45783/1.2/ 

Pages: 902-916 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3022s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45639/1.2/ 

Pages: 916-917 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /3.0/ 


Module: "Java3024: Mirroring Images" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44228/1.7/ 

Pages: 917-943 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3024r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45784/1.2/ 

Pages: 944-958 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3024s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45640/1.2/ 

Pages: 958-959 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /3.0/ 


Module: "Java3026: GradientPaint and other Java2D Classes" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44242/1.7/ 

Pages: 959-980 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java3026r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45785 /1.2/ 

Pages: 981-993 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3316 


Module: "Java3026s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45643/1.2/ 

Pages: 993-994 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /3.0/ 


Module: "Java3028: Clipping Images" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44246/1.7/ 

Pages: 994-1012 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3028r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45786/1.2/ 

Pages: 1013-1027 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3028s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45646/1.2/ 

Pages: 1027-1028 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /3.0/ 


Module: "Java3030: Merging Pictures" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44247 /1.7/ 

Pages: 1028-1046 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3030r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45787 /1.2/ 

Pages: 1047-1067 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java3030s Slides" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45648/1.2/ 

Pages: 1067-1068 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /3.0/ 


Module: "Java4010: Getting Started with Java Collections" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46135/1.5/ 

Pages: 1068-1078 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


ATTRIBUTIONS 


Module: "Java4010r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48040/1.5/ 

Pages: 1079-1087 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4020: What is a Collection" 

By: R.G. (Dick) Baldwin 

URL: http://cenx.org/content /m46136/1.3/ 

Pages: 1087-1092 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4020r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48041 /1.3/ 

Pages: 1093-1098 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4030: Purpose of Framework Interfaces" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46140/1.4/ 

Pages: 1098-1103 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4030r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48043 /1.2/ 

Pages: 1104-1111 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4040: Purpose of Framework Implementations and Algorithms" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46137/1.6/ 

Pages: 1111-1121 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4040r Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48044/1.3/ 

Pages: 1122-1130 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4050: Core Collection Interfaces" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46138/1.4/ 

Pages: 1130-1139 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3317 


3318 ATTRIBUTIONS 


Module: "Java4050r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48114/1.3/ 

Pages: 1140-1147 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4060: Duplicate Elements, Ordered Collections, Sorted Collections, and Interface Specializa- 
tion" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46141/1.4/ 

Pages: 1147-1153 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4060r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48121/1.3/ 

Pages: 1154-1162 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4070: The Comparable Interface, Part 1" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46142/1.4/ 

Pages: 1162-1175 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4070r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48122/1.4/ 

Pages: 1176-1186 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4080: The Comparable Interface, Part 2" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46143/1.2/ 

Pages: 1186-1197 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4080r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48130/1.2/ 

Pages: 1198-1205 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


Module: "Java4090: The Comparator Interface, Part 1" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46189/1.2/ 

Pages: 1205-1217 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4090r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48132/1.2/ 

Pages: 1218-1224 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4100: The Comparator Interface, Part 2" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46190/1.2/ 

Pages: 1224-1234 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4100r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48124/1.2/ 

Pages: 1235-1240 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4110: The Comparator Interface, Part 3" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46191 /1.2/ 

Pages: 1240-1247 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4110r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48138/1.2/ 

Pages: 1248-1253 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4120: The Comparator Interface, Part 4" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46192/1.2/ 

Pages: 1253-1266 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4120r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48137 /1.2/ 

Pages: 1267-1274 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3319 


3320 


Module: "Java4130: The Comparator Interface, Part 5" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46193/1.3/ 

Pages: 1274-1282 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4130r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48140/1.2/ 

Pages: 1283-1289 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4140: The Comparator Interface, Part 6" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46194/1.2/ 

Pages: 1289-1298 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4140r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48153/1.3/ 

Pages: 1299-1306 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4150: The toArray Method, Part 1" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46197/1.4/ 

Pages: 1306-1318 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4150r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48168/1.2/ 

Pages: 1319-1324 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4160: The toArray Method, Part 2" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m46198 /1.2/ 

Pages: 1324-1337 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4160r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48166/1.2/ 

Pages: 1338-1345 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


ATTRIBUTIONS 3321 


Module: "Java OOP: ITSE 2321 Practice Group 1" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44252/1.8/ 

Pages: 1347-1379 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: ITSE 2321 Practice Group 2" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44254/1.7/ 

Pages: 1380-1405 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: ITSE 2321 Practice Group 3" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44255 /1.5/ 

Pages: 1406-1427 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jy0030: Java OOP: Preface to ITSE 2317" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45258/1.6/ 

Pages: 1429-1431 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses /by /4.0/ 


Module: "Java OOP: The AWT and Swing, A Preview" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44331/1.3/ 

Pages: 1431-1433 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: Callbacks - I" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44333/1.3/ 

Pages: 1433-1450 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: Event Handling in JDK 1.1, A First Look, Delegation Event Model" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44340/1.4/ 

Pages: 1450-1480 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: Swing and the Delegation Event Model" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44336/1.4/ 

Pages: 1480-1489 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3322 


Module: "Java OOP: Member Classes" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44347/1.4/ 

Pages: 1489-1516 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java OOP: Local Classes" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44346/1.4/ 

Pages: 1516-1537 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java OOP: Anonymous Classes" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44342/1.4/ 

Pages: 1537-1558 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4210: Getting Started with Generics" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m47554/1.2/ 

Pages: 1558-1580 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4210r: Review of Getting Started" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m47555/1.6/ 

Pages: 1581-1598 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4220r: Review of Generic Types" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m47562/1.4/ 

Pages: 1599-1613 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4230r: Review of Generic Methods" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m47563/1.3/ 

Pages: 1614-1622 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4240r: Review of Bounded Type Parameters" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m47819/1.3/ 

Pages: 1623-1637 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


ATTRIBUTIONS 


Module: "Java4250r: Review of Generics, Inheritance, and Subtypes" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m47822/1.4/ 

Pages: 1638-1652 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4260r: Review of Type Inference" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m47828/1.4/ 

Pages: 1653-1666 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4270r: Review of Wildcards" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m47836/1.2/ 

Pages: 1667-1684 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jy0035: Java OOP: Preface to Event Handling" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m47842/1.8/ 

Pages: 1685-1686 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: Modifying the World and SimpleTurtle Classes" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44330/1.2/ 

Pages: 1686-1700 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: Modifications to the Turtle and SimpleTurtle Classes" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44348 /1.2/ 

Pages: 1700-1712 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: Incorporating GUI Components into a World Object" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44350/1.2/ 

Pages: 1712-1731 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: Background Color, Text Color, Mouse Clicks, etc." 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44351/1.2/ 

Pages: 1731-1753 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3323 


3324 ATTRIBUTIONS 


Module: "Java OOP: Panels, Labels, Text Fields, and Buttons" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44352/1.3/ 

Pages: 1754-1775 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java OOP: Using Alpha Transparency with Ericson’s Media Library" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44911/1.2/ 

Pages: 1775-1795 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java OOP: Controlling Opacity with a Slider" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44912/1.5/ 

Pages: 1795-1818 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java OOP: Controlling an Edge Detector with a Slider" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44913/1.4/ 

Pages: 1818-1834 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java OOP: Controlling an Image-Scaling Program with a Slider" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44914/1.4/ 

Pages: 1834-1848 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java OOP: Controlling Image Rotation with a Slider and Affine Transforms" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44915/1.4/ 

Pages: 1848-1872 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java OOP: Opening an Image File in a PictureExplorer Object" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44916/1.3/ 

Pages: 1872-1883 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java OOP: Extracting pixel color data from a PictureExplorer object" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44917/1.3/ 

Pages: 1883-1902 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


Module: "Java OOP: Handling document events on a text field and creating a color swatch" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44921 /1.3/ 

Pages: 1902-1916 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: Using a JColorChooser object" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44923/1.3/ 

Pages: 1916-1930 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: A Pixel Color Editor" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44926/1.3/ 

Pages: 1930-1953 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: ITSE 2317 Practice Test 1" 

Used here as: "Java OOP: ITSE 2317 Practice Programs 1" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44264/1.3/ 

Pages: 1955-1996 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: ITSE 2317 Practice Test 2" 

Used here as: "Java OOP: ITSE 2317 Practice Programs 2" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44265 /1.4/ 

Pages: 1997-2037 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java OOP: ITSE 2317 Practice Test 3" 

Used here as: "Java OOP: ITSE 2317 Practice Programs 3" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m44262/1.3/ 

Pages: 2038-2060 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jy0037: Review Event Handling" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m47927 /1.4/ 

Pages: 2061-2103 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3325 


3326 


Module: "Java4305: Preface to JSP" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48057 /1.5/ 

Pages: 2103-2104 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4307: Servlets and JSP" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48284/1.4/ 

Pages: 2104-2129 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4308: Deploying JSP and Servlets" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48488 /1.2/ 

Pages: 2129-2142 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4310: Getting Started with JSP" 

By: R.L. Martinez, PhD 

URL: http://cnx.org/content /m48055 /1.4/ 

Pages: 2142-2145 

Copyright: R.L. Martinez, PhD 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4320: Web Programming Model" 

By: R.L. Martinez, PhD 

URL: http://cnx.org/content /m48058/1.6/ 

Pages: 2145-2176 

Copyright: R.L. Martinez, PhD 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4330: HTML and CSS Fundamentals" 
By: R.L. Martinez, PhD 

URL: http://cnx.org/content /m48070/1.7/ 

Pages: 2176-2231 

Copyright: R.L. Martinez, PhD 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4340: JSP Fundamentals" 

By: R.L. Martinez, PhD 

URL: http://cnx.org/content /m48075 /1.11/ 

Pages: 2231-2252 

Copyright: R.L. Martinez, PhD 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4340r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48187/1.6/ 

Pages: 2253-2286 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


ATTRIBUTIONS 


Module: "Java4350: Form Processing with JSP" 

By: R.L. Martinez, PhD 

URL: http://cnx.org/content /m48085 /1.5/ 

Pages: 2286-2323 

Copyright: R.L. Martinez, PhD 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4350r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48188/1.5/ 

Pages: 2324-2370 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4360: Working with Java Classes" 

By: R.L. Martinez, PhD 

URL: http://cnx.org/content /m48087 /1.5/ 

Pages: 2370-2409 

Copyright: R.L. Martinez, PhD 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4360r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48204/1.3/ 

Pages: 2410-2455 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4370: Cookies with JSP" 

By: R.L. Martinez, PhD 

URL: http://cnx.org/content /m48091 /1.7/ 

Pages: 2455-2518 

Copyright: R.L. Martinez, PhD 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4370r: Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48218/1.3/ 

Pages: 2519-2588 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4380: Sessions with JSP" 

By: R.L. Martinez, PhD 

URL: http://cnx.org/content /m48089/1.7/ 

Pages: 2588-2642 

Copyright: R.L. Martinez, PhD 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4390: Assessment Questions" 

By: R.G. (Dick) Baldwin, R.L. Martinez, PhD 

URL: http://cnx.org/content /m48129/1.3/ 

Pages: 2642-2645 

Copyright: R.G. (Dick) Baldwin, R.L. Martinez, PhD 
License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3327 


3328 


Module: "Java4510: Preface to INEW 2338" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48259/1.7/ 

Pages: 2647-2648 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4610-Preface" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49532/1.3/ 

Page: 2649 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4620: General Information" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49533/1.2/ 

Pages: 2649-2659 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4620r-Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49577/1.3/ 

Pages: 2660-2668 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4630: The InetAddress Class" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49534/1.2/ 

Pages: 2668-2680 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4630r-Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49562/1.3/ 

Pages: 2681-2684 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4640: The URL Class and the URLEncoder Class" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49535 /1.2/ 

Pages: 2684-2697 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4640r-Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49558/1.3/ 

Pages: 2698-2701 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


ATTRIBUTIONS 


Module: "Java4650: The URLConnection Class" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49537 /1.2/ 

Pages: 2701-2707 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4650r-Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49573/1.3/ 

Pages: 2708-2711 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4655: A Rendering Web Browser" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49542 /1.2/ 

Pages: 2711-2740 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4660: Sockets" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49539/1.4/ 

Pages: 2740-2758 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4660r-Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49571 /1.3/ 

Pages: 2759-2762 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4585: Getting Started with Search Engines" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m55646 /1.2/ 

Pages: 2762-2764 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4590r-Review for search engines" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m55520/1.1/ 

Pages: 2765-2771 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4530: Getting Started with Servlets" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48509/1.5/ 

Pages: 2771-2792 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3329 


3330 


Module: "Java4530r-Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49581/1.2/ 

Pages: 2793-2795 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4535: Introduction to Servlet Code" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48518/1.3/ 

Pages: 2795-2807 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4535r-Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49594/1.2/ 

Pages: 2808-2814 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4550: Session Tracking using Hidden Fields" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48550/1.3/ 

Pages: 2814-2837 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4550r-Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49590/1.2/ 

Pages: 2838-2841 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4560: Session Tracking using URL Rewriting" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48551/1.4/ 

Pages: 2841-2871 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4570: Session Tracking using Cookies" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48571/1.2/ 

Pages: 2871-2892 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java4570r-Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49593/1.2/ 

Pages: 2893-2898 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


ATTRIBUTIONS 


Module: "Java4580: Session Tracking using the Session Tracking API" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m48579/1.4/ 

Pages: 2898-2940 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4580r-Review" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m49586/1.2/ 

Pages: 2941-2944 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Java4710: INEW 2338 - Java EE 7 and Frameworks" 
By: R.G. (Dick) Baldwin, R.L. Martinez, PhD 

URL: http://cnx.org/content /m49764/1.6/ 

Pages: 2944-2945 

Copyright: R.G. (Dick) Baldwin, R.L. Martinez, PhD 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jy0040: GAME2302: Mathematical Applications for Game Development" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45680/1.2/ 

Pages: 2947-2948 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /3.0/ 


Module: "Ap0005: Preface to OOP Self-Assessment" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45252/1.7/ 

Pages: 2949-2950 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Ap0010: Self-assessment, Primitive Types" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45284/1.7/ 

Pages: 2950-2972 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Ap0020: Self-assessment, Assignment and Arithmetic Operators" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45286/1.6/ 

Pages: 2972-3000 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


3331 


Module: "Ap0030: Self-assessment, Relational Operators, Increment Operator, and Control Structures" 


By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45287 /1.4/ 

Pages: 3000-3025 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3332 ATTRIBUTIONS 


Module: "Ap0040: Self-assessment, Logical Operations, Numeric Casting, String Concatenation, and the 
toString Method" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45260/1.6/ 

Pages: 3026-3046 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Ap0050: Self-assessment, Escape Character Sequences and Arrays" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45280/1.8/ 

Pages: 3046-3074 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Ap0060: Self-assessment, More on Arrays" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45264/1.5/ 

Pages: 3074-3099 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Ap0070: Self-assessment, Method Overloading" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45276/1.5/ 

Pages: 3099-3116 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Ap0080: Self-assessment, Classes, Constructors, and Accessor Methods" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45279/1.5/ 

Pages: 3116-3135 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Ap0090: Self-assessment, the super keyword, final keyword, and static methods" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45270/1.5/ 

Pages: 3136-3154 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Ap0100: Self-assessment, The this keyword, static final variables, and initialization of instance 
variables" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45296/1.4/ 

Pages: 3154-3177 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 3333 


Module: "Ap0110: Self-assessment, Extending classes, overriding methods, and polymorphic behavior" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45308/1.5/ 

Pages: 3177-3198 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Ap0120: Self-assessment, Interfaces and polymorphic behavior" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45303/1.4/ 

Pages: 3198-3231 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Ap0130: Self-assessment, Comparing objects, packages, import directives, and some common 
exceptions" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45310/1.6/ 

Pages: 3232-3252 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses /by /4.0/ 


Module: "Ap0140: Self-assessment, Type conversion, casting, common exceptions, public class files, javadoc 
comments and directives, and null references" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45302/1.5/ 

Pages: 3252-3273 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /4.0/ 


Module: "Jy0060: Anatomy of a Game Engine" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45747 /1.1/ 

Pages: 3275-3276 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /3.0/ 


Module: "Jy0070-Principles of Object-Oriented Programming" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45793/1.1/ 

Pages: 3277-3278 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /3.0/ 


Module: "Jy0050: Programming Oldies But Goodies" 
By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45681 /1.1/ 

Pages: 3279-3280 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org /licenses/by /3.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


3334 


Module: "Gf0100: Objects First with Greenfoot" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45790/1.2/ 

Pages: 3281-3286 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /4.0/ 


Module: "Java OOP: Java Documentation" 

By: R.G. (Dick) Baldwin 

URL: http://cnx.org/content /m45117/1.1/ 

Pages: 3287-3293 

Copyright: R.G. (Dick) Baldwin 

License: http://creativecommons.org/licenses/by /3.0/ 


Available for free at Connexions <http://cnx.org/content/col11441/1.181> 


ATTRIBUTIONS 


Object-Oriented Programming (OOP) with Java 
Teaching material for various Object-Oriented Programming (OOP) courses at Austin Community College 


in Austin, TX. 


About OpenStax-CNX 
Rhaptos is a web-based collaborative publishing system for educational material. 


